Interfejs Google Ads API umożliwia łą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ń z kontem.
Linkowanie filmów
Filmy można połączyć z kontem na 2 sposoby, w zależności od tego, kto rozpoczyna proces:
- Prośba o połączenie filmu z Twoim kontem. W tym scenariuszu wysyłasz prośbę do twórcy, którą musi on zaakceptować, aby utworzyć połączenie z jego filmem. Możesz wycofać przedłużone żądanie przed jego zaakceptowaniem, a także usunąć powiązany film po jego zaakceptowaniu.
- Twórca filmu prosi o połączenie go z Twoim kontem Google Ads. Możesz zaakceptować lub odrzucić jego prośbę.
W każdym scenariuszu używane są te metody:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Pobieranie informacji o filmie z interfejsu YouTube API | Użyj interfejsu API YouTube, aby uzyskać channel_id, do którego wysłać prośbę o link do filmu, lub video_id filmu, do którego chcesz dodać link. Wartość video_id można też pobrać z adresu URL filmu, kopiując 11 znaków po "v=". |
| Utwórz prośbę o połączenie | Aby utworzyć prośbę o połączenie, użyj metody
DataLinkService.CreateDataLink. Wartość parametru statusDataLink nie powinna być ustawiona. Po pomyślnym zakończeniu wywołania interfejsu API serwer Google Ads API ustawi go na REQUESTED. |
|
| Sprawdzanie stanu prośby | Aby wysłać zapytanie do zasobu data_linkGoogleAdsService.SearchStream lub GoogleAdsService.Search, użyj metody
status. |
|
| Unieważnia prośby | Aby wycofać prośbę o połączenie, użyj metody
DataLinkService.UpdateDataLink, zmieniając wartość status parametru
DataLink z REQUESTED na REVOKED. |
|
| Usuwanie linku | Aby usunąć połączony film, kliknij
DataLinkService.RemoveDataLink. |
|
| Scenariusz 2 | Pobieranie zaproszenia | Użyj zapytania GoogleAdsService.Search
lub GoogleAdsService.SearchStream
do zapytania o zasób data_link. Aby znaleźć prośby o połączenie, które możesz zaakceptować lub odrzucić, przefiltruj listę
status = PENDING_APPROVAL. |
| Akceptowanie i odrzucanie próśb o połączenie | Użyj metody
DataLinkService.UpdateDataLink, aby zaktualizować stan DataLink
ENABLED, aby zaakceptować, lub REJECTED, aby odrzucić prośbę. |
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 tej czynności. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
Nie udało się utworzyć linku do filmu, ponieważ identyfikator filmu jest nieprawidłowy. |