Interfejs Google Ads API obsługuje łączenie kont Google Ads z kontami w innych usługach. Z tego przewodnika dowiesz się, jak używać interfejsu API w wersji 16 do łączenia kont.
Sposoby łączenia kont
Gdy łączysz konto Google Ads z kontem innej usługi, możesz to zrobić na 2 sposoby.
Proces zapraszania
Proces zaproszenia jest używany, gdy masz dostęp administracyjny do konta Google Ads, ale nie do konta usługi. Działa to w 2 sytuacjach:
- Chcesz połączyć oba konta i utworzyć zaproszenie dla administratora konta usługi. Administrator konta usługi akceptuje zaproszenie do ukończenia procesu łączenia kont.
- Administrator konta usługi chce połączyć oba konta, ale nie ma dostępu do konta Google Ads. Administrator konta usługi tworzy zaproszenie, a Ty je akceptujesz i wykonujesz proces łączenia kont.
W tym scenariuszu używa się tych metod:
Scenariusz | Działanie | Uwagi |
---|---|---|
Scenariusz 1 | Utwórz zaproszenie | Aby utworzyć zaproszenie, użyj metody
ProductLinkInvitationService.CreateProductLinkInvitation . Nie należy ustawić status elementu
ProductLinkInvitation . Serwer interfejsu Google Ads API ustawi tę wartość na REQUESTED po pomyślnym zakończeniu wywołania interfejsu API. |
Sprawdzanie stanu zaproszenia | Użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream , aby wysłać zapytanie do zasobu product_link_invitation i sprawdzić jego stan. |
|
Scenariusz 2 | Pobierz zaproszenie | Użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream , aby wysłać zapytanie do zasobu product_link_invitation . Użyj filtra
status = PENDING_APPROVAL , aby zaakceptować lub odrzucić oczekujące zaproszenie. |
Akceptowanie i odrzucanie zaproszenia | Użyj metody
ProductLinkInvitationService.UpdateProductLinkInvitation , aby zaktualizować stan elementu
ProductLinkInvitation na ACCEPTED lub REJECTED . |
|
Unieważnianie zaproszenia | Aby unieważnić istniejący
ProductLinkInvitation , użyj metody
ProductLinkInvitationService.RemoveProductLinkInvitation . |
W tym przepływie pracy mogą pojawiać się te typowe błędy:
Kod błędu | Wyjaśnienie |
---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Klient nie ma uprawnień do wykonania tej czynności. |
ProductLinkError.NO_INVITATION_REQUIRED |
Nie można utworzyć zaproszenia, ponieważ użytkownik ma już dostęp administracyjny do zaproszonego konta. Użytkownik powinien użyć usługi ProductLinkService, aby bezpośrednio utworzyć aktywne połączenie. |
Proces łączenia bezpośredniego
Łączenie bezpośrednie jest używane, gdy masz dostęp administracyjny do konta Google Ads i konta usługi. W takim przypadku musisz połączyć konto Google Ads bezpośrednio z kontem usługi, zamiast wysyłać zaproszenie.
W tym scenariuszu używa się tych metod:
Działanie | Uwagi |
---|---|
Utwórz aktywny link | Użyj
ProductLinkService.createProductLink , aby utworzyć ProductLink . |
Wyłączanie aktywnego linku | Użyj
ProductLinkService.removeProductLink , aby usunąć aktywny ProductLink . |
Pobieraj aktywne linki | Użyj
GoogleAdsService.Search lub GoogleAdsService.SearchStream , aby wysłać zapytanie do zasobu
product_link . |
W tym przepływie pracy mogą pojawiać się te typowe błędy:
Kod błędu | Wyjaśnienie |
---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Podjęto próbę połączenia kont za pomocą procesu łączenia bezpośredniego, ale nie jest to obsługiwane ze względu na brak uprawnień. Zamiast tego użytkownik powinien użyć instancji ProductLinkInvitationService , aby wykonać proces zaproszenia.
|
ProductLinkError.INVITATION_EXISTS |
Nie można utworzyć linku, ponieważ istnieje już oczekujące zaproszenie. |
Zmiany w usługach AccountLinkService i MerchantCenterLinkService
Jeśli w przeszłości zdarzyło Ci się korzystać z usługi MerchantCenterLinkService lub AccountLinkService do połączenia konta Google Ads z innym kontem usługi, musisz przenieść swoją istniejącą aplikację do jednego z wymienionych wcześniej przepływów pracy. Stan migracji możesz sprawdzić w tej tabeli:
Rodzaj linku | Obsługa w nowych usługach? | Pomoc jest dostępna od | Uwagi |
---|---|---|---|
DataPartnerIdentifier |
Tak | v15 | Migracja z MerchantCenterLinkService |
GoogleAdsIdentifier |
Tak | v16 | Migracja z usługi AccountLinkService |
MerchantCenterIdentifier |
Tak | v16 | Migracja z usługi AccountLinkService |
AdvertisingPartnerIdentifier |
Tak | v16 | Migracja z usługi AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
Nie | – | Nadal używaj usługi AccountLinkService |