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ć połączenia z kontem.
Łą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 API YouTube, aby uzyskać channel_id, na który chcesz wysłać prośbę o link do filmu, lub video_id filmu, do którego chcesz utworzyć link. video_id można też pobrać z adresu URL filmu, wyodrębniają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ść status parametru DataLink nie powinna być ustawiona. Serwer Google Ads API ustawi ją na 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 cofnąć prośbę o połączenie, użyj metody
DataLinkService.UpdateDataLink, zmieniając wartość status w
DataLink z REQUESTED na REVOKED. |
|
| Usuwanie linku | Aby usunąć połączony film, użyj
DataLinkService.RemoveDataLink. |
|
| 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, które możesz zaakceptować lub odrzucić. |
| Akceptowanie lub odrzucanie prośby o połączenie | Aby zaktualizować stan DataLink na ENABLED (zaakceptowano) lub REJECTED (odrzucono), użyj metody
DataLinkService.UpdateDataLink. |
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. |