Öğe Etiketlerini kullanın

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.

Öğe etiketleri öğelerinizi özel kategoriler halinde düzenlemenize yardımcı olarak öğe kitaplığınızı düzenlemenizi kolaylaştırır. Öğeleri etiketlerine göre arayarak belirli öğe gruplarını güncellemenizi gerektiren kullanım durumlarını da kolaylaştırabilirsiniz.

Bu kılavuzda, etiketlerle ilişkili bazı yaygın işlevleri gerçekleştirmek için YouTube Content ID API'nin nasıl kullanılacağı açıklanmaktadır. Bu kılavuzdaki bazı bölümler, Google API Gezgini'ne bağlantı veren ve bu aracı dolduran örnekler içerir. Böylece her sorguyu test edebilirsiniz.

Öğe etiketleri oluşturma

API, öğe etiketi oluşturmanın iki yolunu destekler:

  • assetLabels.insert yöntemini çağırın. İsteğin gövdesi, labelName özelliğinin yeni etiketin benzersiz adını belirttiği bir assetLabel kaynağıdır. Aynı ada sahip bir etiket zaten varsa API, 409 (Conflict) HTTP yanıt kodu döndürür.

    Aşağıdaki sorgu, Explorer Test adlı yeni bir etiket oluşturmak için assetLabels.insert yöntemini çağırır. Örnek isteğin gövde bölümü:

    {
  "labelName": "Explorer Test"
}

    İstek herhangi bir sorgu parametresi ayarlamıyor. Ancak, Google Hesabınız birden çok içerik sahibi hesabıyla ilişkilendirilmişse onBehalfOfContentOwner parametresi için de bir değer belirlemeniz gerekir.

    [no parameters set]

  • Bir öğenin etiketlerini güncellemek için assets.update yöntemini çağırın. İstekte, asset kaynağının label[] özelliğini öğeyle ilişkilendirilen etiketler listesine ayarlayın. API, daha önce açıkça assetLabel kaynağı olarak oluşturulmamış listedeki tüm etiketler için otomatik olarak yeni öğe etiketleri oluşturur.

İçerik sahibinin öğe etiketlerini listeleme

İçerik sahibinin öğe etiketlerinin listesini almak için assetLabels.list yöntemini çağırın.

  • API varsayılan olarak içerik sahibi için tüm öğe etiketlerini döndürür.
  • labelPrefix sorgu parametresi için bir değer ayarlarsanız API, yalnızca içerik sahibinin belirtilen dizeyle başlayan öğe etiketlerini döndürür.

Aşağıdaki sorgu, içerik sahibine ilişkin tüm etiketleri almak için assetLabels.list yöntemini çağırır. Ancak Google Hesabınız birden çok içerik sahibi hesabıyla ilişkilendirilmişse onBehalfOfContentOwner parametresi için bir değer ayarlamanız gerektiğini, aksi takdirde isteğin 400 (Bad Request) hatası döndüreceğini unutmayın.

[no parameters set]

Aşağıdaki sorgu aynı yöntemi çağırır ancak labelPrefix parametresinin değerini news olarak ayarlar. Sonuç olarak, API yalnızca bu dizeyle başlayan etiketler döndürür.

labelPrefix=news

Bir öğenin etiketlerini güncelleme

assets.update yöntemini çağırırken label[] özelliğinin değerini ayarlayarak bir öğenin etiketlerini güncelleyebilirsiniz. Bir öğeyi güncellediğinizde, öğenin önceki etiket listesi kaldırılır ve API isteğinde gönderilen listeyle değiştirilir. Aynı şekilde, önceki etiket listesini tutmak isterseniz orijinal etiket listesini almak ve ardından label[] özelliğinin değerini değiştirmek için assets.list yöntemini kullanmanız gerekir. Özellik değeri boşsa API, öğeyle önceden ilişkilendirilmiş etiketleri kaldırır.

Aynı etiketi birden çok öğeyle ilişkilendirebilir ve aynı öğeye sahip birden çok etiket atayabilirsiniz. Etiketlerde tekil bir etiketin birden fazla kelime uzunluğunda olabileceği anlamına gelen boşluklar bulunabilir. Yasaklanan karakterler köşeli parantez, virgül, iki nokta ve dikey çizgi karakterleridir (|). Her etiket en az iki bayt uzunluğunda olmalıdır ve 30 bayttan uzun olamaz. Her içerik sahibi bir öğe için en fazla 30 etiket ekleyebilir. Belirli bir öğe için tüm etiketlerin maksimum toplam uzunluğu 500 bayttır.

Öğeleri etikete göre arama

Bir etiket veya etiket grubuyla ilişkilendirilmiş öğelerin listesini almak için labels sorgu parametresini kullanarak assetSearch.list yöntemini çağırarak öğe etiketlerinin virgülle ayrılmış listesini belirtin.

  • Varsayılan olarak API, belirtilen öğe etiketlerinin tümüne sahip olan öğelerin listesini döndürür.
  • API isteğiniz includeAnyProvidedLabel parametresini true olarak ayarlarsa API, belirtilen etiketlerden en az biriyle eşleşen tüm öğeleri döndürür.