API Google Ads поддерживает привязку видео YouTube к вашему аккаунту Google Ads. В этом руководстве объясняется, как использовать API для добавления и удаления ссылок на ваш аккаунт.
Ссылки на видео
Видео можно привязать к вашей учетной записи двумя способами, в зависимости от того, кто инициировал процесс:
- Вы запрашиваете привязку видео к вашему аккаунту. В этом случае вы отправляете запрос создателю, который он должен принять, чтобы установить ссылку на своё видео. Вы можете отозвать запрос, продленный до его одобрения, а также удалить связанное видео после его одобрения.
- Создатель видео запрашивает привязку своего видео к вашему аккаунту 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 | Не удалось создать ссылку на видео, так как идентификатор видео недействителен. |