Method: claimSearch.list

Arama ölçütleriyle eşleşen hak taleplerinin listesini alır. Belirli bir öğe veya video ile ilişkili ya da belirtilen sorgu dizesiyle eşleşen hak taleplerini arayabilirsiniz.

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
assetId

string

assetId parametresi, hak taleplerini aldığınız öğenin YouTube öğe kimliğini belirtir.
contentType

enum (ContentType)

contentType parametresi, almak istediğiniz hak taleplerinin içerik türünü belirtir.
createdAfter

string

createdAfter parametresi, döndürülen taleplerin kümesini belirtilen tarihte veya sonrasında (dahil) oluşturulanlarla kısıtlamanıza olanak tanır.
createdBefore

string

createdBefore parametresi, döndürülen taleplerin kümesini belirtilen tarihten önce (hariç) oluşturulanlarla kısıtlamanıza olanak tanır.
inactiveReasons

string

inactiveReasons parametresi, hak taleplerinin etkin olmama nedenlerine göre ne tür etkin olmayan hak talepleri bulmak istediğinizi belirtmenize olanak tanır.
includeThirdPartyClaims

boolean

Bu parametre, videoId parametresiyle birlikte kullanıldığında üçüncü taraf hak taleplerinin arama sonuçlarına dahil edilip edilmeyeceğini belirler.
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.
origin

string

origin parametresi, hak taleplerini bulmak istediğiniz kaynakları belirtir. Virgülle ayrılmış kaynak değerleri listesidir.
pageToken

string

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

boolean

partnerUploaded parametresi, arama sonuçlarınızı yalnızca iş ortağı tarafından yüklenen veya iş ortağı tarafından yüklenmeyen hak taleplerini gösterecek şekilde filtrelemek isteyip istemediğinizi belirtir.
q

string

q parametresi, arama sonuçlarını filtrelemek için kullanılacak sorgu dizesini belirtir. YouTube, sorgu dizesini şu hak talebi alanlarında arar: videoTitle, video_keywords, user_name, isrc, iswc, grid, customId ve içerik sahibinin e-posta adresinde.
referenceId

string

referenceId parametresi, hak taleplerini aldığınız referansın YouTube referans kimliğini belirtir.
sort

enum (Sort)

sort parametresi, API yanıtındaki kaynakları sıralamak için kullanılacak yöntemi belirtir. Varsayılan değer date'dır. Ancak status parametre değeri appealed, disputed, pending, potential veya routedForReview ise sonuçlar hak talebi inceleme süresinin sona erdiği zamana göre sıralanır.
status

enum (Status)

status parametresi, sonuçlarınızı yalnızca belirtilen durumdaki hak talepleriyle sınırlar.
statusModifiedAfter

string

statusModifiedAfter parametresi, sonuç kümesini yalnızca durumu belirtilen tarihte veya sonrasında (belirtilen tarih dahil) değiştirilmiş hak taleplerini içerecek şekilde kısıtlamanıza olanak tanır. Belirtilen tarih, 30 Haziran 2016 (2016-06-30) veya sonraki bir tarih olmalıdır. Parametre değerinin biçimi YYYY-MM-DD.
statusModifiedBefore

string

statusModifiedBefore parametresi, sonuç kümesini yalnızca durumu belirtilen tarihten önce (hariç) değiştirilmiş hak taleplerini içerecek şekilde kısıtlamanıza olanak tanır. Belirtilen tarih, 1 Temmuz 2016 (2016-07-01) veya sonrası olmalıdır. Parametre değerinin biçimi YYYY-MM-DD.
videoId

string

videoId parametresi, hak taleplerini aldığınız YouTube video kimliklerinin virgülle ayrılmış listesini belirtir.
isVideoShortsEligible

boolean

isVideoShortsEligible parametresi, sonuç kümesini yalnızca YouTube Shorts'a uygun videolardaki hak taleplerini içerecek şekilde kısıtlamanıza veya bu hak taleplerini hariç tutmanıza olanak tanır. Belirtilmediği takdirde, YouTube Shorts'a uygunluk durumuna göre filtreleme yapılmaz.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Bir claimSearch.list çağrısına yanıt olarak döndürülen talep snippet'lerinin sayfalandırılmış listesi.

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 (ClaimSnippet)
    }
  ],
  "nextPageToken": string,
  "previousPageToken": string
}
Alanlar
kind

string

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

object (PageInfo)

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

object (ClaimSnippet)

İstek ölçütleriyle eşleşen hak taleplerinin listesi.
nextPageToken

string

Sonuç kümesinde bir sonraki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.
previousPageToken

string

Sonuç kümesinde önceki sayfayı 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.

ContentType

İçerik türünün numaralandırılmış değeri.

Sıralamalar
CONTENT_TYPE_UNSPECIFIED Varsayılan değer.
AUDIO Sonuçları yalnızca sesle ilgili hak talepleriyle sınırlandırın.
AUDIOVISUAL Sonuçları görsel-işitsel hak talepleriyle sınırlandırın.
VISUAL Sonuçları yalnızca video taklitleriyle sınırlayın.

Sırala

Desteklenen sıralama ölçütleri.

Sıralamalar
SORT_UNSPECIFIED Varsayılan değer.
DATE Kaynaklar, oluşturulma tarihlerine göre ters kronolojik sırada (en yeni kaynaktan en eski kaynağa doğru) sıralanır. status parametresi şu değerlerden herhangi birine ayarlanırsa bu değer geçerli olmaz: appealed, disputed, pending, potential veya routedForReview.
DAILY_ENGAGED_VIEWS Kaynaklar, hak talebinde bulunulan içerik için yaklaşık günlük etkileşimli görüntüleme sayısına göre en yüksekten en düşüğe doğru sıralanır. status parametresi şu değerlerden herhangi birine ayarlanırsa bu değer geçerli olmaz: appealed, disputed, pending, potential veya routedForReview.
LIFETIME_ENGAGED_VIEWS Kaynaklar, hak talebinde bulunulan içerik için tahmini kullanım süresi boyunca etkileşimli görüntüleme sayısına göre en yüksekten en düşüğe doğru sıralanır. status parametresi şu değerlerden herhangi birine ayarlanırsa bu değer geçerli olmaz: appealed, disputed, pending, potential veya routedForReview.

Durum

Hak talebi durumunun sıralaması.

Sıralamalar
STATUS_UNSPECIFIED Varsayılan değer.
ACTIVE Sonuçları etkin durumdaki hak talepleriyle sınırlandırın.
APPEALED Sonuçları, itiraz edilen hak talepleriyle sınırlandırın.
DISPUTED Sonuçları, itiraz edilen hak talepleriyle sınırlandırın.
INACTIVE Sonuçları, etkin olmayan durumdaki hak talepleriyle sınırlandırın.
PENDING Sonuçları, durumu "beklemede" olan hak talepleriyle sınırlayın.
POTENTIAL Sonuçları, potansiyel statüye sahip hak talepleriyle sınırlandırın.
ROUTED_FOR_REVIEW Sonuçları, eşleşme politikası kuralına göre inceleme gerektiren hak talepleriyle sınırlandırın.
TAKEDOWN Sonuçları, yayından kaldırma durumuna sahip iddialarla sınırlandırın.
SHORT_MATCH Sonuçları, eşleşen segmentin, hak talebinde bulunulması gerektiğinden emin olmamızı sağlayacak kadar uzun olmadığı hak talepleriyle sınırlandırın.
YOUTUBE_PARTNER Sonuçları, bir YT iş ortağına ait kanala yüklenen videolarla ilgili hak talepleriyle sınırlandırın.
LOW_CONFIDENCE Düşük eşleşme puanı, düşük güven puanı, yüksek görüntüleme sayısı gibi çeşitli nedenlerle sonuçları güvenilirliği düşük hak talepleriyle sınırlandırın.
YT_MONETIZATION_POLICY Sonuçları, aslında müzik toplayıcılar aracılığıyla yapılmış birinci taraf hak talepleri olduğundan şüphelenilen üçüncü taraf hak talepleriyle sınırlandırın (içerik üreticilerin YPP'ye girmesine gerek kalmadan para kazanmasına olanak tanır).
RETROACTIVE_BLOCK Sonuçları, eski engelleme kapsamında yapılan düşük güvenilirlik düzeyine sahip hak talepleriyle sınırlandırın.