La API de Google Ads admite la vinculación de videos de YouTube a tu cuenta de Google Ads. En esta guía, se explica cómo usar la API para agregar y quitar vínculos a tu cuenta.
Vincular videos
Los videos se pueden vincular a tu cuenta de dos maneras, según quién inicie el proceso:
- Solicitas que se vincule un video a tu cuenta. En este caso, le envías una solicitud a un creador, quien debe aceptarla para establecer el vínculo con su video. Puedes revocar una solicitud que se haya extendido antes de que se acepte y, también, quitar un video vinculado después de que se acepte.
- El creador del video solicita que se vincule su video a tu cuenta de Google Ads. Luego, puedes aceptar o rechazar su solicitud.
En cada situación, se usan los siguientes métodos:
| Situación | Acción | Observaciones |
|---|---|---|
| Situación 1 | Obtén la información del video de la API de YouTube | Usa la API de YouTube para obtener el channel_id al que enviar la solicitud de vínculo de video o el video_id del video que quieres vincular. El video_id también se puede extraer de la URL de un video tomando los 11 caracteres que aparecen después de "v=". |
| Crea una solicitud de vinculación | Usa el método
DataLinkService.CreateDataLink para crear una solicitud de vinculación. No se debe establecer el status del DataLink. El servidor de la API de Google Ads establecerá este valor en REQUESTED cuando se complete correctamente la llamada a la API. |
|
| Cómo inspeccionar el estado de una solicitud | Usa GoogleAdsService.SearchStream o GoogleAdsService.Search para consultar el recurso data_link y, luego, inspecciona su
status. |
|
| Cómo revocar una solicitud | Usa el método
DataLinkService.UpdateDataLink para revocar una solicitud de vinculación cambiando el status del
DataLink de REQUESTED a REVOKED. |
|
| Cómo quitar un vínculo | Usa
DataLinkService.RemoveDataLink para quitar un video vinculado. |
|
| Situación 2 | Recupera una invitación | Usa GoogleAdsService.Search
o GoogleAdsService.SearchStream
para consultar el recurso data_link. Filtra por
status = PENDING_APPROVAL para encontrar solicitudes de vinculación que puedes aceptar o rechazar. |
| Cómo aceptar o rechazar una solicitud de vinculación | Usa el método
DataLinkService.UpdateDataLink para actualizar el estado de DataLink a ENABLED para aceptar o REJECTED para rechazar la solicitud. |
En este flujo de trabajo, se pueden generar los siguientes errores comunes:
| Código de error | Explicación |
|---|---|
DataLinkError.PERMISSION_DENIED |
El cliente no tiene permiso para realizar esta acción. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
No se pudo crear un vínculo al video porque el ID no es válido. |