Interfejs Google Ads API obsługuje łączenie kont Google Ads z kontami innych usług. Z tego przewodnika dowiesz się, jak połączyć konta za pomocą interfejsu API.
Sposoby łączenia kont
Podczas łączenia konta Google Ads z kontem innej usługi możesz wybrać 1 z 2 sposobów połączenia.
Proces zapraszania
Proces zaproszenia jest używany, gdy masz dostęp administracyjny do konta Google Ads, ale nie do konta usługi. Ten proces działa w 2 sposobach:
- Chcesz połączyć 2 konta i utworzyć zaproszenie dla administratora konta usługi. Administrator konta usługi akceptuje zaproszenie, aby dokończyć proces łączenia kont.
- Administrator konta usługi chce połączyć te 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 | Tworzenie zaproszenia | Aby utworzyć zaproszenie, użyj metody
ProductLinkInvitationService.CreateProductLinkInvitation. Wartość parametru status
ProductLinkInvitation nie powinna być ustawiona. Po pomyślnym zakończeniu wywołania interfejsu API serwer Google Ads API ustawi ją na REQUESTED. |
| Sprawdzanie stanu zaproszenia | Użyj metody GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu product_link_invitation i sprawdzić jego stan. |
|
| Scenariusz 2 | Pobieranie zaproszenia | Użyj zapytania GoogleAdsService.Search
lub GoogleAdsService.SearchStream
do zapytania o zasób product_link_invitation. Filtruj według
status = PENDING_APPROVAL, aby zaakceptować lub odrzucić oczekujące zaproszenie. |
| Akceptowanie i odrzucanie zaproszeń | Użyj metody
ProductLinkInvitationService.UpdateProductLinkInvitation, aby zaktualizować stan
ProductLinkInvitation na ACCEPTED lub
REJECTED. |
|
| Unieważnienie zaproszenia | Aby cofnąć istniejące uprawnienia
ProductLinkInvitation, użyj metody
ProductLinkInvitationService.RemoveProductLinkInvitation. |
W tym przepływie pracy 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 udało się utworzyć zaproszenia, ponieważ użytkownik ma już dostęp administracyjny do zaproszonego konta. Użytkownik powinien użyć ProductLinkService, aby bezpośrednio utworzyć aktywny link. |
Proces bezpośredniego łączenia
Proces bezpośredniego łączenia jest używany, gdy masz dostęp administracyjny do konta Google Ads i konta usługi. W takim przypadku zamiast wysyłać zaproszenie połączysz konto Google Ads bezpośrednio z kontem usługi.
W tym scenariuszu używane są te metody:
| Działanie | Uwagi |
|---|---|
| Tworzenie aktywnego linku | Użyj aplikacji
ProductLinkService.createProductLink, aby utworzyć
ProductLink. |
| Wyłączanie aktywnego linku | Aby usunąć aktywny
ProductLinkService.removeProductLink, użyj ProductLink. |
| Pobieranie aktywnych linków | Aby wysłać zapytanie do zasobu
product_link, użyj parametru
GoogleAdsService.Search lub GoogleAdsService.SearchStream. |
W tym procesie mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Próbowano połączyć konta za pomocą bezpośredniego procesu łączenia, ale nie jest on obsługiwany z powodu braku uprawnień. Użytkownik powinien użyć kodu ProductLinkInvitationService, aby przejść proces zaproszenia.
|
ProductLinkError.INVITATION_EXISTS |
Nie można utworzyć linku, ponieważ istnieje już oczekujące zaproszenie. |
Zmiany w usłudze AccountLinkService
Jeśli używasz AccountLinkService do łączenia konta Google Ads z kontem innego produktu, musisz przenieść dotychczasową aplikację do jednego z wymienionych wcześniej procesów. W przypadku tych typów linków zrezygnuj z użycia AccountLinkService i użyj ProductLinkService:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
W przypadku ThirdPartyAppAnalyticsLinkIdentifier nadal używaj AccountLinkService.