Łączenie kont usług

Interfejs Google Ads API umożliwia łączenie kont Google Ads z innymi kontami usług. Z tego przewodnika dowiesz się, jak używać interfejsu API do łączenia kont.

Podczas łączenia konta Google Ads z innym kontem usługi można to zrobić na 2 sposoby.

Proces zapraszania

Proces zapraszania jest używany, gdy masz dostęp administracyjny do konta Google Ads, ale nie do konta usługi. Ten proces działa w 2 przypadkach:

  1. 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.
  2. 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żywane są te metody:

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.
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 zmienić 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.
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 bezpośredniego łączenia

Proces bezpośredniego łączenia jest używany, gdy masz dostęp administracyjny zarówno do konta Google Ads, jak i do konta usługi. W takim przypadku możesz bezpośrednio połączyć konto Google Ads z kontem usługi, zamiast wysyłać zaproszenie.

W tym scenariuszu używane są te metody:

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.

Możesz pobrać wszystkie połączenia z usługami powiązane z Twoim kontem Google Ads, używając zapytania GAQL do 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 THIRD_PARTY_APP_ANALYTICS, pole third_party_app_analytics będzie zawierać informacje o dostawcy analityki.

Dzięki temu możesz uzyskać listę usług i aplikacji zewnętrznych połączonych bezpośrednio z Twoim kontem Google Ads, takich jak Google Play, partnerzy danych czy platformy analityczne aplikacji innych firm.

Zmiany w AccountLinkService

Jeśli używasz AccountLinkService do łączenia konta Google Ads z innym kontem 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:

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

W przypadku ThirdPartyAppAnalyticsLinkIdentifier nadal używaj AccountLinkService.

Wstecz
Zarządzanie zaproszeniami użytkowników
Dalej
Link do YouTube