Esta página foi traduzida pela API Cloud Translation.

Gerenciar solicitações de mudança de música

Observação: a API Content ID do YouTube é destinada a parceiros de conteúdo do YouTube e não pode ser acessada por todos os desenvolvedores ou usuários do YouTube. Se você não encontrar a API Content ID do YouTube como um dos serviços listados no Console de APIs do Google, consulte a Central de Ajuda do YouTube para saber mais sobre o Programa de Parcerias do YouTube.

Observação:as informações neste guia se aplicam especificamente aos recursos de composição.

No YouTube Studio, você pode solicitar mudanças nos seus recursos musicais. Você também pode usar a API Content ID para:

Criar solicitações de mudança
Listar o status das solicitações de mudança

Nesta página, você encontra uma visão geral dos métodos MusicChangeRequest na API Content ID. Ele também fornece exemplos de como criar e listar solicitações de alteração.

Requisitos

Você precisa conseguir credenciais de autorização para usar essa API. Você usará seu token de autorização em suas solicitações.

Se você estiver usando cURL, crie uma variável AUTH_TOKEN para usar nesses comandos:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

Criar um pedido de mudança de música

Use o método musicChangeRequests.create para alterar uma versão ou uma faixa. Sua solicitação precisa incluir um recurso de solicitação de alteração que especifique o tipo de mudança que você quer fazer. Em seguida, é possível listar suas solicitações de mudança para verificar o status delas.

Tipos de solicitações de mudança

Os tipos de solicitação válidos incluem:

misreconciledArtist: solicitação para mudar o artista de um lançamento ou uma faixa. Usa um recurso DesiredArtist. Use essa opção se o conteúdo não estiver associado ao artista principal ou em destaque desejado.
undesiredDiscography: pedido para mudar o canal do artista associado a um lançamento. Use essa opção se o lançamento de outro artista estiver aparecendo no canal de um artista por engano.
incorrectPlayability: solicitação para mudar a jogabilidade de uma versão ou faixa. Use esta opção se ele não puder ser reproduzido ou exibido como esperado.
incorrectMusicVideo: pedido para mudar o vídeo de música de uma faixa. Usa um recurso DesiredMusicVideo. Use essa opção se ela não estiver associada ao videoclipe correto.
incorrectMetadata: pedir a mudança de ortografia, formatação ou tradução de uma versão ou faixa.

Exemplo: o lançamento não está associado ao artista principal ou em destaque desejado

Suponha que você enviou um lançamento para o YouTube Music, mas ele está associado a um artista incorreto. Para solicitar essa mudança, siga estas etapas:

Localize a versão afetada no YouTube Studio. Copie o número do ID (como o UPC) da página do YouTube Studio.
Crie uma solicitação que contenha a seguinte instrução JSON:
```
'{
  "release": "releases/0012345678901", 
  "misreconciledArtist": {
    "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
    "newArtist": "false", 
    "supplementalInfo": "Comment about the change"
  }
}'
```
- release é o ID do lançamento, que você encontra no YouTube Studio.
- misreconciledArtist usa um recurso desiredArtist composto pelo seguinte:
  - channelId: o ID do canal do artista para onde você quer transferir o lançamento. Para conseguir o ID, acesse o canal do artista no YouTube e copie o ID do URL. Se o artista não existir e for um novo artista, deixe channelId em branco e marque newArtist: true.
  - newArtist: se o artista não estiver no YouTube Music, marque esse campo como true. Caso contrário, se você forneceu um ID do canal, marque esse campo como false.
  - supplementalInfo: comentários opcionais sobre a solicitação.

Use o método musicChangeRequests.create para fazer a solicitação. Inclua o JSON que contém a solicitação. Por exemplo, o comando a seguir mostra como você faria essa solicitação com cURL:

curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests

Listar solicitações de mudança

Para recuperar uma lista de solicitações de mudança de música informadas, use o método musicChangeRequests.list. O método responde com uma lista de solicitações de alteração, filtrada pelo proprietário do conteúdo. Também é possível filtrar os resultados por lançamento ou faixa ou por proprietário do conteúdo.

Exemplo: listar solicitações de mudança para uma versão específica

Suponha que você precise receber as solicitações de alteração de uma versão específica de outro proprietário do conteúdo. O comando a seguir é um exemplo de como fazer essa solicitação com cURL:

curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999

onde:

onBehalfOfContentOwner é o ID do canal do proprietário do conteúdo que é o proprietário da versão ou da faixa.
filter especifica um release/[RELEASE_ID_NUMBER] ou um track/[TRACK_ID_NUMBER].