Groups

Une ressource group représente un groupe YouTube Analytics, qui est une collection personnalisée rassemblant un maximum de 500 chaînes, vidéos, playlists ou assets.

Tous les éléments d'un groupe doivent représenter le même type de ressource. Par exemple, vous ne pouvez pas créer un groupe contenant 100 vidéos et 100 playlists.

Un groupe Analytics ne peut contenir que des ressources que vous avez mises en ligne ou revendiquées, ou qui sont associées à une chaîne que vous gérez. Par conséquent, les propriétaires de chaîne peuvent créer des groupes de vidéos et de playlists. Les propriétaires de contenu peuvent créer des groupes de vidéos, de playlists, de chaînes ou d'assets.

Méthodes

L'API accepte les méthodes suivantes pour les ressources groups:

list
Renvoie une liste des groupes correspondant aux paramètres de requête de l'API. Par exemple, vous pouvez récupérer tous les groupes dont l'utilisateur authentifié est propriétaire, ou un ou plusieurs groupes par leur ID unique. Essayer
insérer
Crée un groupe YouTube Analytics. Après avoir créé un groupe, ajoutez-y des éléments à l'aide de la méthode groupItems.insert. Essayer maintenant
mettre à jour
Modifie les métadonnées d'un groupe. Actuellement, la seule propriété pouvant être mise à jour est le titre du groupe. (Utilisez les options groupItems.insert et groupItems.delete pour ajouter ou supprimer des éléments de groupe.) Essayer maintenant
supprimer
Supprime un groupe. Essayer

Représentation des ressources

La structure JSON ci-dessous présente le format d'une ressource groups:

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

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind string
Identifie le type de ressource de l'API. La valeur sera youtube#group.
etag etag
ETag de cette ressource.
id string
Identifiant que YouTube utilise pour identifier le groupe de façon unique.
snippet object
L'objet snippet contient des informations de base sur le groupe, y compris sa date de création et son nom.
snippet.publishedAt datetime
Date et heure de création du groupe. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
Nom du groupe. La valeur doit être une chaîne non vide.
contentDetails object
L'objet contentDetails contient des informations supplémentaires sur le groupe, telles que le nombre et le type d'éléments qu'il contient.
contentDetails.itemCount unsigned long
Nombre d'éléments dans le groupe.
contentDetails.itemType string
Type de ressources contenues dans le groupe.

Les valeurs valides pour cette propriété sont les suivantes :
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset