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