Skip to content
Nappai Documentation

Youtube Channel

Manage your YouTube channel settings and retrieve basic channel information through an automated workflow. This component allows you to view your channel profile details or update specific settings such as the channel description, keywords, and country code.

How it Works

This component connects directly to the YouTube API using your Google account credentials. It acts as a bridge between your Nappai automation workflow and your YouTube Channel. When you configure this component, it sends requests to YouTube servers to either fetch current channel data or update channel metadata based on the inputs you provide. The system handles the complex API communication behind the scenes, ensuring your data is retrieved or updated securely.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

  1. Go to the Credentials section in your Nappai panel.
  2. Create a new credential of the type Youtube API and fill in the required fields (Select Project, Client Id, Client Secret, and Youtube access). You can find instructions for generating these keys in the Google Cloud Console.
  3. In your workflow, select the saved credential in the Credential input field of this node.

Inputs

The following fields are available to configure this component. Each field may be visible in different operations:

  • Operation: Select the main action you want to perform (e.g., retrieving info or updating settings).
  • Info consult: Select the specific channel information you want to view. This acts as a filter for the data you wish to retrieve.
  • Banner to Upload: Provide the binary image data for your channel banner. This input accepts an image file in base64 format. If you need help with the specific image format requirements, please refer to the official YouTube API documentation for channel banners.
  • Select Update: Choose which specific setting you wish to modify.
  • Country Code: Select the country associated with your channel from the dropdown list.
  • Description: Enter the text description for your YouTube channel.
  • Default Language: Select the default language for your channel content.
  • Keywords: Enter keywords that describe your channel content. These help YouTube categorize your content.
  • Is Made For Kids: Toggle this setting to indicate whether your channel content is made for children. This is an important compliance setting for YouTube.

Outputs

When this component executes successfully, it produces a Result output. This output contains the data retrieved from YouTube or confirms the success of an update operation. You can connect this Result to other components in your workflow to further process or display the channel data.

Output Data Example (JSON)json

{ “channel_id”: “UCxxxxxxxxxxxxx”, “channel_name”: “My Awesome Channel”, “subscriber_count”: 1500, “view_count”: 50000, “country”: “US”, “description”: “Welcome to my channel!”, “keywords”: [“tech”, “tutorials”, “vlogs”], “status”: “success” }

Connectivity

This component typically connects to other data processing or notification components. For example, if you retrieve channel statistics (Output: Result), you might connect this to a Data Formatter component to clean the data before sending it to a Database component for storage. Alternatively, if you are updating settings, you might connect it to a Notification component to alert you when the update is complete. It serves as the primary interface for YouTube data in your automation flow.

Usage Example

Scenario: Checking Your Channel Stats

  1. Drag the Youtube Channel component into your workflow.
  2. Select your Credential that links to your Google account.
  3. In the Operation field, select an option to view channel info (if applicable) or leave it to default to info retrieval.
  4. In Info consult, select the data points you need (e.g., subscribers, views).
  5. Run the workflow. The component will fetch your latest stats and output them in the Result field, which you can then use in subsequent steps.

Tips and Best Practices

  • Always ensure your Credential is active and has the necessary permissions before running the component.
  • If you are updating the Banner to Upload, ensure the image is in the correct base64 format to avoid upload errors.
  • Be careful when using the Is Made For Kids toggle, as this affects how YouTube serves your content to viewers.

Security Considerations

  • Credential Safety: Never share your Client Id or Client Secret from the Google Cloud Console. Ensure your Nappai credentials are stored securely within the platform.
  • API Limits: Be aware that YouTube APIs have rate limits. If you make too many requests in a short period, you may experience temporary delays. Space out your workflows if possible.