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ń z kontem.
Linkowanie 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 scenariuszu wysyłasz prośbę do twórcy, którą musi on zaakceptować, aby utworzyć połączenie z jego filmem. Możesz wycofać prośbę, której termin został przedłużony, zanim została zaakceptowana, 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, aby sprawdzić jego statusGoogleAdsService.SearchStream. | |
| 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 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ć prośbę, lub REJECTED, aby ją odrzucić. |
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. |