Interfejs Google Ads API obsługuje łączenie filmów w YouTube z kontem Google Ads. Z tego przewodnika dowiesz się, jak za pomocą interfejsu API dodawać i usuwać linki na koncie.
Łączenie filmów
Filmy można połączyć z kontem na 2 sposoby, w zależności od tego, kto rozpoczyna proces:
- Prosisz o połączenie filmu z Twoim kontem. W tym przypadku wysyłasz prośbę do twórcy, którą musi on zaakceptować, aby utworzyć połączenie z jego filmem. Możesz cofnąć prośbę, która została przedłużona, zanim zostanie zaakceptowana, a także usunąć połączony film po jego zaakceptowaniu.
- Twórca filmu prosi o połączenie jego filmu z Twoim kontem Google Ads. Możesz wtedy zaakceptować lub odrzucić prośbę.
W każdym scenariuszu stosowane są te metody:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Pobieranie informacji o filmie z interfejsu YouTube API | Użyj interfejsu YouTube API, aby uzyskać channel_id, na który chcesz wysłać prośbę o link do filmu, oraz video_id filmu, do którego chcesz utworzyć link. video_id to 11-znakowy ciąg znaków znajdujący się w adresach URL filmów na YouTube (np. parametr v w adresie www.youtube.com/watch?v=VIDEO_ID lub ścieżka w adresie youtu.be/VIDEO_ID). |
| Utwórz prośbę o połączenie | Aby utworzyć prośbę o link, użyj metody
DataLinkService.CreateDataLink. Określ w niej 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ż określić
youtube_link_metadata.brand_channel_id, aby podać identyfikator połączonego kanału marki w YouTube i pomóc twórcom
lepiej poznać Twoją markę.
Pola status w DataLink nie powinny być ustawione. Serwer interfejsu Google Ads API ustawi wartość REQUESTED po pomyślnym zakończeniu wywołania interfejsu API. |
|
| Sprawdzanie stanu prośby | Użyj GoogleAdsService.SearchStream lub GoogleAdsService.Search, aby wysłać zapytanie do zasobu data_link i sprawdzić jego
status. |
|
| Anulowanie prośby | Aby wycofać prośbę o połączenie, użyj metody
DataLinkService.UpdateDataLink i zmień wartość status w elemencie
DataLink z REQUESTED na REVOKED. |
|
| Usuwanie linku | Użyj
DataLinkService.RemoveDataLink, aby usunąć połączony film. |
|
| Scenariusz 2 | Odzyskiwanie zaproszenia | Użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu data_link. Filtruj według
status = PENDING_APPROVAL, aby znaleźć prośby o połączenie
do zaakceptowania lub odrzucenia. |
| Akceptowanie i odrzucanie próśb o połączenie | Aby zaktualizować stan elementu DataLink na ENABLED (zaakceptowano) lub REJECTED (odrzucono), użyj metody
DataLinkService.UpdateDataLink. |
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 zadań mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
DataLinkError.PERMISSION_DENIED |
Klient nie ma uprawnień do wykonania tej czynności. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
Nie udało się utworzyć linku do filmu, ponieważ identyfikator filmu jest nieprawidłowy. |
DataLinkError.INVALID_STATUS |
Wywoływany, gdy bieżący stan połączenia danych jest nieprawidłowy dla żądanej operacji. |
DataLinkError.INVALID_UPDATE_STATUS |
Wyjątek zgłaszany podczas próby przejścia do nieobsługiwanego stanu w trakcie aktualizacji (np. bezpośredniego przejścia ze stanu REVOKED do stanu ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
Wyjątek zgłaszany, gdy link do danych filmu już istnieje. |