GroupItems: list

Importante: le richieste API a questo metodo richiedono l'accesso a:
  • l'ambito https://www.googleapis.com/auth/youtube
    o
  • l'ambito https://www.googleapis.com/auth/youtube.readonly
    e
    l'ambito https://www.googleapis.com/auth/yt-analytics.readonly

La prima opzione utilizza un ambito, che è un ambito di lettura/scrittura, mentre la seconda utilizza due ambiti di sola lettura.

Restituisce una raccolta di elementi di gruppo che corrispondono ai parametri della richiesta API.

Richiesta

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).

Ambiti
https://www.googleapis.com/auth/yt-analytics.readonly Visualizzare i report di YouTube Analytics per i tuoi contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche sull'attività utente, come i conteggi delle visualizzazioni e delle valutazioni.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Visualizzare i report di YouTube Analytics relativi al valore monetario per i contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche sull'attività utente e alle metriche stimate relative alle entrate e al rendimento degli annunci.
https://www.googleapis.com/auth/youtube Gestire il tuo account YouTube. Nell'API YouTube Analytics, i proprietari dei canali utilizzano questo ambito per gestire i gruppi e gli elementi di gruppo di YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Visualizzare e gestire le risorse di YouTube e i relativi contenuti su YouTube. Nell'API di YouTube Analytics, i proprietari di contenuti utilizzano questo ambito per gestire i gruppi e gli elementi di gruppo di YouTube Analytics.

Parametri

Nella tabella seguente sono elencati i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
groupId string
Il parametro id specifica l'ID univoco del gruppo per cui vuoi recuperare gli elementi di gruppo.
Parametri facoltativi
onBehalfOfContentOwner string
Questo parametro può essere utilizzato solo in una richiesta autorizzata. 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. Consente ai proprietari di contenuti di autenticarsi una volta sola per accedere a tutti i dati dei video e dei canali, senza dover fornire le credenziali di autenticazione per ogni singolo canale. L'account con cui l'utente esegue l'autenticazione 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 della risposta con la seguente struttura:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

Proprietà

La tabella seguente definisce le proprietà 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 di elementi contenuti nel gruppo. Ogni elemento dell'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 generici dell'API elencati nella documentazione del messaggio di errore.

Prova

Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta API.