API Google Рекламы поддерживает привязку видео YouTube к вашему аккаунту Google Рекламы. В этом руководстве объясняется, как использовать API для добавления и удаления ссылок на вашу учетную запись.
Связать видео
Видео можно связать с вашей учетной записью одним из двух способов, в зависимости от того, кто запускает процесс:
- Вы запрашиваете, чтобы видео было связано с вашей учетной записью. В этом сценарии вы отправляете создателю запрос, который он должен принять, чтобы установить ссылку на свое видео. Вы можете отозвать запрос, который был продлен до его принятия, а также удалить связанное видео после его принятия.
- Создатель видео просит связать его видео с вашим аккаунтом Google Рекламы. Затем вы можете принять или отклонить их запрос.
В каждом сценарии используются следующие методы:
| Сценарий | Действие | Примечания |
|---|---|---|
| Сценарий 1 | Получите информацию о видео из API YouTube. | Используйте API YouTube , чтобы получить channel_id для отправки запроса на ссылку на видео или video_id видео, на которое вы хотите связать ссылку. video_id также можно получить из URL-адреса видео, потянув 11 символов после "v=" . |
| Создать запрос на ссылку | Используйте метод DataLinkService.CreateDataLink , чтобы создать запрос на связывание. status DataLink не должен быть установлен; Сервер API Google Рекламы установит для этого 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 | Не удалось создать ссылку на видео, поскольку идентификатор видео недействителен. |