Groups
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób group reprezentuje grupę w Statystykach YouTube, czyli niestandardową kolekcję zawierającą maksymalnie 500 kanałów, filmów, playlist lub zasobów.
Wszystkie elementy w grupie muszą reprezentować ten sam typ zasobu. Nie możesz np. utworzyć grupy zawierającej 100 filmów i 100 playlist.
Grupa Analytics może zawierać tylko zasoby, które zostały przez Ciebie przesłane lub zgłoszone, albo które są połączone z kanałem, którym zarządzasz. Dzięki temu właściciele kanałów mogą tworzyć grupy filmów i playlist. Właściciele treści mogą tworzyć grupy filmów, playlist, kanałów lub zasobów.
Metody
Interfejs API obsługuje te metody dotyczące zasobów groups:
- list
- Zwraca listę grup, które pasują do parametrów żądania do interfejsu API. Możesz na przykład pobrać wszystkie grupy należące do uwierzytelnionego użytkownika lub pobrać co najmniej 1 grupę według jej unikalnego identyfikatora.
Wypróbuj teraz
- insert
- Tworzy grupę w Statystykach YouTube. Po utworzeniu grupy użyj metody
groupItems.insert, aby dodać do niej elementy.
Wypróbuj
- update
- Zmienia metadane grupy. Obecnie jedyną właściwością, którą można zaktualizować, jest tytuł grupy. (użyj elementów
groupItems.insert i groupItems.delete, aby dodawać i usuwać elementy grupy).
Wypróbuj
- usuń
- Usuwanie grupy.
Wypróbuj teraz
Właściwości
Tabela poniżej zawiera właściwości widoczne w tym zasobie:
| Właściwości |
kind |
string
Określa typ zasobu interfejsu API. Wartość wyniesie youtube#group. |
etag |
etag
Etag tego zasobu. |
id |
string
Identyfikator, którego YouTube używa do jednoznacznego rozpoznawania grupy. |
snippet |
object
Obiekt snippet zawiera podstawowe informacje o grupie, w tym datę i nazwę jej utworzenia. |
snippet.publishedAt |
datetime
Data i godzina utworzenia grupy. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). |
snippet.title |
string
Nazwa grupy. Wartość musi być niepustym ciągiem znaków. |
contentDetails |
object
Obiekt contentDetails zawiera dodatkowe informacje o grupie, takie jak liczba i typ elementów, które zawiera. |
contentDetails.itemCount |
unsigned long
Liczba elementów w grupie. |
contentDetails.itemType |
string
Typ zasobów zawartych w grupie.
Prawidłowe wartości tej właściwości to:
youtube#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 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` |"]]
