Agir em nome de um proprietário de conteúdo

Cada objeto no sistema de gerenciamento de direitos do YouTube está associado a um proprietário de conteúdo. Proprietário de conteúdo é um parceiro do YouTube que detém os direitos de um conjunto de ativos. Quando um aplicativo usa a API do Content ID do YouTube, ele deve ter autorização do proprietário do conteúdo quanto aos ativos, políticas e reivindicações que cria ou manipula. Ele recebe essa autorização quando o usuário autenticado do aplicativo tem acesso a uma conta de proprietário do conteúdo. Se o usuário autenticado não tiver acesso a uma conta de proprietário do conteúdo, as chamadas para a API Content ID falharão.

Recuperar o ID de um proprietário de conteúdo

Para recuperar o ID de um proprietário do conteúdo, chame o método contentOwners.list da API Content ID do YouTube. A resposta da API contém uma lista de recursos contentOwner associados ao usuário que autorizou a solicitação. Em cada recurso, a propriedade id especifica o ID do proprietário do conteúdo.

Para ver um exemplo que recupera o ID do proprietário de conteúdo de forma programática, consulte Enviar e reivindicar um vídeo.

Chamar APIs do YouTube em nome de um proprietário de conteúdo

API do Content ID do YouTube

Como a maioria dos usuários tem acesso a uma única conta de proprietário de conteúdo, a API do Content ID pode determinar implicitamente o proprietário do conteúdo em nome do qual o usuário está agindo. Dessa forma, o parâmetro onBehalfOfContentOwner é opcional para chamadas da API Content ID.

No entanto, alguns usuários têm acesso a várias contas de proprietário de conteúdo. Para esses usuários, cada solicitação de API precisa incluir o parâmetro onBehalfOfContentOwner para identificar explicitamente qual conta de proprietário do conteúdo usar.

YouTube Data API (v3)

Muitos métodos da API YouTube Data também aceitam o parâmetro onBehalfOfContentOwner. Os métodos que usam esse parâmetro empregam a delegação, permitindo que um aplicativo execute ações em canais gerenciados pelo proprietário do conteúdo, em vídeos nesses canais gerenciados ou em outros recursos da API.

Ao usar delegação na API YouTube Data, o parâmetro onBehalfOfContentOwner é sempre obrigatório. O valor do parâmetro é um ID que identifica exclusivamente o proprietário do conteúdo. Você pode recuperar o ID de forma programática chamando o método contentOwners.list da API Content ID do YouTube.

Algumas chamadas de API também exigem um parâmetro de delegação adicional. A lista abaixo descreve dois exemplos:

• O método videos.insert() exige que os parâmetros onBehalfOfContentOwner e onBehalfOfContentOwnerChannel sejam definidos quando o usuário estiver realizando uma ação em um canal como proprietário do conteúdo. O novo vídeo é enviado ao canal especificado pelo valor do parâmetro onBehalfOfContentOwnerChannel.
• O método search.list() requer a definição dos parâmetros onBehalfOfContentOwner e forContentOwner. Nesse caso, com o parâmetro forContentOwner, o usuário pode instruir a API a retornar apenas recursos do proprietário do conteúdo especificados pelo parâmetro onBehalfOfContentOwner.

A documentação de cada método específico detalha quando ele aceita delegação e se você precisa definir outro parâmetro além de onBehalfOfContentOwner.

API do YouTube Analytics

Para recuperar um relatório do proprietário do conteúdo usando a API YouTube Analytics, defina o valor do parâmetro ids na sua solicitação de API como contentOwner==OWNER_ID, em que OWNER_ID especifica o ID do proprietário do conteúdo.