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