Ссылка на 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 для создания запроса на ссылку. status DataLink не должен быть установлен; сервер API Google Ads установит его в 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 для отклонения запроса.

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

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