Groups
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Una risorsa group rappresenta un gruppo di YouTube Analytics, ovvero una raccolta personalizzata di massimo 500 canali, video, playlist o risorse.
Tutti gli elementi di un gruppo devono rappresentare lo stesso tipo di risorsa. Ad esempio, non puoi creare un gruppo contenente 100 video e 100 playlist.
Un gruppo di analisi può contenere solo risorse che hai caricato o rivendicato o che sono collegate a un canale che amministri. Di conseguenza, i proprietari dei canali possono creare gruppi di video e playlist. I proprietari dei contenuti possono creare gruppi di video, playlist, canali o risorse.
Metodi
L'API supporta i seguenti metodi per le risorse groups:
- list
- Restituisce un elenco di gruppi che corrispondono ai parametri di richiesta dell'API. Ad esempio, puoi recuperare tutti i gruppi di proprietà dell'utente autenticato oppure uno o più gruppi tramite i relativi ID univoci.
Prova subito.
- insert
- Crea un gruppo di YouTube Analytics. Dopo aver creato un gruppo, utilizza il metodo
groupItems.insert per aggiungere elementi al gruppo.
Prova subito.
- aggiorna
- Modifica i metadati di un gruppo. Al momento, l'unica proprietà che può essere aggiornata è il titolo del gruppo. Utilizza
groupItems.insert e groupItems.delete per aggiungere e rimuovere gli elementi del gruppo.
Prova subito.
- elimina
- Elimina un gruppo.
Prova subito.
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
| Proprietà |
kind |
string
Identifica il tipo di risorsa API. Il valore sarà youtube#group. |
etag |
etag
L'ETag di questa risorsa. |
id |
string
L'ID utilizzato da YouTube per identificare in modo univoco il gruppo. |
snippet |
object
L'oggetto snippet contiene informazioni di base sul gruppo, inclusa la data di creazione e il nome. |
snippet.publishedAt |
datetime
La data e l'ora di creazione del gruppo. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). |
snippet.title |
string
Il nome del gruppo. Il valore deve essere una stringa non vuota. |
contentDetails |
object
L'oggetto contentDetails contiene informazioni aggiuntive sul gruppo, come il numero e il tipo di elementi che contiene. |
contentDetails.itemCount |
unsigned long
Il numero di elementi nel gruppo. |
contentDetails.itemType |
string
Il tipo di risorse contenute nel gruppo.
I valori validi per questa proprietà sono:
youtube#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-21 UTC.
[null,null,["Ultimo aggiornamento 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` |"]]
