Groups

Une ressource group représente un groupe YouTube Analytics, qui est une collection personnalisée rassemblant jusqu'à 500 chaînes, vidéos, playlists ou éléments.

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 les ressources que vous avez mises en ligne ou revendiquées, ou qui sont associées à une chaîne que vous gérez. Les propriétaires de chaînes peuvent donc 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'éléments.

Méthodes

L'API prend en charge les méthodes suivantes pour les ressources groups :

liste

Renvoie une liste de groupes correspondant aux paramètres de requête de l'API. Par exemple, vous pouvez récupérer tous les groupes appartenant à l'utilisateur authentifié, ou récupérer un ou plusieurs groupes en fonction de leur ID unique. Essayer

insérer

Crée un groupe YouTube Analytics. Après avoir créé un groupe, utilisez la méthode groupItems.insert pour y ajouter des éléments. Essayer maintenant

update

Modifie les métadonnées d'un groupe. Actuellement, la seule propriété pouvant être modifiée est le titre du groupe. (Utilisez groupItems.insert et groupItems.delete pour ajouter et supprimer des éléments de groupe.) Essayez maintenant.

supprimer

 : supprime un groupe. Essayer

Représentation de la ressource

La structure JSON ci-dessous montre 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 la ressource de l'API. La valeur sera youtube#group.
etag	etag Etag de cette ressource.
id	string ID utilisé par YouTube pour identifier de manière unique le groupe.
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 du groupe.
contentDetails.itemType	string Type de ressources contenues dans le groupe. Valeurs valides pour cette propriété : youtube#channel youtube#playlist youtube#video youtubePartner#asset