Vincular YouTube

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:

1. 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.
2. 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.