Ссылка на YouTube

API Google Ads поддерживает привязку видеороликов YouTube к вашему аккаунту Google Ads. В этом руководстве объясняется, как использовать API для добавления и удаления ссылок на ваш аккаунт.

Ссылки на видео

Видео можно привязать к вашему аккаунту двумя способами, в зависимости от того, кто инициирует процесс:

1. Вы запрашиваете привязку видео к своему аккаунту. В этом случае вы отправляете запрос автору, который должен его принять, чтобы установить связь со своим видео. Вы можете отозвать запрос, отправленный до его принятия, а также удалить связанное видео после его принятия.
2. Создатель видеоролика просит связать его с вашим аккаунтом Google Ads. Затем вы можете принять или отклонить его запрос.

В каждом сценарии используются следующие методы:

Сценарий	Действие	Примечания
Сценарий 1	Получите информацию о видео из API YouTube.	Используйте API YouTube , чтобы получить channel_id , на который нужно отправить запрос на ссылку на видео, или video_id видео, на которое вы хотите сослаться. video_id также можно получить из URL-адреса видео, взяв 11 символов после "v=" .
	Создать запрос на добавление ссылки	Для создания запроса на ссылку используйте метод DataLinkService.CreateDataLink . При желании вы можете указать youtube_video.channel_id , чтобы явно идентифицировать канал, связанный с видео. status DataLink не должен быть установлен; сервер Google Ads API установит его в значение REQUESTED после успешного завершения вызова API.
	Проверьте статус запроса.	Используйте GoogleAdsService.SearchStream или GoogleAdsService.Search для запроса ресурса data_link и проверки его status .
	Отозвать запрос	Используйте метод DataLinkService.UpdateDataLink , чтобы отозвать запрос на создание ссылки, изменив status DataLink с REQUESTED на REVOKED .
	Удалить ссылку	Используйте DataLinkService.RemoveDataLink для удаления связанного видео.
Сценарий 2	Получить приглашение	Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream для запроса ресурса data_link . Отфильтруйте результаты по status = PENDING_APPROVAL , чтобы найти запросы на добавление или отклонение ссылок.
	Принять или отклонить запрос на размещение ссылки	Используйте метод DataLinkService.UpdateDataLink , чтобы изменить статус DataLink на ENABLED (принять) или REJECTED отклонить) (отклонить запрос).

Получить подробную информацию о ссылке

Для запроса ресурса data_link можно использовать GoogleAdsService.Search или GoogleAdsService.SearchStream . Следующий запрос извлекает подробную информацию о ссылках на видео YouTube, включая идентификатор канала 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'

В этом рабочем процессе могут возникать следующие распространенные ошибки:

Код ошибки	Объяснение
DataLinkError.PERMISSION_DENIED	У клиента нет разрешения на выполнение этого действия.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Не удалось создать ссылку на видео, поскольку идентификатор видео недействителен.