GroupItems
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Metodi
L'API supporta i seguenti metodi per le risorse groupItems:
- list
- Restituisce una raccolta di elementi di gruppo che corrispondono ai parametri della richiesta API.
Prova subito.
- insert
- Crea un elemento di gruppo.
Prova subito.
- elimina
- Rimuove un elemento da un gruppo.
Prova subito.
Rappresentazione delle risorse
La struttura JSON seguente mostra il formato di una risorsa groupItems:
{
"kind": "youtube#groupItem",
"etag": etag,
"id": string,
"groupId": string,
"resource": {
"kind": string,
"id": string
}
}
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
| Proprietà |
kind |
string
Identifica il tipo di risorsa API. Il valore sarà youtube#groupItem. |
etag |
etag
L'ETag di questa risorsa. |
id |
string
L'ID utilizzato da YouTube per identificare in modo univoco la risorsa channel, video, playlist o asset inclusa nel gruppo. Tieni presente che questo ID si riferisce specificamente all'inclusione della risorsa in un determinato gruppo ed è diverso dall'ID canale, dall'ID video, dall'ID playlist o dall'ID risorsa che identifica in modo univoco la risorsa stessa. Il valore della proprietà resource.id specifica l'ID univoco del canale, del video, della playlist o della risorsa. |
groupId |
string
L'ID utilizzato da YouTube per identificare in modo univoco il gruppo che contiene l'articolo. |
resource |
object
L'oggetto resource contiene informazioni che identificano l'elemento aggiunto al gruppo. |
resource.kind |
string
Identifica il tipo di risorsa da aggiungere al gruppo.
I valori validi per questa proprietà sono:
youtube#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
resource.id |
string
L'ID canale, video, playlist o risorsa utilizzato da YouTube per identificare in modo univoco l'elemento che viene aggiunto al gruppo. |
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\u003eThe YouTube Analytics API provides methods to manage group items, enabling you to list, insert, and delete them within groups.\u003c/p\u003e\n"],["\u003cp\u003eGroup items associate a YouTube resource like a channel, video, or playlist with a specific group for analysis.\u003c/p\u003e\n"],["\u003cp\u003eEach group item is uniquely identified by an ID and contains information about the resource it links to and the group it belongs to.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses a JSON structure to represent group items, including properties like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003egroupId\u003c/code\u003e, and \u003ccode\u003eresource\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eresource\u003c/code\u003e property within a group item further specifies the type and unique ID of the linked YouTube resource (channel, video, playlist, or asset).\u003c/p\u003e\n"]]],["The API for `groupItems` resources supports listing, inserting, and deleting items. `groupItems` contain properties like `kind`, `etag`, `id`, and `groupId`. The `resource` object within a `groupItem` identifies the item, specifying its `kind` (channel, playlist, video, or asset) and its unique `id`. The `id` in groupItem identifies a specific resource within a group and is different than the resources' ID, while the `groupId` is the identifier for the group containing the item.\n"],null,["# GroupItems\n\n\u003cbr /\u003e\n\nMethods\n-------\n\nThe API supports the following methods for `groupItems` resources:\n\n[list](/youtube/analytics/reference/groupItems/list)\n: Returns a collection of group items that match the API request parameters.\n [Try it now](/youtube/analytics/reference/groupItems/list#try-it).\n\n[insert](/youtube/analytics/reference/groupItems/insert)\n: Creates a group item.\n [Try it now](/youtube/analytics/reference/groupItems/insert#try-it).\n\n[delete](/youtube/analytics/reference/groupItems/delete)\n: Removes an item from a group.\n [Try it now](/youtube/analytics/reference/groupItems/delete#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `groupItems` resource: \n\n```text\n{\n \"kind\": \"youtube#groupItem\",\n \"etag\": etag,\n \"id\": string,\n \"groupId\": string,\n \"resource\": {\n \"kind\": string,\n \"id\": 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#groupItem`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the `channel`, `video`, `playlist`, or `asset` resource that is included in the group. Note that this ID refers specifically to the inclusion of that resource in a particular group and is different than the channel ID, video ID, playlist ID, or asset ID that uniquely identifies the resource itself. The [resource.id](#resource.id) property's value specifies the unique channel, video, playlist, or asset ID. |\n| `groupId` | `string` The ID that YouTube uses to uniquely identify the group that contains the item. |\n| `resource` | `object` The `resource` object contains information that identifies the item being added to the group. |\n| resource.`kind` | `string` Identifies the type of resource being added to the group. Valid values for this property are: - `youtube#channel` - `youtube#playlist` - `youtube#video` - `youtubePartner#asset` |\n| resource.`id` | `string` The channel, video, playlist, or asset ID that YouTube uses to uniquely identify the item that is being added to the group. |"]]
