REST Resource: assetShares

Recurso: AssetShare

Um recurso assetShare, que só é relevante para recursos de composição, identifica uma relação entre duas representações de um recurso de recurso:

  • O viewId, ou visualização de composição, representa o recurso de composição incorporado em uma gravação de som específica. A visualização de composição é o conjunto canônico de informações que o YouTube exibe sobre os direitos de composição de uma determinada gravação e pode sintetizar informações de vários provedores de dados. .
    • Cada recurso de gravação de som é mapeado para exatamente um viewId.
    • Cada viewId é mapeada para uma ou mais shareIds. No entanto, uma viewId só é mapeada para vários shareIds quando uma composição tem vários proprietários. Do ponto de vista de um único proprietário de conteúdo, um viewId é associado a um único shareId. Isso ocorre porque o proprietário do conteúdo só pode extrair os shareIds que representam os dados fornecidos pelo próprio proprietário.

      Observe que é possível que um único proprietário de conteúdo usando a API represente vários proprietários de uma composição e, portanto, tenha várias cotas dessa composição. Por exemplo, um agregador de direitos digitais pode receber direitos sobre a mesma composição de partes diferentes em territórios distintos. O agregador teria entidades discretas representando esses direitos, que seriam mapeadas para diferentes cotas de composição no modelo do YouTube. As diferentes cotas de composição ainda podem estar vinculadas às mesmas visualizações de composição.

  • O shareId, ou cota de composição, representa as informações que um editor específico forneceu para um recurso de composição. Um shareId pode ser associado a muitas gravações de som.
Muitos métodos de API permitem que você recupere ou atualize informações sobre um recurso. O guia Gerenciamento de recursos de composição explica como esses métodos lidam com solicitações, dependendo se os IDs de recurso fornecidos são shareIds ou viewIds.

Representação JSON 
{
  "kind": string,
  "viewId": string,
  "shareId": string
}
Campos
kind

string

O tipo do recurso da API. Para este recurso, o valor é youtubePartner#assetShare.
viewId

string

Um valor que o YouTube atribui e usa para identificar exclusivamente a visualização do recurso.
shareId

string

Um valor que o YouTube atribui e usa para identificar exclusivamente a cota de recursos.

Métodos

list

 Esse método recupera uma lista de compartilhamentos de recursos que o parceiro possui e que mapeiam para um ID de visualização de recurso especificado ou recupera uma lista de visualizações de recursos associadas a um código de compartilhamento de recursos especificado de propriedade do parceiro.