Groups

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

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

Un gruppo di analisi può contenere solo risorse che hai caricato o rivendicato o 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 groups:

list
Restituisce un elenco di gruppi che corrispondono ai parametri di richiesta dell'API. Ad esempio, puoi recuperare tutti i gruppi di proprietà dell'utente autenticato oppure uno o più gruppi tramite i relativi ID univoci. Prova subito.
insert
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. 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. Prova subito.
elimina
Elimina un gruppo. Prova subito.

Rappresentazione delle risorse

La struttura JSON riportata di seguito 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à 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, inclusa la data di creazione e il nome.
snippet.publishedAt datetime
La data e l'ora di creazione del 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 informazioni aggiuntive sul gruppo, come il numero e il tipo di elementi che contiene.
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