GroupItems: list

Önemli: Bu yönteme yapılan API istekleri için aşağıdakilerden birine erişim gerekir:
  • https://www.googleapis.com/auth/youtube kapsamı
    veya
  • https://www.googleapis.com/auth/youtube.readonly kapsamı
    ve
    https://www.googleapis.com/auth/yt-analytics.readonly kapsamı

İlk seçenek, salt okunur bir kapsam olan tek bir kapsam kullanır. İkinci seçenek ise iki salt okunur kapsam kullanır.

API istek parametreleriyle eşleşen bir grup öğesi koleksiyonu döndürür.

İstek

HTTP isteği

GET https://youtubeanalytics.googleapis.com/v2/groupItems

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az birinde yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsamlar
https://www.googleapis.com/auth/yt-analytics.readonly YouTube içeriğiniz için YouTube Analytics raporlarını görüntüleyin. Bu kapsam, görüntüleme sayısı ve puan sayısı gibi kullanıcı etkinliği metriklerine erişim sağlar.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube içeriğinizle ilgili YouTube Analytics para kazanma raporlarını görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine, tahmini gelir ve reklam performansı metriklerine erişim sağlar.
https://www.googleapis.com/auth/youtube YouTube hesabınızı yönetin. YouTube Analytics API'de kanal sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.
https://www.googleapis.com/auth/youtubepartner YouTube'daki YouTube öğelerini ve ilişkili içeriği görüntüleyin ve yönetin. YouTube Analytics API'de içerik sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.

Parametreler

Aşağıdaki tabloda bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
groupId string
id parametresi, grup öğelerini almak istediğiniz grubun benzersiz kimliğini belirtir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre, yalnızca birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube kullanıcısını tanımladığını gösterir. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulama yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimlik doğrulaması yaptığı hesap, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek içeriği

Bu yöntemi çağırırken istek gövdesi sağlamaz.

Yanıt

Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt metni döndürür:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

Ö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#groupItemListResponse olur.
etag etag
Bu kaynağın Etag değeri.
items[] list
Grubun içerdiği öğelerin listesi. Listedeki her öğe bir groupItem kaynağını temsil eder.

Hatalar

API, bu API yöntemine özgü herhangi bir hata mesajı tanımlamaz. Ancak bu yöntem, hata mesajı dokümanlarında listelenen genel API hatalarını döndürmeye devam edebilir.

Deneyin!

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.