Interfejs Google Ads API umożliwia łączenie kont Google Ads z kontami innych usług. Z tego przewodnika dowiesz się, jak używać interfejsu API do łączenia kont.
Sposoby łączenia kont
Łączenie konta Google Ads z kontem innej usługi może odbywać się na 2 sposoby.
Proces zapraszania
Użyj procesu zapraszania, jeśli masz dostęp administracyjny do konta Google Ads, ale nie do konta usługi. Ten proces działa w 2 przypadkach:
- Chcesz połączyć 2 konta i utworzyć zaproszenie dla administratora konta usługi. Administrator konta usługi akceptuje zaproszenie, aby zakończyć proces łączenia kont.
- Administrator konta usługi chce połączyć 2 konta, ale nie ma dostępu do konta Google Ads. Administrator konta usługi tworzy zaproszenie, a Ty je akceptujesz i kończysz proces łączenia.
W tym scenariuszu użyj tych metod:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Utwórz zaproszenie | Aby utworzyć zaproszenie, użyj metody
ProductLinkInvitationService.CreateProductLinkInvitation. Nie należy ustawiać status
elementu
ProductLinkInvitation. Serwer interfejsu Google Ads API
ustawi tę wartość na REQUESTED po pomyślnym zakończeniu
wywołania interfejsu API. Podczas tworzenia zaproszenia dla partnera reklamowego
(AdvertisingPartnerLinkInvitationIdentifier),
advertising_partner_properties.allowed_domain
jest wymagane od wersji 25 (w wersji 24 i wcześniejszych jest ono opcjonalne). |
| Sprawdź stan zaproszenia | Aby wysłać zapytanie do zasobu product_link_invitation
i sprawdzić jego stan, użyj GoogleAdsService.Search
lub GoogleAdsService.SearchStream. |
|
| Scenariusz 2 | Pobierz zaproszenie | Aby wysłać zapytanie do zasobu product_link_invitation
, użyj GoogleAdsService.Search
lub GoogleAdsService.SearchStream. Aby zaakceptować lub odrzucić
oczekujące zaproszenie, zastosuj filtr
status = PENDING_APPROVAL. |
| Zaakceptuj lub odrzuć zaproszenie | Aby zaktualizować stan elementu
ProductLinkInvitation na ACCEPTED lub
REJECTED, użyj metody
ProductLinkInvitationService.UpdateProductLinkInvitation. |
|
| Odwołaj zaproszenie | Aby odwołać istniejące
ProductLinkInvitation, użyj metody
ProductLinkInvitationService.RemoveProductLinkInvitation. |
W tym procesie mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Klient nie ma uprawnień do wykonania tej czynności. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
Nie można utworzyć zaproszenia, ponieważ użytkownik ma już dostęp administracyjny do zaproszonego konta. Użytkownik powinien użyć ProductLinkService, aby bezpośrednio utworzyć aktywne połączenie. |
Proces bezpośredniego łączenia
Użyj procesu bezpośredniego łączenia, jeśli masz dostęp administracyjny zarówno do konta Google Ads, jak i do konta usługi. W takim przypadku zamiast wysyłać zaproszenie, połącz bezpośrednio konto Google Ads z kontem usługi.
W tym scenariuszu użyj tych metod:
| Działanie | Uwagi |
|---|---|
| Utwórz aktywne połączenie | Aby utworzyć
ProductLinkService.CreateProductLink, użyj
ProductLink. |
| Wyłącz aktywne połączenie | Aby usunąć aktywne ProductLink, użyj
ProductLinkService.RemoveProductLink. |
| Pobierz aktywne połączenia | Aby wysłać zapytanie do zasobu
product_link, użyj
GoogleAdsService.Search lub
GoogleAdsService.SearchStream. |
W tym procesie mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Podjęto próbę połączenia konta za pomocą procesu bezpośredniego łączenia, ale nie jest to możliwe z powodu braku uprawnień. Użytkownik powinien zamiast tego użyć
ProductLinkInvitationService
do wykonania procesu zapraszania.
|
ProductLinkError.INVITATION_EXISTS |
Nie można utworzyć połączenia, ponieważ istnieje już oczekujące zaproszenie. |
Pobieranie istniejących połączeń z usługami
Możesz pobrać wszystkie połączenia z usługami powiązane z Twoim kontem Google Ads, używając
zapytania GAQL względem zasobu product_link.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
Pole product_link.type wskazuje typ połączonej usługi.
W zależności od wartości type zostaną wypełnione inne pola w zasobie product_link, które zawierają więcej informacji o połączeniu. Jeśli na przykład typ to DATA_PARTNER, pole data_partner będzie zawierać informacje o połączonym koncie dostawcy danych.
Dzięki temu możesz uzyskać listę usług zewnętrznych i kont usług połączonych bezpośrednio z Twoim kontem Google Ads, takich jak Merchant Center, Google Ads, partnerzy reklamowi czy dostawcy danych.
Zmiany w AccountLinkService
Jeśli używasz AccountLinkService do łączenia konta Google Ads z kontem innej
usługi, musisz przeprowadzić migrację dotychczasowej aplikacji do jednego z
procesów wymienionych wcześniej. W przypadku tych typów połączeń przeprowadź migrację z
AccountLinkService i użyj ProductLinkService:
W przypadku ThirdPartyAppAnalyticsLinkIdentifier nadal używaj
AccountLinkService.