Groups

Un recurso group representa un grupo de YouTube Analytics, que es una colección personalizada de hasta 500 canales, videos, listas de reproducción o activos.

Todos los elementos de un grupo deben representar el mismo tipo de recurso. Por ejemplo, no puedes crear un grupo que contenga 100 videos y 100 listas de reproducción.

Un grupo de Analytics solo puede contener recursos que subiste o reclamaste, o que están vinculados a un canal que administras. Como resultado, los propietarios de canales pueden crear grupos de videos y listas de reproducción. Los propietarios del contenido pueden crear grupos de videos, listas de reproducción, canales o activos.

Métodos

La API admite los siguientes métodos para los recursos de groups:

list
Muestra una lista de grupos que coinciden con los parámetros de solicitud a la API. Por ejemplo, puedes recuperar todos los grupos que posee el usuario autenticado o puedes recuperar uno o más grupos por sus ID únicos. Pruébala ahora.
insertar
Crea un grupo de YouTube Analytics. Después de crear un grupo, usa el método groupItems.insert para agregar elementos. Pruébelo ahora.
actualizar
Modifica los metadatos de un grupo. Actualmente, la única propiedad que se puede actualizar es el título del grupo. (Usa los elementos groupItems.insert y groupItems.delete para agregar y quitar elementos del grupo). Pruébelo ahora.
borrar
Borra un grupo. Pruébala ahora.

Representación de recursos

La estructura JSON a continuación muestra el formato de un recurso groups:

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

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind string
Identifica el tipo de recurso de API. El valor será youtube#group.
etag etag
Es la Etag de este recurso.
id string
ID que usa YouTube para identificar el grupo de forma exclusiva.
snippet object
El objeto snippet contiene información básica sobre el grupo, incluida la fecha y el nombre de su creación.
snippet.publishedAt datetime
La fecha y hora en que se creó el grupo. El valor se especifica en el formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
El nombre del grupo. El valor debe ser una string que no esté vacía.
contentDetails object
El objeto contentDetails contiene información adicional sobre el grupo, como la cantidad y el tipo de elementos que contiene.
contentDetails.itemCount unsigned long
Es la cantidad de elementos del grupo.
contentDetails.itemType string
Es el tipo de recursos que contiene el grupo.

Los valores válidos para esta propiedad son los siguientes:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset