İçerik sahibi adına hareket etme

Not: YouTube Content ID API, YouTube içerik iş ortaklarının kullanımı için tasarlanmıştır ve tüm geliştiriciler ya da tüm YouTube kullanıcıları tarafından kullanılamaz. YouTube Content ID API'yi Google API Konsolu'nda listelenen hizmetlerden biri olarak görmüyorsanız YouTube İş Ortağı Programı hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ni ziyaret edin.

YouTube hak yönetimi sistemindeki her nesne bir içerik sahibiyle ilişkilendirilir. İçerik sahibi, bir öğe koleksiyonunun haklarına sahip olan bir YouTube iş ortağıdır. Bir uygulama YouTube Content ID API'yi kullandığında, oluşturduğu veya değiştirdiği öğeler, politikalar ve hak talepleri için içerik sahibinden yetki almalıdır. Bu yetkilendirmeyi, uygulamanın kimliği doğrulanmış kullanıcısı bir içerik sahibi hesabına erişebildiğinde alır. Kimliği doğrulanan kullanıcının içerik sahibi hesabına erişimi yoksa Content ID API'ye yapılan çağrılar başarısız olur.

İçerik sahibinin kimliğini alma

İçerik sahibinin kimliğini almak için YouTube Content ID API'nin contentOwners.list yöntemini çağırın. API yanıtı, isteği yetkilendiren kullanıcıyla ilişkili contentOwner kaynaklarının listesini içerir. Her kaynakta, id özelliği içerik sahibinin kimliğini belirtir.

İçerik sahibi kimliğini programatik olarak almayla ilgili bir örnek için Video Yükleme ve Hak Talebinde Bulunma bölümüne bakın.

İçerik sahibi adına YouTube API'lerini çağırma

YouTube Content ID API'sı

Çoğu kullanıcının tek bir içerik sahibi hesabına erişimi olduğundan Content ID API, kullanıcının kimliğine büründüğü içerik sahibini dolaylı yoldan belirleyebilir. Bu nedenle onBehalfOfContentOwner parametresi, Content ID API çağrıları için isteğe bağlıdır.

Ancak, bazı kullanıcıların birden fazla içerik sahibi hesabına erişimi vardır. Bu kullanıcılar için her API isteği, hangi içerik sahibi hesabının kullanılacağını açıkça tanımlamak üzere onBehalfOfContentOwner parametresini içermelidir.

YouTube Data API'sı (v3)

Birçok YouTube Data API yöntemi onBehalfOfContentOwner parametresini destekler. Bu parametreyi kullanan yöntemler, yetkiyi kullanarak bir uygulamanın, içerik sahibi tarafından yönetilen kanallarda, bu yönetilen kanallardaki videolarda veya diğer API kaynaklarında işlem yapmasına olanak tanır.

YouTube Data API'de yetkiyi kullanırken her zaman onBehalfOfContentOwner parametresi gerekir. Parametrenin değeri, içerik sahibini benzersiz şekilde tanımlayan bir kimliktir. YouTube Content ID API'nin contentOwners.list yöntemini çağırarak kimliği programatik olarak alabilirsiniz.

Bazı API çağrıları için ek bir yetki parametresi de gerekir. Aşağıdaki listede iki örnek açıklanmaktadır:

  • videos.insert() yöntemi, kullanıcı içerik sahibi olarak bir kanalda işlem gerçekleştirdiğinde onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerinin ayarlanmasını gerektirir. Yeni video, onBehalfOfContentOwnerChannel parametre değerinin belirttiği kanala yüklenir.
  • search.list() yöntemi, onBehalfOfContentOwner ve forContentOwner parametrelerinin ayarlanmasını gerektirir. Bu durumda forContentOwner parametresi, kullanıcının API'ye yalnızca onBehalfOfContentOwner parametresinin belirttiği içerik sahibine ait kaynakları döndürmesi talimatını sağlar.

Yetkinin desteklendiği her bir yöntemle ilgili ayrıntılar ve onBehalfOfContentOwner dışında ek bir parametre ayarlamanız gerekip gerekmediğiyle ilgili dokümanlar.

YouTube Analytics API'sı

YouTube Analytics API'yi kullanarak bir içerik sahibi raporu almak için API isteğinizde ids parametre değerini contentOwner==OWNER_ID olarak ayarlayın. Burada OWNER_ID, içerik sahibinin kimliğini belirtir.