Groups

Una risorsa group rappresenta un gruppo di YouTube Analytics, ovvero una raccolta personalizzata di massimo 500 canali, video, playlist o asset.

Tutti gli elementi di un gruppo devono rappresentare lo stesso tipo di risorsa. Ad esempio, non puoi creare un gruppo che contenga 100 video e 100 playlist.

Un gruppo di Analytics può contenere solo le risorse che hai caricato o rivendicato oppure che sono collegate a un canale che amministri. Di conseguenza, i proprietari dei canali possono creare gruppi di video e playlist. I proprietari dei contenuti possono creare gruppi di video, playlist, canali o risorse.

Metodi

L'API supporta i seguenti metodi per le risorse di groups:

list
Restituisce un elenco di gruppi che corrispondono ai parametri della richiesta API. Ad esempio, puoi recuperare tutti i gruppi di proprietà dell'utente autenticato oppure uno o più gruppi in base agli ID univoci. Prova subito.
inserire
Crea un gruppo di YouTube Analytics. Dopo aver creato un gruppo, utilizza il metodo groupItems.insert per aggiungere elementi al gruppo. Prova subito.
Aggiorna
Modifica i metadati di un gruppo. Attualmente, l'unica proprietà che può essere aggiornata è il titolo del gruppo. Utilizza groupItems.insert e groupItems.delete per aggiungere e rimuovere elementi del gruppo. Prova subito.
elimina
Elimina un gruppo. Prova subito.

Rappresentazione delle risorse

La struttura JSON seguente mostra il formato di una risorsa groups:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

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#group.
etag etag
L'Etag di questa risorsa.
id string
L'ID utilizzato da YouTube per identificare in modo univoco il gruppo.
snippet object
L'oggetto snippet contiene informazioni di base sul gruppo, tra cui la data di creazione e il nome.
snippet.publishedAt datetime
La data e l'ora in cui è stato creato il gruppo. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
Il nome del gruppo. Il valore deve essere una stringa non vuota.
contentDetails object
L'oggetto contentDetails contiene ulteriori informazioni sul gruppo, ad esempio il numero e il tipo di elementi contenuti.
contentDetails.itemCount unsigned long
Il numero di elementi nel gruppo.
contentDetails.itemType string
Il tipo di risorse contenute nel gruppo.

I valori validi per questa proprietà sono:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset