REST Resource: assetShares

Referensi: AssetShare

Resource assetShare, yang hanya relevan dengan aset komposisi, mengidentifikasi hubungan antara dua representasi resource aset:

  • viewId, atau tampilan komposisi, mewakili aset komposisi yang disematkan dalam rekaman suara tertentu. Tampilan komposisi adalah kumpulan informasi kanonis yang ditampilkan YouTube tentang hak komposisi untuk rekaman tertentu dan dapat menggabungkan informasi dari beberapa penyedia data. .
    • Setiap aset rekaman suara dipetakan ke tepat satu viewId.
    • Setiap viewId dipetakan ke satu atau beberapa shareIds. Namun, viewId hanya dipetakan ke beberapa shareIds jika komposisi memiliki beberapa pemilik. Dari perspektif pemilik konten tunggal, viewId dikaitkan dengan satu shareId. Hal ini karena pemilik konten hanya dapat mengambil shareIds yang mewakili data yang disediakan oleh pemilik konten itu sendiri.

      Perhatikan bahwa satu pemilik konten dapat menggunakan API untuk mewakili beberapa pemilik komposisi, dan karenanya memiliki beberapa bagian dari komposisi tersebut. Misalnya, agregator hak digital dapat memperoleh hak atas komposisi yang sama dari berbagai pihak di wilayah berbeda. Agregator akan memiliki entitas terpisah yang mewakili hak-hak tersebut, yang akan dipetakan ke bagian komposisi yang berbeda dalam model YouTube. Bagian komposisi yang berbeda tetap dapat ditautkan ke tampilan komposisi yang sama.

  • shareId, atau bagian komposisi, mewakili informasi yang disediakan penayang tertentu untuk aset komposisi. shareId dapat dikaitkan dengan banyak rekaman suara.
Ada banyak metode API yang memungkinkan Anda mengambil atau memperbarui informasi tentang suatu aset. Panduan Mengelola aset komposisi menjelaskan cara metode tersebut menangani permintaan, bergantung pada apakah ID aset yang disediakan adalah shareIds atau viewIds.

Representasi JSON 
{
  "kind": string,
  "viewId": string,
  "shareId": string
}
Kolom
kind

string

Jenis resource API. Untuk resource ini, nilainya adalah youtubePartner#assetShare.
viewId

string

Nilai yang ditetapkan dan digunakan YouTube untuk mengidentifikasi tampilan aset secara unik.
shareId

string

Nilai yang ditetapkan dan digunakan YouTube untuk mengidentifikasi pangsa aset secara unik.

Metode

list

 Metode ini mengambil daftar bagian aset yang dimiliki partner dan dipetakan ke ID tampilan aset yang ditentukan atau mengambil daftar tampilan aset yang terkait dengan ID bagian aset tertentu yang dimiliki oleh partner.