Google Ads API позволяет связывать видео на YouTube с аккаунтом Google Рекламы. В этом руководстве рассказывается, как добавлять и удалять ссылки на аккаунт с помощью API.
Как связать видео
Видео можно связать с аккаунтом двумя способами в зависимости от того, кто начинает процесс:
- Вы отправляете запрос на связывание видео с вашим аккаунтом. В этом случае вы отправляете автору запрос, который он должен принять, чтобы установить связь с видео. Вы можете отозвать запрос на продление до того, как он будет принят, а также удалить связанное видео после того, как запрос будет принят.
- Автор видео запросил связь с вашим аккаунтом Google Рекламы. а затем примите или отклоните его.
В каждом сценарии используются следующие методы:
| Сценарий | Действие | Примечания |
|---|---|---|
| Сценарий 1 | Получение информации о видео с помощью YouTube API | Используйте YouTube API, чтобы получить channel_id, на который нужно отправить запрос ссылки на видео, и video_id видео, на которое вы хотите добавить ссылку. video_id – это строка из 11 символов, которая встречается в URL видео на YouTube (например, параметр v в www.youtube.com/watch?v=VIDEO_ID или путь в youtu.be/VIDEO_ID). |
| Создать запрос на связывание | Чтобы создать запрос на связывание, используйте метод
DataLinkService.CreateDataLink, указав youtube_video.channel_id и youtube_video.video_id
для идентификации видео и связанного с ним канала. Начиная с версии 24, вы также можете указать элемент youtube_link_metadata.brand_channel_id, чтобы предоставить идентификатор связанного канала бренда на YouTube и помочь авторам понять, что это за бренд.
Поле status объекта DataLink не должно быть задано. Сервер Google Ads API установит для него значение REQUESTED после успешного выполнения вызова API. |
|
| Как проверить статус запроса | Используйте GoogleAdsService.SearchStream или GoogleAdsService.Search, чтобы запросить ресурс data_link и проверить его
status. |
|
| Как отменить запрос | Чтобы отозвать запрос на установление связи, измените status объекта
DataLink с REQUESTED на REVOKED с помощью метода
DataLinkService.UpdateDataLink. |
|
| Как удалить ссылку | Используйте
DataLinkService.RemoveDataLink, чтобы удалить связанное видео. |
|
| Сценарий 2 | Как получить приглашение | Используйте GoogleAdsService.Search
или GoogleAdsService.SearchStream
для запроса ресурса data_link. Отфильтруйте запросы по значению
status = PENDING_APPROVAL, чтобы найти запросы на связывание, которые нужно принять или отклонить. |
| Как принять или отклонить запрос на связывание | Чтобы изменить статус DataLink на ENABLED (принять запрос) или REJECTED (отклонить запрос), используйте метод
DataLinkService.UpdateDataLink. |
Как получить сведения о связи
Для запроса к ресурсу data_link можно использовать GoogleAdsService.Search или GoogleAdsService.SearchStream. Следующий запрос позволяет получить сведения о ссылках на видео 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 |
Не удалось создать ссылку на видео, так как идентификатор видео недействителен. |
DataLinkError.INVALID_STATUS |
Исключение, возникающее, когда текущий статус связи с данными недопустим для запрошенной операции. |
DataLinkError.INVALID_UPDATE_STATUS |
Возникает при попытке выполнить недопустимый переход статуса во время обновления (например, напрямую из REVOKED в ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
Исключение, возникающее, когда связь с данными для видео уже существует. |