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.
Vincula 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 esta situación, envías una solicitud a un creador, que debe aceptar para establecer la vinculación a su video. Puedes revocar una solicitud que se extendió antes de que se acepte y también quitar un video vinculado después de que se acepte.
- El creador del video solicita que su video se vincule 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 | Cómo obtener la información del video de la API de YouTube | Usa la API de YouTube para obtener el channel_id al que se enviará la solicitud de vinculación del video o el video_id del video que quieres vincular. El video_id también se puede extraer de la URL de un video si se extraen los 11 caracteres 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 configurar status de DataLink. El servidor de la API de Google Ads lo establecerá 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. Para ello, cambia el status de
DataLink de REQUESTED a REVOKED. |
|
| Cómo quitar un vínculo | Usa
DataLinkService.RemoveDataLink para quitar un video vinculado. |
|
| Situación 2 | Cómo recuperar 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 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 la solicitud o a REJECTED para rechazarla. |
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 de video porque el ID no es válido. |