Interfejs Google Ads API obsługuje łączenie kont Google Ads z kontami innych usług. Z tego przewodnika dowiesz się, jak używać interfejsu API w wersji 16 do łączenia kont.
Sposoby łączenia kont
Konto Google Ads możesz połączyć z innym kontem usługi na 2 sposoby.
Proces zapraszania
Przepływ zaproszeń 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:
- Chcesz połączyć oba konta i utworzyć zaproszenie dla administratora konta usługi. Administrator konta usługi zaakceptuje 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 dokończysz proces łączenia.
W tym scenariuszu stosuje się te metody:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Utwórz zaproszenie | Użyj metody
ProductLinkInvitationService.CreateProductLinkInvitation, aby utworzyć zaproszenie. Właściwość status właściwości
ProductLinkInvitation nie powinna być ustawiona. Serwer interfejsu Google Ads API ustawi ją na REQUESTED po pomyślnym zakończeniu wywołania interfejsu API. |
| Sprawdzanie stanu zaproszenia | Użyj narzędzia GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu product_link_invitation i sprawdzić jego stan. |
|
| Scenariusz 2 | Pobieranie zaproszenia | Użyj narzędzia 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
ProductLinkInvitation na ACCEPTED lub REJECTED. |
|
| Unieważnianie zaproszenia | Aby unieważnić istniejącą
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 bezpośrednio utworzyć aktywne połączenie za pomocą usługi ProductLinkService. |
Proces łączenia bezpośredniego
Proces łączenia bezpośredniego jest używany, gdy masz dostęp administracyjny do konta Google Ads i konta usługi. W takim przypadku musisz połączyć konto Google Ads z kontem usługi bezpośrednio, zamiast wysyłać zaproszenie.
W tym scenariuszu stosuje się te metody:
| Działanie | Uwagi |
|---|---|
| Utwórz aktywny link | Użyj narzędzia
ProductLinkService.createProductLink, aby utworzyć ProductLink. |
| Wyłączanie aktywnego linku | Użyj
ProductLinkService.removeProductLink, aby usunąć aktywną ProductLink. |
| Pobierz 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ń. Aby to zrobić, użytkownik powinien użyć narzędzia ProductLinkInvitationService.
|
ProductLinkError.INVITATION_EXISTS |
Nie można utworzyć linku, ponieważ istnieje już oczekujące zaproszenie. |
Zmiany w usługach AccountLinkService i MerchantCenterLinkService
Jeśli korzystasz w przeszłości z MerchantCenterLinkService lub AccountLinkService do połączenia konta Google Ads z innym kontem usługi, musisz przenieść istniejącą aplikację do jednego z przepływów pracy wymienionych wcześniej. Stan migracji znajdziesz w tej tabeli:
| Rodzaj linku | Obsługiwane w nowych usługach? | Pomoc 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 korzystaj z usługi AccountLinkService |