Groups
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC)
[null,null,["Última actualización: 2025-08-21 (UTC)"],[[["\u003cp\u003eA YouTube Analytics group is a custom collection of up to 500 channels, videos, playlists, or assets, all of the same resource type.\u003c/p\u003e\n"],["\u003cp\u003eYou can create, retrieve, update, and delete groups using the YouTube Analytics API methods.\u003c/p\u003e\n"],["\u003cp\u003eGroups can only contain resources that you own, have claimed, or are linked to a channel you administer.\u003c/p\u003e\n"],["\u003cp\u003eThe group resource representation includes information such as the group's ID, title, creation date, item count, and item type.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003egroupItems\u003c/code\u003e methods to manage the individual items within a group.\u003c/p\u003e\n"]]],["YouTube Analytics groups are custom collections of up to 500 channels, videos, playlists, or assets of the same type. The API allows users to list, insert, update, and delete groups. Creating a group requires specifying the group's name. Updating a group only allows changing its title, while adding or removing items is handled through a separate method. Each group has an ID, creation date, and details about the number and type of contained items.\n"],null,["# Groups\n\nA **group** resource represents a YouTube Analytics group, which is a custom collection of up to 500 channels, videos, playlists, or assets. \n\nAll of the items in a group must represent the same type of resource. For example, you cannot create a group that contains 100 videos and 100 playlists. \n\nAn Analytics group can only contain resources that you have uploaded or claimed or that are linked to a channel that you administer. As a result, channel owners can create groups of videos and playlists. Content owners can create groups of videos, playlists, channels, or assets.\n\nMethods\n-------\n\nThe API supports the following methods for `groups` resources:\n\n[list](/youtube/analytics/reference/groups/list)\n: Returns a list of groups that match the API request parameters. For example, you can retrieve all groups that the authenticated user owns, or you can retrieve one or more groups by their unique IDs.\n [Try it now](/youtube/analytics/reference/groups/list#try-it).\n\n[insert](/youtube/analytics/reference/groups/insert)\n: Creates a YouTube Analytics group. After creating a group, use the [groupItems.insert](/youtube/analytics/reference/groupItems/insert) method to add items to the group.\n [Try it now](/youtube/analytics/reference/groups/insert#try-it).\n\n[update](/youtube/analytics/reference/groups/update)\n: Modifies the metadata for a group. Currently, the only property that can be updated is the group's title. (Use the [groupItems.insert](/youtube/analytics/reference/groupItems/insert) and [groupItems.delete](/youtube/analytics/reference/groupItems/delete) to add and remove group items.)\n [Try it now](/youtube/analytics/reference/groups/update#try-it).\n\n[delete](/youtube/analytics/reference/groups/delete)\n: Deletes a group.\n [Try it now](/youtube/analytics/reference/groups/delete#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `groups` resource: \n\n```text\n{\n \"kind\": \"youtube#group\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"publishedAt\": datetime,\n \"title\": string\n },\n \"contentDetails\": {\n \"itemCount\": unsigned long,\n \"itemType\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#group`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the group. |\n| `snippet` | `object` The `snippet` object contains basic information about the group, including its creation date and name. |\n| snippet.`publishedAt` | `datetime` The date and time that the group was created. The value is specified in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) (`YYYY-MM-DDThh:mm:ss.sZ`) format. |\n| snippet.`title` | `string` The group name. The value must be a non-empty string. |\n| `contentDetails` | `object` The `contentDetails` object contains additional information about the group, such as the number and type of items that it contains. |\n| contentDetails.`itemCount` | `unsigned long` The number of items in the group. |\n| contentDetails.`itemType` | `string` The type of resources that the group contains. Valid values for this property are: - `youtube#channel` - `youtube#playlist` - `youtube#video` - `youtubePartner#asset` |"]]
