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, que debe aceptar para establecer el vínculo a 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 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 | 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 vinculación 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 en youtu.be/VIDEO_ID). |
| Crea una solicitud de vinculación. | Usa el
DataLinkService.CreateDataLink método
para crear una solicitud de vinculación, especificando tanto
youtube_video.channel_id como 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 configurar el status
de DataLink. El servidor de la API de Google Ads lo establecerá en REQUESTED cuando se complete correctamente la llamada a la API. |
|
| Inspecciona el estado de una solicitud. | Usa GoogleAdsService.SearchStream o GoogleAdsService.Search para consultar el recurso data_link
y revisar su
status. |
|
| Revoca una solicitud. | Usa el
DataLinkService.UpdateDataLink método
para revocar una solicitud de vinculación cambiando el status de
DataLink de REQUESTED a REVOKED. |
|
| Quita 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 puedas aceptar o rechazar. |
| Acepta o rechaza una solicitud de vinculación. | Usa el
DataLinkService.UpdateDataLink método para actualizar el estado
de la DataLink
a ENABLED para aceptar o REJECTED para rechazar la
solicitud. |
Cómo recuperar detalles de la vinculación
Puedes usar GoogleAdsService.Search
o
GoogleAdsService.SearchStream
para consultar el recurso data_link. La siguiente consulta recupera detalles de los vínculos de videos de YouTube, incluidos el ID del video y el ID del canal de YouTube:
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 de video, ya que el ID del video no es válido. |
DataLinkError.INVALID_STATUS |
Se genera cuando el estado actual del vínculo de datos no es válido para la operación solicitada. |
DataLinkError.INVALID_UPDATE_STATUS |
Se genera 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 genera cuando ya existe un vínculo de datos para el video. |