Method: claims.list

Kimliği doğrulanmış kullanıcıyla ilişkili içerik sahibi tarafından yönetilen hak taleplerinin listesini alır. Sonuçlar, oluşturma zamanına göre azalan düzende sıralanır.

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
assetId

string

Öğe kimliğine göre hak talebi snippet'lerini aramak için claimSearch.list yönteminin assetId parametresini kullanın. Ardından, hak talebi kimliklerinin virgülle ayrılmış listesini belirtmek için bu yöntemin id parametresini kullanarak bu hak taleplerine ait claim kaynaklarını alabilirsiniz.
id

string

id parametresi, alınacak virgülle ayrılmış YouTube hak talebi kimliklerinin listesini belirtir.
onBehalfOfContentOwner

string

onBehalfOfContentOwner parametresi, kullanıcının adına hareket ettiği içerik sahibini tanımlar. Bu parametre, hesapları birden fazla içerik sahibiyle ilişkilendirilmiş kullanıcıları destekler.
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.
q

string

Belirli bir sorgu dizesiyle eşleşen hak talebi snippet'lerini aramak için claimSearch.list yönteminin q parametresini kullanın. Ardından, hak talebi kimliklerinin virgülle ayrılmış listesini belirtmek için bu yöntemin id parametresini kullanarak bu hak taleplerine ait claim kaynaklarını alabilirsiniz.
videoId

string

Video kimliğine göre hak talebi snippet'leri aramak için claimSearch.list yönteminin videoId parametresini kullanın. Ardından, hak talebi kimliklerinin virgülle ayrılmış listesini belirtmek için bu yöntemin id parametresini kullanarak bu hak taleplerine ait claim kaynaklarını alabilirsiniz.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

claims.list çağrısına yanıt olarak döndürülen hak taleplerinin sayfalara ayrı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 (Claim)
    }
  ],
  "nextPageToken": string,
  "previousPageToken": string
}
Alanlar
kind

string

API yanıtının türü. Bu işlemde youtubePartner#claimList değeri kullanılır.
pageInfo

object (PageInfo)

pageInfo nesnesi, sonuç kümesine ait sayfa oluşturma bilgilerini içerir.
items[]

object (Claim)

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

string

Sonuç grubundaki sonraki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.
previousPageToken

string

Sonuç grubundaki ö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'a Genel Bakış başlıklı makaleye bakın.