Groups

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.

Kaynak temsili

Aşağıdaki JSON yapısında, groups kaynağının biçimi gösterilmektedir:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

Ö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#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset