YouTube

YouTube Connector: Integration Overview & Requirements

This document outlines the technical requirements and configuration steps for connecting your YouTube channel to the indexing service.

Overview

This integration allows for the automated indexing of video content to enhance searchability and data retrieval. To ensure a successful connection, please review the following technical constraints and authentication requirements.

Functional Requirements

To maintain data quality and ensure the connector functions as intended, the following rules apply:

  • Public Content Only: The connector only processes public videos. Private or unlisted videos will not be indexed.

  • Captions Required: Only videos with subtitles/captions (either auto-generated by YouTube or manually uploaded) can be processed. Videos without a caption track will be skipped.

  • Channel Mapping: We support multi-channel indexing; however, each individual connection must be mapped to a single, specific YouTube channel.

Authentication & Access Control

The integration utilizes OAuth 2.0 for secure authentication. Because our system uses the YouTube Data API captions.download endpoint, specific permission levels are required:

Requirement

Description

Account Type

A Google-managed account (Service Account or Workspace account) capable of OAuth authentication.

Permission Level

The authenticated account must have at least Edit permissions on the videos within the channel.

Association

The YouTube channel must be directly associated with the account used for indexing.

Note: Edit permissions are a mandatory API requirement for downloading caption tracks. Without this level of access, the indexer cannot retrieve video transcripts.

Implementation Recommendation

To streamline the setup and maintain security, we recommend one of the following two paths:

  1. Service Account (Recommended): We partner with your IT team to create a dedicated service account (e.g., [CLIENT]@capacity.com). You then grant this account the necessary permissions to your YouTube channel.

  2. Client Domain Account: Alternatively, we can use an existing account within your own domain, provided it meets the access requirements and can complete the OAuth flow.






Was this article helpful?