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.
Cómo 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, envías una solicitud a un creador, quien debe aceptarla para establecer la vinculación 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 se enviará la solicitud del vínculo del video y el video_id
del video que deseas vincular. El video_id es la cadena de 11 caracteres que se encuentra en las URLs de los videos de YouTube (por ejemplo, el parámetro v en www.youtube.com/watch?v=VIDEO_ID o la ruta de acceso en youtu.be/VIDEO_ID). |
| Crea una solicitud de vinculación | Usa el método
DataLinkService.CreateDataLink para crear una solicitud de vínculo, especificando youtube_video.channel_id y youtube_video.video_id
para identificar el video y su canal asociado. A partir de la versión 24, también puedes especificar youtube_link_metadata.brand_channel_id para proporcionar el ID del canal de marca de YouTube vinculado y ayudar a los creadores a comprender tu marca.
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, inspeccionar 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. |
Recupera los detalles del vínculo
Puedes usar GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar el recurso data_link. La siguiente búsqueda recupera detalles de los vínculos a videos de YouTube, incluidos el ID del video de YouTube y el ID del canal:
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
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 del video no es válido. |
DataLinkError.INVALID_STATUS |
Se arroja cuando el estado actual de la vinculación de datos no es válido para la operación solicitada. |
DataLinkError.INVALID_UPDATE_STATUS |
Se arroja cuando se intenta una transición de estado no admitida durante una actualización (por ejemplo, pasar directamente de REVOKED a ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
Se arroja cuando ya existe un vínculo de datos para el video. |