Administrar solicitudes de cambio de música

Nota: La API de Content ID de YouTube está diseñada para que la usen los socios de contenido de YouTube, y no todos los desarrolladores ni todos los usuarios de YouTube pueden acceder a ella. Si no ves la API de Content ID de YouTube como uno de los servicios enumerados en la Consola de API de Google, consulta el Centro de ayuda de YouTube para obtener más información sobre el Programa de socios de YouTube.

Requisitos

Si usas cURL, asegúrate de crear una variable AUTH_TOKEN para usarla en esos comandos:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

Crea una solicitud de cambio de música

Puedes usar el método musicChangeRequests.create para cambiar un lanzamiento o segmento. Tu solicitud debe incluir un recurso de solicitud de cambio que especifique el tipo de cambio que deseas realizar. Luego, puedes enumerar tus solicitudes de cambio para verificar su estado.

Tipos de solicitudes de cambio

Entre los tipos de solicitud válidos, se incluyen los siguientes:

• misreconciledArtist: Solicita cambiar el artista de un lanzamiento o una pista. Toma un recurso DesiredArtist. Usa esta opción si no está asociada con el artista principal o invitado deseado.
• undesiredDiscography: Es una solicitud para cambiar el Canal de artista asociado con un lanzamiento. Usa esta opción si el lanzamiento de otro artista aparece de forma incorrecta en el canal de un artista.
• incorrectPlayability: Es una solicitud para cambiar la jugabilidad de una versión o pista. Usa esta opción si no se puede reproducir ni es visible en el producto como se espera.
• incorrectMusicVideo: Solicita cambiar el video musical de una pista. Toma un recurso DesiredMusicVideo. Usa esta opción si no está asociada con el video musical que quieres.
• incorrectMetadata: Solicita cambiar la ortografía, el formato o la traducción de una versión o una pista.

Ejemplo: El lanzamiento no está asociado con el artista principal o invitado deseado

Supongamos que enviaste un lanzamiento a YouTube Music, pero este tiene un artista incorrecto asociado. Para solicitar este cambio, sigue estos pasos:

1. Busca el lanzamiento afectado en YouTube Studio. Copia el número de ID (como el UPC) de la página de YouTube Studio.

2. Crea una solicitud que contenga la siguiente instrucción JSON:

   '{
     "release": "releases/0012345678901", 
     "misreconciledArtist": {
       "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
       "newArtist": "false", 
       "supplementalInfo": "Comment about the change"
     }
   }'
   

   • release es el número de ID de la versión, que puedes encontrar en YouTube Studio.
   • misreconciledArtist toma un recurso desiredArtist que comprende lo siguiente:
     .
     • channelId: Es el ID del canal del artista al que quieres mover el lanzamiento. Para obtener el ID del canal, visita el canal del artista en YouTube y copia el ID de la URL. Si el artista no existe y es un artista nuevo, deja channelId en blanco y marca newArtist: true.
     • newArtist: Si el artista no está en YouTube Music, marca este campo como true. De lo contrario, si proporcionaste un ID del canal, marca este campo como false.
     • supplementalInfo: Comentarios opcionales sobre la solicitud

3. Usa el método musicChangeRequests.create para realizar la solicitud. Incluye el JSON que contiene la solicitud. Por ejemplo, el siguiente comando muestra cómo realizar esta solicitud con 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
   

Enumerar solicitudes de cambio

Para recuperar una lista de las solicitudes de cambio de música que se registraron, usa el método musicChangeRequests.list. El método responde con una lista de solicitudes de cambio, filtradas por el propietario del contenido. También puedes filtrar los resultados por lanzamiento o segmento, y por propietario del contenido.

Ejemplo: Solicitudes de cambio de lista de un lanzamiento específico

Supongamos que necesitas obtener las solicitudes de cambio para un lanzamiento específico con otro propietario del contenido. El siguiente comando es un ejemplo de cómo realizas esta solicitud con cURL:

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

Donde:

• onBehalfOfContentOwner es el ID del canal del propietario del contenido propietario del lanzamiento o la pista.
• filter especifica un release/[RELEASE_ID_NUMBER] o track/[TRACK_ID_NUMBER].