Groups
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource group mewakili grup YouTube Analytics, yang merupakan koleksi kustom yang berisi hingga 500 channel, video, playlist, atau aset.
Semua item dalam grup harus merepresentasikan jenis resource yang sama. Misalnya, Anda tidak dapat membuat grup yang berisi 100 video dan 100 playlist.
Grup Analytics hanya dapat berisi resource yang telah Anda upload atau klaim atau yang ditautkan ke channel yang Anda kelola. Oleh karena itu, pemilik channel dapat membuat grup video dan playlist. Pemilik konten dapat membuat grup video, playlist, channel, atau aset.
Metode
API ini mendukung metode berikut untuk resource groups:
- list
- Menampilkan daftar grup yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua grup yang dimiliki pengguna terautentikasi, atau Anda dapat mengambil satu atau beberapa grup berdasarkan ID uniknya.
Coba sekarang.
- insert
- Membuat grup YouTube Analytics. Setelah membuat grup, gunakan metode
groupItems.insert untuk menambahkan item ke grup.
Coba sekarang.
- update
- Mengubah metadata untuk grup. Saat ini, satu-satunya properti yang dapat diperbarui adalah judul grup. (Gunakan
groupItems.insert dan groupItems.delete untuk menambahkan dan menghapus item grup.)
Coba sekarang.
- hapus
- Menghapus grup.
Coba sekarang.
Properti
Tabel berikut menentukan properti yang muncul dalam resource ini:
| Properti |
kind |
string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#group. |
etag |
etag
Etag resource ini. |
id |
string
ID yang digunakan YouTube untuk mengidentifikasi grup secara unik. |
snippet |
object
Objek snippet berisi informasi dasar tentang grup, termasuk tanggal pembuatan dan namanya. |
snippet.publishedAt |
datetime
Tanggal dan waktu grup dibuat. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). |
snippet.title |
string
Nama grup. Nilai harus berupa string yang tidak kosong. |
contentDetails |
object
Objek contentDetails berisi informasi tambahan tentang grup, seperti jumlah dan jenis item yang dikandungnya. |
contentDetails.itemCount |
unsigned long
Jumlah item dalam grup. |
contentDetails.itemType |
string
Jenis resource yang terdapat dalam grup.
Nilai yang valid untuk properti ini adalah:
youtube#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 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` |"]]
