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 una de estas 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 aceptarla 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 vínculo del video o el video_id
del video que deseas vincular. El video_id también se puede extraer
de la URL de un video tomando los 11 caracteres después de "v=". |
| Crea una solicitud de vinculación | Usa el
DataLinkService.CreateDataLink método
para crear una solicitud de vinculación. De manera opcional, puedes especificar el
youtube_video.channel_id para identificar explícitamente el canal
asociado con el video y el youtube_link_metadata.brand_channel_id
para especificar el ID del canal de marca de YouTube vinculado para 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. |
|
| Cómo revocar una solicitud | Usa el
DataLinkService.UpdateDataLink método
para revocar una solicitud de vinculación cambiando 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 | 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 vínculos
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 canal de YouTube y el ID del canal de marca de YouTube vinculado.
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_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. |