Groups
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
group kaynağı, 500 adede kadar kanal, video, oynatma listesi veya öğenin yer aldığı özel bir koleksiyon olan YouTube Analytics grubunu temsil eder.
Bir gruptaki tüm öğeler aynı türde kaynak içermelidir. Örneğin, 100 video ve 100 oynatma listesi içeren bir grup oluşturamazsınız.
Bir Analytics grubunda yalnızca yüklediğiniz veya hak talebinde bulunduğunuz ya da yönettiğiniz bir kanala bağlı kaynaklar bulunabilir. Sonuç olarak, kanal sahipleri video grupları ve oynatma listeleri oluşturabilir. İçerik sahipleri video, oynatma listesi, kanal veya öğe grupları oluşturabilir.
Yöntemler
API, groups kaynakları için aşağıdaki yöntemleri destekler:
- list
- API istek parametreleriyle eşleşen grupların listesini döndürür. Örneğin, kimliği doğrulanmış kullanıcının sahip olduğu tüm grupları veya benzersiz kimliklerine göre bir veya daha fazla grubu alabilirsiniz.
Hemen deneyin.
- insert
- YouTube Analytics grubu oluşturur. Grup oluşturduktan sonra gruba öğe eklemek için
groupItems.insert yöntemini kullanın.
Hemen deneyin.
- update
- Bir grubun meta verilerini değiştirir. Şu anda güncellenebilecek tek özellik grubun başlığıdır. (Grup öğeleri eklemek ve kaldırmak için
groupItems.insert ve groupItems.delete simgesini kullanın.)
Hemen deneyin.
- sil
- Grubu siler.
Hemen deneyin.
Özellikler
Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:
| Özellikler |
kind |
string
API kaynağının türünü tanımlar. Değer youtube#group olur. |
etag |
etag
Bu kaynağın Etag değeri. |
id |
string
YouTube'un grubu benzersiz bir şekilde tanımlamak için kullandığı kimliktir. |
snippet |
object
snippet nesnesi, oluşturulma tarihi ve adı da dahil olmak üzere grupla ilgili temel bilgileri içerir. |
snippet.publishedAt |
datetime
Grubun oluşturulduğu tarih ve saat. Değer ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir. |
snippet.title |
string
Grup adı. Değer, boş olmayan bir dize olmalıdır. |
contentDetails |
object
contentDetails nesnesi, grupla ilgili ek bilgiler (ör. içerdiği öğelerin sayısı ve türü) içerir. |
contentDetails.itemCount |
unsigned long
Gruptaki öğe sayısı. |
contentDetails.itemType |
string
Grubun içerdiği kaynak türü.
Bu özellik için geçerli değerler şunlardır:
youtube#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 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` |"]]
