Skip to main content

YouTube Analytics

This page contains the setup guide and reference information for the YouTube Analytics source connector.

Prerequisites

YouTube does not start to generate a report until you create a reporting job for that report. Airbyte creates a reporting job for your report or uses current reporting job if it's already exists. The report will be available within 48 hours of creating the reporting job and will be for the day that the job was scheduled. For example, if you schedule a job on September 1, 2015, then the report for September 1, 2015, will be ready on September 3, 2015. The report for September 2, 2015, will be posted on September 4, 2015, and so forth. Youtube also generates historical data reports covering the 30-day period prior to when you created the job. Airbyte syncs all available historical data too.

Setup guide

Step 1: Set up YouTube Analytics

  • Go to the YouTube Reporting API dashboard in the project for your service user. Enable the API for your account.
  • Use your Google account and authorize over Google's OAuth 2.0 on connection setup. Please make sure to grant the following authorization scope: https://www.googleapis.com/auth/yt-analytics.readonly.

Step 2: Set up the YouTube Analytics connector in Airbyte

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  3. On the Set up the source page, enter the name for the YouTube Analytics connector and select YouTube Analytics from the Source type dropdown.
  4. Select Authenticate your account.
  5. Log in and Authorize to the Instagram account and click Set up source.

For Airbyte OSS:

  1. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  2. On the Set up the source page, enter the name for the YouTube Analytics connector and select YouTube Analytics from the Source type dropdown.
  3. Select client_id
  4. Select client_secret
  5. Select refresh_token
  6. Click Set up source.

Supported sync modes

The YouTube Analytics source connector supports the following sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncYes
SSL connectionYes
Channel ReportsYes
Content Owner ReportsComing soon
YouTube Data APIComing soon

Supported Streams

Performance considerations

  • Free requests per day: 20,000
  • Free requests per 100 seconds: 100
  • Free requests per minute: 60

Quota usage is not an issue because data is retrieved once and then filtered, sorted, and queried within the application.

Reference

Config fields reference

Field
Type
Property name
object
credentials

Changelog

Expand to review
VersionDatePull RequestSubject
0.1.62024-06-1739529Pin CDK version to 0.38.0
0.1.52024-05-2138546[autopull] base image + poetry + up_to_date
0.1.42023-05-2226420Migrate to advancedAuth
0.1.32022-09-3017454Added custom backoff logic
0.1.22022-09-2917399Fixed 403 error while check connection
0.1.12022-08-1815744Fix channel_basic_a2 schema fields data type
0.1.02021-11-017407Initial Release