Interfejs Google Ads API obsługuje łączenie filmów w YouTube z kontem Google Ads. Z tego przewodnika dowiesz się, jak używać interfejsu API do dodawania i usuwania połączeń na koncie.
Połącz filmy
Filmy można połączyć z kontem na 2 sposoby, w zależności od tego, kto rozpoczyna proces:
- Wysyłasz prośbę o połączenie filmu z Twoim kontem. W tym scenariuszu wysyłasz prośbę do twórcy, który musi ją zaakceptować, aby można było utworzyć połączenie z jego filmem. Możesz wycofać prośbę, która została rozszerzona, zanim zostanie zaakceptowana, a także usunąć połączony film po zaakceptowaniu prośby.
- Twórca filmu prosi o połączenie filmu z Twoim kontem Google Ads. Możesz zaakceptować lub odrzucić tę prośbę.
W każdym scenariuszu używane są te metody:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Pobieranie informacji o filmie z interfejsu API YouTube | Użyj interfejsu API YouTube, aby uzyskać channel_id, do którego chcesz wysłać prośbę o połączenie z filmem, oraz video_id filmu, który chcesz połączyć. video_id to 11-znakowy ciąg znaków, który można znaleźć w adresach URL filmów na YouTube (np. parametr v w www.youtube.com/watch?v=VIDEO_ID lub ścieżka w youtu.be/VIDEO_ID). |
| Utwórz prośbę o połączenie | Użyj metody
DataLinkService.CreateDataLink, aby utworzyć prośbę o połączenie, określając zarówno youtube_video.channel_id, jak i youtube_video.video_id, aby zidentyfikować film i powiązany z nim kanał. Od wersji 24 możesz też podać youtube_link_metadata.brand_channel_id, aby podać identyfikator połączonego kanału firmowego na YouTube i pomóc twórcom lepiej poznać Twoją markę.
Nie należy ustawiać pola status obiektu DataLink. Serwer interfejsu Google Ads API ustawi je na REQUESTED po pomyślnym zakończeniu wywołania interfejsu API. |
|
| Sprawdzanie stanu żądania | Aby wysłać zapytanie do zasobu data_link i sprawdzić jego
status, użyj GoogleAdsService.SearchStream lub GoogleAdsService.Search. |
|
| Anulowanie prośby | Użyj metody
DataLinkService.UpdateDataLink, aby wycofać prośbę o połączenie, zmieniając status zasobu
DataLink z REQUESTED na REVOKED. |
|
| Jak usunąć połączenie | Aby usunąć połączony film, użyj
DataLinkService.RemoveDataLink. |
|
| Scenariusz 2 | Pobieranie zaproszenia | Aby wysłać zapytanie do zasobu data_link, użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream. Aby znaleźć prośby o połączenie, które chcesz zaakceptować lub odrzucić, użyj filtra
status = PENDING_APPROVAL. |
| Akceptowanie i odrzucanie próśb o połączenie | Użyj metody
DataLinkService.UpdateDataLink, aby zaktualizować stan DataLink na ENABLED, aby zaakceptować prośbę, lub na REJECTED, aby ją odrzucić. |
Pobieranie szczegółów połączenia
Do wysyłania zapytań do zasobu data_link możesz używać GoogleAdsService.Search lub GoogleAdsService.SearchStream. To zapytanie pobiera szczegóły linków do filmów na YouTube, w tym identyfikator filmu na YouTube i identyfikator kanału:
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'
W tym przepływie pracy mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
DataLinkError.PERMISSION_DENIED |
Klient nie ma uprawnień do wykonania tego działania. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
Nie udało się utworzyć linku do filmu, ponieważ identyfikator filmu jest nieprawidłowy. |
DataLinkError.INVALID_STATUS |
Zgłaszany, gdy bieżący stan połączenia danych jest nieprawidłowy dla żądanej operacji. |
DataLinkError.INVALID_UPDATE_STATUS |
Występuje, gdy podczas aktualizacji próbujesz wykonać nieobsługiwaną zmianę stanu (np. przejść bezpośrednio ze stanu REVOKED do stanu ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
Zgłaszany, gdy link do danych filmu już istnieje. |