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. |
|
| Как отменить запрос | Чтобы отозвать запрос на связывание, используйте метод
DataLinkService.UpdateDataLink. Он позволяет изменить значение status в объекте
DataLink с REQUESTED на REVOKED. |
|
| Как отменить связь | Чтобы удалить связанное видео, используйте
DataLinkService.RemoveDataLink. |
|
| Сценарий 2 | Как получить приглашение | Используйте GoogleAdsService.Search или GoogleAdsService.SearchStream, чтобы запросить ресурс data_link. Чтобы найти запросы на связывание, которые нужно принять или отклонить, отфильтруйте данные по значению
status = PENDING_APPROVAL. |
| Как принять или отклонить запрос на связывание | Чтобы обновить статус DataLink, используйте метод
DataLinkService.UpdateDataLink. Чтобы принять запрос, укажите ENABLED, а чтобы отклонить – REJECTED. |
Получение сведений о ссылке
Для запроса ресурса 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 |
Ошибка возникает, если связь с данными для видео уже существует. |