YouTube Reporting API

Interfejs API YouTube do raportowania umożliwia deweloperom planowanie zadań raportowania i pobieranie wygenerowanych raportów zbiorczych. Interfejs API obsługuje wstępnie zdefiniowany zestaw raportów, z których każdy zawiera obszerny zestaw danych YouTube Analytics dotyczących kanału lub właściciela treści.

Aby zaplanować zadania raportowania i pobrać raporty, wykonaj te czynności:

  1. Wywołaj metodę reportTypes.list(), aby pobrać listę raportów, które może pobierać kanał lub właściciel treści.
  2. Wywołaj metodę jobs.create(), aby wskazać raport, który powinien zostać wygenerowany dla właściciela kanału lub treści. Następnie możesz użyć jobs.list() i jobs.delete() interfejsu API, aby pobrać lub zmienić listę generowanych raportów.
  3. Wywołaj metodę jobs.reports.list(), aby pobrać listę raportów wygenerowanych dla określonego zadania. Każdy zasób w odpowiedzi zawiera właściwość downloadUrl, która określa adres URL, z którego można pobrać raport.
  4. Wyślij autoryzowane żądanie GET, aby pobrać raport z adresu URL pobierania.

Upoważnienie

Wszystkie żądania do interfejsu YouTube Reporting API muszą być autoryzowane. Przewodnik po autoryzacji zawiera instrukcje pobierania tokenów autoryzacji za pomocą protokołu OAuth 2.0.

Żądania do interfejsu YouTube Reporting API używają tych zakresów autoryzacji:

Zakresy
https://www.googleapis.com/auth/yt-analytics.readonly Wyświetlaj raporty Statystyk YouTube dotyczące treści w YouTube. Zakres ten zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i oceny.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Wyświetlanie raportów finansowych Statystyk YouTube dotyczących treści w YouTube Zakres ten umożliwia dostęp do danych o aktywności użytkowników oraz szacunkowych danych o przychodach i skuteczności reklam.

Typy zasobów

W poniższych sekcjach znajdziesz ogólne opisy zasobów i metod interfejsu API. Wszystkie identyfikatory URI metod widoczne w tabelach odnoszą się do elementu https://youtubereporting.googleapis.com.

praca

Metody
create POST /v1/jobs
Utworzy zadanie raportowania. Tworząc zadanie raportowania, pobierasz raport do YouTube codziennie. Raport jest dostępny w ciągu 24 godzin od utworzenia zadania.
delete DELETE /v1/jobs/{jobId}
Usuwa zadanie raportowania.
get GET /v1/jobs/{jobId}
Pobiera informacje o określonym zadaniu raportowania, które jest zaplanowane dla kanału lub właściciela treści.
list GET /v1/jobs
Wyświetla zadania raportowania, które zostały zaplanowane dla właściciela kanału lub treści. Każdy zasób w odpowiedzi zawiera właściwość id, która określa identyfikator używany przez YouTube do jednoznacznego identyfikowania zadania. Identyfikator ten jest potrzebny do pobrania listy raportów wygenerowanych dla danego zadania lub do usunięcia zadania.

jobs.reports

Metody
get GET /v1/jobs/{jobId}/reports/{reportId}
Pobiera metadane określonego raportu.
list GET /v1/jobs/{jobId}/reports
Wyświetla raporty, które zostały wygenerowane dla określonego zadania raportowania.

reportTypes (typy raportów)

Metody
list GET /v1/reportTypes
Zwraca listę typów raportów, które kanał lub właściciel treści może pobrać.