- l'ambito
https://www.googleapis.com/auth/youtube
o - l'ambito
https://www.googleapis.com/auth/youtube.readonly
e
l'ambitohttps://www.googleapis.com/auth/yt-analytics.readonly
La prima opzione utilizza un ambito, che si tratta di un ambito di lettura/scrittura, mentre la seconda ne utilizza due.
Restituisce una raccolta di elementi di gruppo che corrispondono ai parametri della richiesta API.
Risorse richieste:
Richiesta HTTP
GET https://youtubeanalytics.googleapis.com/v2/groupItems
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Mirini con ingrandimento | |
---|---|
https://www.googleapis.com/auth/yt-analytics.readonly | Visualizza i report Analytics su YouTube per i tuoi contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche relative alle attività degli utenti, come il numero di visualizzazioni e di valutazioni. |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Visualizza i report Analytics su YouTube relativi al valore monetario per i tuoi contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche relative all'attività utente e alle entrate stimate e alle metriche sul rendimento degli annunci. |
https://www.googleapis.com/auth/youtube | Gestisci il tuo account YouTube. Nell'API di YouTube Analytics, i proprietari dei canali utilizzano questo ambito per gestire i gruppi e gli elementi di YouTube Analytics. |
https://www.googleapis.com/auth/youtubepartner | Visualizzare e gestire le risorse di YouTube e i contenuti associati su YouTube. Nell'API di YouTube Analytics, i proprietari dei contenuti utilizzano questo ambito per gestire gli elementi e i gruppi di YouTube Analytics. |
Parametri
Nella tabella seguente sono elencati i parametri supportati dalla query. Tutti i parametri elencati sono parametri di ricerca.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
groupId |
string Il parametro id specifica l'ID univoco del gruppo per il quale vuoi recuperare elementi del gruppo. |
|
Parametri facoltativi | ||
onBehalfOfContentOwner |
string Questo parametro può essere utilizzato solo in una richiesta autorizzata appropriata. Nota: questo parametro è destinato esclusivamente ai partner di contenuti di YouTube che possiedono e gestiscono molti canali YouTube diversi. Il parametro onBehalfOfContentOwner indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. Permette ai proprietari dei contenuti di autenticarsi una volta sola e di accedere a tutti i dati video e del canale, senza dover fornire le credenziali di autenticazione per ogni singolo canale. L'account con cui l'utente si autentica deve essere collegato al proprietario dei contenuti di YouTube specificato. |
Corpo della richiesta
Non fornire un corpo della richiesta quando chiami questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo di risposta con la seguente struttura:
{ "kind": "youtube#groupItemListResponse", "etag": etag, "items": [ groupItem Resource ] }
Proprietà
La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#groupItemListResponse .
|
etag |
etag L'Etag di questa risorsa. |
items[] |
list Un elenco degli elementi contenuti nel gruppo. Ogni elemento nell'elenco rappresenta una risorsa groupItem . |
Errori
L'API non definisce alcun messaggio di errore univoco per questo metodo API. Tuttavia, questo metodo potrebbe comunque restituire errori generali dell'API elencati nella documentazione relativa ai messaggi di errore.
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.