YouTube Reporting API

Mit der YouTube Reporting API können Entwickler Berichtsjobs planen und dann generierte Bulk-Berichte herunterladen. Die API unterstützt vordefinierte Berichte, die jeweils umfassende YouTube Analytics-Daten für einen Kanal oder Rechteinhaber enthalten.

In den folgenden Schritten wird erläutert, wie Sie Berichtsjobs planen und Berichte abrufen:

  1. Mit der Methode reportTypes.list() kannst du eine Liste der Berichte abrufen, die ein Kanal- oder Rechteinhaber abrufen kann.
  2. Rufe die Methode jobs.create() auf, um einen Bericht zu identifizieren, der für einen Kanal oder Rechteinhaber erstellt werden sollte. Anschließend können Sie jobs.list() und jobs.delete() der API verwenden, um die Liste der generierten Berichte abzurufen oder zu ändern.
  3. Rufen Sie die Methode jobs.reports.list() auf, um eine Liste von Berichten abzurufen, die für einen bestimmten Job generiert wurden. Jede Ressource in der Antwort enthält eine downloadUrl-Eigenschaft, die die URL angibt, von der der Bericht heruntergeladen werden kann.
  4. Senden Sie eine autorisierte GET-Anfrage, um den Bericht von der Download-URL abzurufen.

Autorisierung

Alle Anfragen an die YouTube Reporting API müssen autorisiert werden. Im Autorisierungsleitfaden wird erläutert, wie Sie Autorisierungstokens mit dem OAuth 2.0-Protokoll abrufen.

YouTube Reporting API-Anfragen verwenden die folgenden Autorisierungsbereiche:

Sucher
https://www.googleapis.com/auth/yt-analytics.readonly Sieh dir YouTube Analytics-Berichte für deine YouTube-Inhalte an. Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität, wie Anzahl der Aufrufe und Anzahl der Bewertungen.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Sieh dir die YouTube Analytics-Finanzberichte für deine YouTube-Inhalte an. Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität sowie auf geschätzte Umsatz- und Anzeigenleistungsmesswerte.

Ressourcentypen

In den folgenden Abschnitten finden Sie allgemeine Beschreibungen der Ressourcen und Methoden der API. Alle in den Tabellen angezeigten Methoden-URIs beziehen sich auf https://youtubereporting.googleapis.com.

Karriere und Beruf

Methoden
create POST /v1/jobs
Erstellt einen Berichtsjob. Durch das Erstellen eines Berichtsauftrags weisen Sie YouTube an, diesen Bericht täglich zu erstellen. Der Bericht ist innerhalb von 24 Stunden nach Erstellung des Jobs verfügbar.
delete DELETE /v1/jobs/{jobId}
Löscht einen Berichtsjob.
get GET /v1/jobs/{jobId}
Ruft Informationen zu einem bestimmten Berichtsjob ab, der für einen Kanal oder Rechteinhaber geplant wurde.
list GET /v1/jobs
Listet Berichtsjobs auf, die für einen Kanal oder Rechteinhaber geplant wurden. Jede Ressource in der Antwort enthält die Eigenschaft id, die die ID angibt, mit der YouTube den Job eindeutig identifiziert. Sie benötigen diese ID, um die Liste der für den Job generierten Berichte abzurufen oder den Job zu löschen.

jobs.reports.

Methoden
get GET /v1/jobs/{jobId}/reports/{reportId}
Ruft die Metadaten für einen bestimmten Bericht ab.
list GET /v1/jobs/{jobId}/reports
Listet Berichte auf, die für den angegebenen Berichtsjob generiert wurden.

reportTypes

Methoden
list GET /v1/reportTypes
Gibt eine Liste mit Berichtstypen zurück, die der Kanal- oder Rechteinhaber abrufen kann.