Modifica i metadati di un gruppo. Al momento, l'unica proprietà che può essere aggiornata è il titolo del gruppo. Utilizza groupItems.insert e groupItems.delete per aggiungere e rimuovere gli elementi del gruppo.
Richiesta
Richiesta HTTP
PUT https://youtubeanalytics.googleapis.com/v2/groups
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 e i contenuti associati di YouTube 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 |
stringQuesto 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 di gruppo nel corpo della richiesta.
Per questa risorsa, devi specificare un valore per le seguenti proprietà. Tieni presente che la richiesta aggiorna il valore del campo snippet.title.
idsnippet.title
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa gruppo nel corpo della risposta.
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 dell'API.