Öğe Etiketlerini kullanın

Not: YouTube Content ID API, YouTube içerik iş ortakları tarafından kullanılmak üzere tasarlanmıştır. Tüm geliştiriciler veya YouTube kullanıcıları tarafından erişilemez. Google API Konsolu'nda listelenen hizmetlerden biri olarak YouTube Content ID API'yi görmüyorsanız YouTube İş Ortağı Programı hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ne bakın.

Öğ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 rehberde, etiketlerle ilişkilendirilmiş bazı yaygın işlevleri gerçekleştirmek için YouTube Content ID API'nin nasıl kullanılacağı açıklanmaktadır. Bu kılavuzun bazı bölümlerinde, Google API Gezgini'ne bağlantı veren ve bu aracı dolduran örnekler yer alır. Böylece her bir 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övdesi:

    {
  "labelName": "Explorer Test"
}

    İstek herhangi bir sorgu parametresi ayarlamadı. Ancak Google Hesabınız birden çok içerik sahibi hesabıyla ilişkilendirilmişse onBehalfOfContentOwner parametresi için bir değer de 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şkilendirilmiş etiketlerin listesine ayarlayın. API, daha önce açıkça assetLabel kaynakları şeklinde 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.

  • Varsayılan olarak API, içerik sahibine ait 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 belirlemeniz 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ıyor ancak labelPrefix parametresinin değerini news olarak ayarlıyor. Sonuç olarak, API yalnızca söz konusu 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. Bu nedenle, önceki etiket listesini tutmak isterseniz orijinal etiket listesini almak için assets.list yöntemini kullanmanız ve ardından label[] özelliğinin değerini değiştirmeniz 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 birden çok etiket atayabilirsiniz. Etiketlerde tekil bir etiketin birden fazla kelime uzunluğunda olabileceği anlamına gelen boşluklar bulunabilir. Yasaklı karakterler; açılı parantez, virgül, iki nokta üst üste 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 öğe etiketlerinin virgülle ayrılmış bir listesini belirtmek üzere labels sorgu parametresini kullanarak assetSearch.list yöntemini çağırın.

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