Groups: insert

YouTube Analytics grubu oluşturur. Grup oluşturduktan sonra gruba öğe eklemek için groupItems.insert yöntemini kullanın.

İstek

HTTP isteği

POST https://youtubeanalytics.googleapis.com/v2/groups

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle 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ç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
İ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 grup kaynağı sağlayın. Bu kaynak için aşağıdaki özellikler için bir değer belirtmeniz gerekir.

  • snippet.title
  • contentDetails.itemType

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir grup kaynağı döndürür.

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ği ile yanıtını görmek için APIs Explorer yönergesini kullanın.