REST Resource: assetShares

Ressource: AssetShare

Une ressource assetShare, qui ne concerne que les éléments de composition, identifie une relation entre deux représentations d'une ressource d'élément:

  • La viewId, ou vue composite, représente l'élément de composition intégré à un enregistrement audio spécifique. La vue de composition est l'ensemble canonique d'informations que YouTube affiche concernant les droits de composition d'un enregistrement donné. Elle peut synthétiser des informations provenant de plusieurs fournisseurs de données. .
    • Chaque élément Enregistrement audio correspond à exactement un viewId.
    • Chaque viewId correspond à un ou plusieurs shareIds. Toutefois, une viewId ne correspond à plusieurs shareIds que lorsqu'une composition a plusieurs propriétaires. Du point de vue d'un propriétaire de contenu unique, un viewId est associé à un seul shareId. En effet, le propriétaire du contenu ne peut récupérer que les shareIds qui représentent les données fournies par le propriétaire du contenu.

      Sachez qu'il est possible qu'un même propriétaire de contenu utilise l'API pour représenter plusieurs propriétaires d'une composition et, par conséquent, détenir plusieurs parts de cette composition. Par exemple, un agrégateur de droits numériques peut obtenir les droits d'une même composition auprès de différentes parties dans différents territoires. L'agrégateur comporte des entités distinctes représentant ces droits, qui correspondent aux différentes parts de la composition dans le modèle de YouTube. Les différentes parts de la composition peuvent toujours être associées aux mêmes vues de la composition.

  • Le shareId, ou part de composition, représente les informations fournies par un éditeur spécifique pour un élément de composition. Un shareId peut être associé à de nombreux enregistrements audio.
De nombreuses méthodes d'API vous permettent de récupérer ou de mettre à jour des informations sur un élément. Le guide Gérer les éléments de composition explique comment ces méthodes traitent les requêtes selon que les ID d'élément fournis sont shareIds ou viewIds.

Représentation JSON 
{
  "kind": string,
  "viewId": string,
  "shareId": string
}
Champs
kind

string

Type de ressource d'API. Pour cette ressource, la valeur est youtubePartner#assetShare.
viewId

string

Valeur attribuée et utilisée par YouTube pour identifier de façon unique la vue de l'élément.
shareId

string

Valeur attribuée et utilisée par YouTube pour identifier la part d'éléments de façon unique.

Méthodes

list

 Cette méthode permet de récupérer la liste des partages d'éléments appartenant au partenaire et qui correspondent à un ID de vue d'élément spécifié, ou de récupérer la liste des vues d'éléments associées à un ID de partage d'élément spécifique appartenant au partenaire.