GroupItems: insert

Crea un elemento di gruppo.

Richiesta

Richiesta HTTP

POST 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 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 tuoi contenuti di YouTube. Questo ambito consente di accedere alle metriche sull'attività utente, nonché alle metriche relative a entrate stimate e 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 facoltativi
onBehalfOfContentOwner string
Questo parametro può essere utilizzato solo in una richiesta autorizzata opportunamente. Nota: questo parametro è destinato esclusivamente ai partner della rete 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

Fornisci una risorsa groupItem nel corpo della richiesta. Per questa risorsa, devi specificare un valore per le seguenti proprietà.

  • groupId
  • resource.id

Risposta

Se l'elemento è stato inserito correttamente, questo metodo restituisce una risorsa groupItem nel corpo della risposta.

Se l'elemento specificato nella richiesta era già stato incluso nel gruppo prima della richiesta, questo metodo restituisce un codice di risposta HTTP 204 (No Content).

Errori

La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa al messaggio di errore.

Tipo di errore Dettagli dell'errore Descrizione
forbidden (403) groupContainsMaximumNumberOfItems Il gruppo contiene già il numero massimo di elementi consentito.

Prova

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