Aktualizujemy interfejsy API do raportowania i statystyk YouTube, aby pasowały do sposobu zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
Method jobs.reports.get
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Pobiera metadane konkretnego raportu.
Żądanie
Żądanie HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}
Autoryzacja
Wszystkie żądania do interfejsu API Raportowania YouTube muszą być autoryzowane. W przewodniku Autoryzacja znajdziesz informacje o pobieraniu tokenów autoryzacji za pomocą protokołu OAuth 2.0.
Żądania do interfejsu API do raportowania w YouTube używają tych zakresów autoryzacji:
Zakresy |
https://www.googleapis.com/auth/yt-analytics.readonly |
Wyświetlanie raportów Statystyk YouTube dotyczących treści w YouTube Ten zakres uprawnień zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i ocen. |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Wyświetlanie raportów finansowych Statystyk YouTube dotyczących treści w YouTube Ten zakres uprawnień zapewnia dostęp do danych o aktywności użytkowników oraz szacowanych przychodów i danych o skuteczności reklam. |
Parametry
Parametry ścieżki
Parametry |
jobId |
string Identyfikator używany przez YouTube do jednoznacznego identyfikowania zadania powiązanego z raportami, które są pobierane. |
reportId |
string Identyfikator używany przez YouTube do jednoznacznego identyfikowania pobieranego raportu. |
Parametry zapytania
Parametry |
onBehalfOfContentOwner |
string Identyfikator właściciela treści, którego dotyczy żądanie przesłane do interfejsu API. Jeśli żądanie nie zawiera wartości tego parametru, serwer interfejsu API zakłada, że żądanie dotyczy kanału użytkownika. |
Treść żądania
Treść żądania musi być pusta.
Odpowiedź
W przypadku powodzenia treść odpowiedzi będzie zawierać zasób Report.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-05-08 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-05-08 UTC."],[[["This endpoint retrieves metadata for a specific report using its `jobId` and `reportId`."],["Authorization is required for all requests, utilizing OAuth 2.0 and specific scopes like `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`."],["Path parameters `jobId` and `reportId` are required to identify the job and the report being retrieved."],["The `onBehalfOfContentOwner` query parameter allows specifying a content owner ID, otherwise, the request defaults to the user's own channel."],["A successful response returns a `Report` resource containing the report's metadata."]]],["This describes how to retrieve metadata for a specific YouTube report using the Reporting API. A `GET` request is sent to a URL containing the `jobId` and `reportId`. Authorization is required using OAuth 2.0, with scopes for viewing analytics and/or monetary reports. The request can also specify a `content owner` using `onBehalfOfContentOwner`. The request body is empty. A successful response returns a `Report` resource.\n"]]