GroupItems: insert

Grup öğesi oluşturur.

İstek

HTTP isteği

POST 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ğiniz için YouTube Analytics'teki parasal raporları 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çerikleri görüntüleyip 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
İ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. İçerik sahiplerinin, her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimliklerini doğrulamalarını ve tüm video ve kanal verilerine erişmelerini sağlar. Kullanıcının kimlik doğrulaması yaptığı hesap, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek içeriği

İstek gövdesinde bir groupItem kaynağı sağlayın. Bu kaynak için aşağıdaki özellikler için bir değer belirtmeniz gerekir.

  • groupId
  • resource.id

Yanıt

Öğe başarıyla eklenirse bu yöntem, yanıt gövdesinde bir groupItem kaynağı döndürür.

İstekte belirtilen öğe, istek yapılmadan önce gruba eklenmişse bu yöntem bir HTTP 204 yanıt kodu (No Content) döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı ile ilgili dokümanları inceleyin.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) groupContainsMaximumNumberOfItems Grup zaten izin verilen maksimum sayıda öğe içeriyor.

Deneyin!

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