Groups

group kaynağı, en fazla 500 kanal, video, oynatma listesi veya öğeden oluşan özel bir koleksiyon olan YouTube Analytics grubunu temsil eder.

Bir gruptaki tüm öğeler aynı kaynak türünü temsil etmelidir. Örneğin, 100 video ve 100 oynatma listesi içeren bir grup oluşturamazsınız.

Bir Analytics grubu yalnızca yüklediğiniz veya hak talebinde bulunduğunuz ya da yönettiğiniz bir kanala bağlı olan kaynakları içerebilir. Sonuç olarak, kanal sahipleri video ve oynatma listesi grupları 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 isteği 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ı alabilir veya bir veya daha fazla grubu benzersiz kimliklerine göre alabilirsiniz. Hemen deneyin.
ekle
YouTube Analytics grubu oluşturur. Bir grup oluşturduktan sonra, gruba öğe eklemek için groupItems.insert yöntemini kullanın. Hemen deneyin.
güncelle
Bir grubun meta verilerini değiştirir. Şu anda güncellenebilen tek özellik grup başlığıdır. (Grup öğeleri eklemek ve kaldırmak için groupItems.insert ve groupItems.delete özelliklerini kullanın.) Hemen deneyin.
sil
Bir grubu siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir groups kaynağının biçimini gösterir:

{
  "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 olacak.
etag etag
Bu kaynağın Etag'i.
id string
YouTube'un grubu benzersiz bir şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, grup hakkındaki temel bilgileri ve oluşturma tarihi ile adını 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ğerin boş olmayan bir dize olması gerekir.
contentDetails object
contentDetails nesnesi, içerdiği öğe sayısı ve türü gibi grup hakkında ek bilgiler içerir.
contentDetails.itemCount unsigned long
Gruptaki öğe sayısı.
contentDetails.itemType string
Grubun içerdiği kaynakların türü.

Bu mülk için geçerli değerler şunlardır:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset