Groups

Un recurso group representa un grupo de YouTube Analytics, que es una colección personalizada de hasta 500 canales, videos, playlists 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 playlists.

Un grupo de Analytics solo puede contener recursos que hayas subido o reclamado, o que estén vinculados a un canal que administres. Como resultado, los propietarios de los canales pueden crear grupos de videos y playlists. Los propietarios de contenido pueden crear grupos de videos, playlists, canales o activos.

Métodos

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

list
Devuelve una lista de grupos que coinciden con los parámetros de solicitud de la API. Por ejemplo, puedes recuperar todos los grupos que posee el usuario autenticado o uno o más grupos con sus IDs ú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ébalo ahora.
actualización
Modifica los metadatos de un grupo. Actualmente, la única propiedad que se puede actualizar es el título del grupo. (Usa groupItems.insert y groupItems.delete para agregar y quitar elementos del grupo). Pruébalo ahora.
borrar
Borra un grupo. Pruébala ahora.

Representación de recursos

En la siguiente estructura JSON, se 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 la API. El valor será youtube#group.
etag etag
Es la etiqueta de Etag de este recurso.
id string
Es el ID que YouTube usa para identificar de forma única al grupo.
snippet object
El objeto snippet contiene información básica sobre el grupo, incluida su fecha de creación y nombre.
snippet.publishedAt datetime
Fecha y hora en que se creó el grupo. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
Es el nombre del grupo. El valor debe ser una cadena 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 en el 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