YouTube Analytics

Use the @bijection/connectors/youtube-analytics entrypoint to declare YouTube Analytics resources.

Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. Source build and package availability.

Resources and modes

Resource	Mode	Description
Channel daily totals	`daily`	Daily channel metrics in 30-day requests
Bulk channel report files (YouTube Reporting API)	`bulk`	Daily CSV report files of one reporting job, the newest backfill of each day

Declare a resource in application code, then bind deployment-specific settings and credentials. See typed resources, connections and source inspection.

Channel daily totals

daily: Daily channel metrics in 30-day requests

The following example matches configuration standard.

import { youtubeAnalytics } from "@bijection/connectors/youtube-analytics";
export const channelDays = youtubeAnalytics.channel.daily({
  start: "2026-01-01",
  metrics: ["views", "estimatedMinutesWatched", "subscribersGained"],
});

Inferred record types

Resource without an operational record table

Configuration: standard

Case: youtube-analytics/channel/daily/standard. Connection and resource configuration are declared by this exact case. Credential kind: youtube-analytics. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`channelId`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "youtube-analytics",
    "output": {
      "kind": "single",
      "collection": "channel"
    },
    "credential_kind": "youtube-analytics",
    "connection_fields": [],
    "address": {
      "kind": "fixed",
      "url": "https://youtubeanalytics.googleapis.com"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "channelId": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: channel

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Deletion detection unsupported
Resume	No continuation
Gap	Not applicable
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "report": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "400": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "403": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange report",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "unsupported",
  "resume": "none",
  "retentionMs": null,
  "gap": "not_applicable",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "channel": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "report": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "400": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "403": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange report",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "unsupported",
        "resume": "none",
        "retentionMs": null,
        "gap": "not_applicable",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {}
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {}
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“channel”}	Fixture: ./src/connectors/youtube-analytics/fixtures/chunk-continues.json	passed (2026-10-24T21:36:12.549Z)
page-publication-recovery	{“kind”:“collection”,“name”:“channel”}	Fixture: ./src/connectors/youtube-analytics/fixtures/columns-mismatch-refused.json	passed (2026-10-24T21:36:12.550Z)
page-publication-recovery	{“kind”:“collection”,“name”:“channel”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/youtube-analytics/fixtures/identity.json	passed (2026-10-24T21:36:12.550Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Bulk channel report files (YouTube Reporting API)

bulk: Daily CSV report files of one reporting job, the newest backfill of each day

The following example matches configuration basic.

import { youtubeAnalytics } from "@bijection/connectors/youtube-analytics";
export const channelRows = youtubeAnalytics.reports.bulk({
  start: "2026-09-01",
  reportType: "channel_basic_a3",
  metrics: ["views", "watch_time_minutes", "likes", "subscribers_gained"],
});

Inferred record types

Resource without an operational record table

Configuration: basic

Case: youtube-analytics/reports/bulk/basic. Connection and resource configuration are declared by this exact case. Credential kind: youtube-analytics. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`jobId`	string	Yes	Shared connection

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "youtube-reporting",
    "output": {
      "kind": "single",
      "collection": "reports"
    },
    "credential_kind": "youtube-analytics",
    "connection_fields": [
      "jobId"
    ],
    "address": {
      "kind": "fixed",
      "url": "https://youtubereporting.googleapis.com/v1"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "jobId": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: reports

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Deletion detection unsupported
Resume	No continuation
Gap	Not applicable
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "job": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "404": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "500": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "503": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "report": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "document",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "403": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "404": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "reportsInWindow": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "404": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "500": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "503": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "reportsSince": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "404": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "500": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "503": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange job",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange report",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.3",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange reportsInWindow",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.4",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange reportsSince",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2",
          "acquire.3",
          "acquire.4"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "unsupported",
  "resume": "none",
  "retentionMs": null,
  "gap": "not_applicable",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "reports": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "job": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "404": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "500": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "503": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "report": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "document",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "403": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "404": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "reportsInWindow": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "404": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "500": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "503": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "reportsSince": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "404": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "500": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "503": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange job",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange report",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.3",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange reportsInWindow",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.4",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange reportsSince",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2",
                "acquire.3",
                "acquire.4"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "unsupported",
        "resume": "none",
        "retentionMs": null,
        "gap": "not_applicable",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {}
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {}
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-job-kicked-off.json	passed (2026-10-24T21:36:12.552Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-job-type-refused.json	passed (2026-10-24T21:36:12.554Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-window-catches-up.json	passed (2026-10-24T21:36:12.556Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-window-reaches-present.json	passed (2026-10-24T21:36:12.557Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-since-carries-newest.json	passed (2026-10-24T21:36:12.561Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-next-page-refused.json	passed (2026-10-24T21:36:12.563Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-file-page.json	passed (2026-10-24T21:36:12.565Z)
page-publication-recovery	{“kind”:“collection”,“name”:“reports”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/youtube-analytics/fixtures/reporting-identity.json	passed (2026-10-24T21:36:12.566Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Provider guidance

Compiled declaration examples and configuration details are published in the connector reference. Daily channel totals from YouTube Analytics API v2 GET /v2/reports?ids=channel==<id>&dimensions=day over 30-day requests, read as restated report observations. YouTube answers positional rows; the reader checks columnHeaders against the request before reading a value. Only integer metrics are offered and each is exact; fractional metrics (view percentage, revenue) are not published. YouTube states no restatement bound for this API, so restatementDays defaults to seven days, a recipe choice, and settled is that window’s basis. reports.bulk reads the YouTube Reporting API’s daily CSV files for one reporting job, which the owner creates once per report type (jobs.create; YouTube then generates a file per Pacific day and 30 days of history) and binds as jobId. Each pass reads the job (GET /v1/jobs/{jobId}, which must be of the declared reportType: channel_basic_a3, channel_combined_a3, channel_playback_location_a3, channel_traffic_source_a3 or channel_device_os_a3) and lists its reports. The history from start is caught up in windows of 31 days by startTime; after that each pass lists the reports createdAfter the newest one already listed, so a backfill YouTube issues for any day (the same startTime and endTime, a newer createTime) is read when it appears. Of the reports one listing names for a day only the newest is read. Each file is read whole, 128 rows a read, keyed by (channel, day, the report’s other dimensions); the YYYYMMDD day is published as YYYY-MM-DD and every metric (counts and minutes; averages and rates are not offered) is exact decimal text. A backfill replaces the rows it carries; a row it no longer carries keeps its last values. YouTube states no restatement bound, so settled is true for a day at least restatementDays (default 30, a recipe choice) old when read. Limits: a listing stating a next page, or naming more than 32 days (a mass backfill), fails the pass rather than read part of it; a file beyond 1,024 rows or the host’s response bound fails the pass, and a file is downloaded once per 128 rows. Reports are retained 60 days after generation (30 for historical ones), so a start older than that reads nothing for those days. An Analytics answer names no channel, so the connection is its own identity namespace. The connection holds a youtube-analytics OAuth credential (youtubeAnalytics.credential, scope yt-analytics.readonly); setup names channelId (MINE for the credential’s own channel). The youtube-reporting connection holds the same credential kind with setup jobId; its identity is the job. Nothing here has run against YouTube or been qualified.

Provider references

Provider references and prerequisites are maintained in the connector guidance above. No separate provider-documentation review date is recorded.

Source and evidence

Canonical connector source, native analysis and check receipts. Connector artifact: 905888ea276a2a28e36981a79e8142b2547ea451c3e63162cb6915ad4a7d1305. The resource declaration examples above are compiled and compared with exact catalog declarations. Recorded checks apply only to their source, declaration and runtime identities. Configure a connection and inspect its status to establish deployment-specific readiness.

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Availability

Resources and modes

Channel daily totals

daily: Daily channel metrics in 30-day requests

Configuration: standard

Bulk channel report files (YouTube Reporting API)

bulk: Daily CSV report files of one reporting job, the newest backfill of each day

Configuration: basic

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Channel daily totals

​daily: Daily channel metrics in 30-day requests

​Configuration: standard

​Bulk channel report files (YouTube Reporting API)

​bulk: Daily CSV report files of one reporting job, the newest backfill of each day

​Configuration: basic

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Channel daily totals

daily: Daily channel metrics in 30-day requests

Configuration: standard

Bulk channel report files (YouTube Reporting API)

bulk: Daily CSV report files of one reporting job, the newest backfill of each day

Configuration: basic

Provider guidance

Provider references

Source and evidence