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

Observação: a API do Content ID do YouTube é destinada ao uso dos parceiros de conteúdo do YouTube e não está acessível a todos os desenvolvedores ou a todos os usuários do YouTube. Caso você não encontre 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.

Requisitos

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 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. Depois disso, será 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 de uma faixa. Usa um recurso DesiredArtist. Use essa opção se ela não estiver associada ao artista principal ou em destaque.
• undesiredDiscography: solicitação para mudar o canal do artista associado a um lançamento. Use essa opção se o lançamento de outro artista aparecer incorretamente no canal de um artista.
• incorrectPlayability: solicitação para mudar a jogabilidade de um lançamento ou de uma faixa. Use essa opção se não for possível exibir ou reproduzir o conteúdo como esperado.
• incorrectMusicVideo: solicitação para mudar o vídeo de música de uma faixa. Usa um recurso DesiredMusicVideo. Use esta opção se ela não estiver associada ao videoclipe correto.
• incorrectMetadata: pedir para mudar a ortografia, a formatação ou a tradução de uma versão ou faixa.

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

Imagine 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:

1. Encontre a versão afetada no YouTube Studio. Copie o número do ID (como o UPC) da página do YouTube Studio.

2. Crie uma solicitação com 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 pode ser encontrado no YouTube Studio.
   • misreconciledArtist usa um recurso do desiredArtist composto pelo seguinte:
     • channelId: ID do canal do artista para quem você quer mover o lançamento. Para encontrar o ID do canal, acesse o canal do artista no YouTube e copie o ID do URL. Se o artista não existir e for novo, deixe channelId em branco e marque newArtist: true.
     • newArtist: se o artista não estiver no YouTube Music, marque este campo como true. Caso contrário, se você tiver fornecido um ID do canal, marque este campo como false.
     • supplementalInfo: comentários opcionais sobre a solicitação.

3. 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 fazer 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 das 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. Você também pode filtrar os resultados por lançamento ou faixa e 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 mudança de um lançamento específico com 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 proprietário do lançamento ou da faixa.
• filter especifica um release/[RELEASE_ID_NUMBER] ou track/[TRACK_ID_NUMBER].