Method: assetSearch.list

Öğe meta verilerine göre öğe arama Bu yöntem, tüm öğeleri veya yalnızca içerik sahibine ait öğeleri alabilir. Bu yöntem, İçerik Yönetim Sistemi'ndeki Öğeler sayfasında bulunan gelişmiş arama özelliğinin işlevini taklit eder.

HTTP isteği

GET https://youtubepartner.googleapis.com/youtube/partner/v1/assetSearch

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
createdAfter

string

createdAfter parametresi, döndürülen öğe grubunu başlangıçta belirtilen tarih ve saatte veya sonrasında oluşturulan öğelerle sınırlar. Örneğin: 2015-01-29T23:00:00Z
createdBefore

string

createdBefore parametresi, döndürülen öğeler grubunu başlangıçta belirtilen tarih ve saatte veya daha önce oluşturulmuş olanlarla sınırlar. Örneğin: 2015-01-29T23:00:00Z
hasConflicts

boolean

hasConflicts parametresi, yalnızca sahiplik anlaşmazlığı olan öğeleri almanızı sağlar. Geçerli tek değer true'dır. Parametre değerini false olarak ayarlamak sonuçları etkilemez.
includeAnyProvidedlabel

boolean

includeAnyProvidedlabel parametresi doğru olarak ayarlanırsa sağlanan etiketlerden herhangi birini içeren öğeler aranır. Aksi takdirde, sağlanan tüm etiketleri içeren öğeler aranır.
isrcs

string

Virgülle ayrılmış en fazla 50 ISRC'nin listesi. Bu parametre için bir değer belirtirseniz API sunucusu şu parametreler için ayarlanan değerleri yoksayar: q, includeAnyProvidedLabel, hasConflicts, labels, metadataSearchFields, sort ve type.
labels

string

labels parametresi, belirli öğe etiketlerine sahip ve almak istediğiniz öğeleri belirtir. Parametre değeri, virgülle ayrılmış bir öğe etiketi listesidir.
metadataSearchFields

string

metadataSearchField parametresi, hangi meta veri alanlarına göre arama yapılacağını belirtir. İki nokta üst üste işaretiyle(:) bağlanmış meta veri alanı ve değer çiftlerinin virgülle ayrılmış bir listesidir. Örneğin: customId:my_custom_id,artist:Dandexx
onBehalfOfContentOwner

string

onBehalfOfContentOwner parametresi, kullanıcının adına işlem yaptığı içerik sahibini tanımlar. Bu parametre, hesapları birden fazla içerik sahibiyle ilişkilendirilmiş kullanıcıları destekler.
ownershipRestriction

enum (OwnershipRestriction)

ownershipRestriction parametresi, arama için sahiplik filtreleme seçeneğini belirtir. Varsayılan olarak arama yalnızca kimliği doğrulanmış kullanıcının sahip olduğu öğelerde yapılır.
pageToken

string

pageToken parametresi, döndürülecek belirli bir sonuç sayfasını tanımlayan bir jetonu belirtir. Arama sonuçlarının sonraki sayfasını almak için bu parametreyi önceki API yanıtındaki nextPageToken değerine ayarlayın.
q

string

YouTube, tüm öğeler için id, type ve customId alanlarının yanı sıra farklı öğe türlerine (filmler, müzik videoları vb.) göre değişen actor, album, director, isrc ve tmsId gibi diğer birçok meta veri alanında arama yapar.
sort

enum (Sort)

sort parametresi, arama sonuçlarının nasıl sıralanacağını belirtir. Sonuçların her zaman azalan düzende sıralandığını unutmayın.
type

string

type parametresi, almak istediğiniz öğe türlerini belirtir. Parametre değeri, virgülle ayrılmış bir öğe türleri listesidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Bu yanıtta, bir arama sorgusuyla eşleşen YouTube öğelerinin listesi gösterilir. Listedeki her öğe, bir öğenin meta verilerini içerir.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "kind": string,
  "pageInfo": {
    object (PageInfo)
  },
  "items": [
    {
      object (AssetSnippet)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

API yanıtının türü. Bu işlem için değer youtubePartner#assetSnippetList'dır.
pageInfo

object (PageInfo)

pageInfo nesnesi, sonuç kümesi için sayfalama bilgilerini kapsar.
items[]

object (AssetSnippet)

İstek ölçütleriyle eşleşen öğe kaynaklarının listesi.
nextPageToken

string

Sonuçların bir sonraki sayfasını almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/youtubepartner

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

OwnershipRestriction

Sahiplik kısıtlaması enum'ı.

Sıralamalar
OWNERSHIP_RESTRICTION_UNSPECIFIED Varsayılan değer.
MINE Geçerli kullanıcının sahip olduğu ve arama sorgusuyla eşleşen öğeleri bulur. Bu, varsayılan davranıştır.
NONE Sahibinden bağımsız olarak, arama sorgusuyla eşleşen tüm öğeleri bulur.

Sırala

Öğe arama listesi isteğinde desteklenen sıralama düzenlerinin numaralandırılmış değeri.

Sıralamalar
SORT_UNSPECIFIED Varsayılan değer.
CLAIMS Her öğe için hak talebi sayısına göre sıralayın.
TIME Her öğenin değiştirilme zamanına göre sıralayın. Bu, varsayılan değerdir.
DAILY_ENGAGED_VIEWS Her öğenin yaklaşık günlük aktif izlenme sayısına göre sıralayın.