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 . При желании вы можете указать 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 | Не удалось создать ссылку на видео, поскольку идентификатор видео недействителен. |