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
Połączenie konta Google Ads z kontem innej usługi może nastąpić na 2 różne 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 sytuacjach:
- Chcesz połączyć te 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żyj tych metod:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Tworzenie zaproszenia | Użyj metody
ProductLinkInvitationService.CreateProductLinkInvitation, aby utworzyć zaproszenie. Pola status w
ProductLinkInvitation nie należy ustawiać. Serwer interfejsu Google Ads API ustawi je na REQUESTED po pomyślnym zakończeniu wywołania interfejsu API. Podczas tworzenia zaproszenia dla partnera reklamowego (AdvertisingPartnerLinkInvitationIdentifier) od wersji 25 wymagany jest parametr advertising_partner_properties.allowed_domain (w wersji 24 i starszych jest on opcjonalny). |
| 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 | Odzyskiwanie zaproszenia | Użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu 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 konta
ProductLinkInvitation na ACCEPTED lub REJECTED. |
|
| Cofanie zaproszenia | Użyj metody
ProductLinkInvitationService.RemoveProductLinkInvitation, aby
cofnąć istniejący
ProductLinkInvitation. |
W tym przepływie zadań 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ć usługi ProductLinkService, aby bezpośrednio utworzyć aktywny link. |
Proces łączenia bezpośredniego
Użyj bezpośredniego połączenia, jeśli masz dostęp administracyjny zarówno do konta Google Ads, jak i do konta usługi. W takim przypadku połącz bezpośrednio konto Google Ads z kontem usługi, zamiast wysyłać zaproszenie.
W tym scenariuszu użyj tych metod:
| Działanie | Uwagi |
|---|---|
| Tworzenie aktywnego linku | Użyj
ProductLinkService.CreateProductLink, aby utworzyć ProductLink. |
| Wyłączanie aktywnego linku | Użyj
ProductLinkService.RemoveProductLink, aby usunąć
aktywny
ProductLink. |
| Pobieranie aktywnych linków | Użyj
GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu
product_link. |
W tym przepływie zadań mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Próbowano połączyć konta za pomocą przepływu bezpośredniego linku, ale nie jest to obsługiwane z powodu braku uprawnień. Zamiast tego użytkownik powinien użyć ProductLinkInvitationService.
|
ProductLinkError.INVITATION_EXISTS |
Nie można utworzyć linku, ponieważ istnieje już oczekujące zaproszenie. |
Pobieranie istniejących linków do produktów
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łączonego produktu lub usługi.
W zależności od type zostaną wypełnione inne pola w zasobie product_link, które zawierają więcej szczegółów o linku. 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 partnerzy ds. danych.
Zmiany w AccountLinkService
Jeśli do połączenia konta Google Ads z innym kontem usługi używasz AccountLinkService, musisz przenieść dotychczasową aplikację do jednego z wymienionych wcześniej procesów. W przypadku tych typów linków zmigruj z AccountLinkService i użyj ProductLinkService:
W przypadku ThirdPartyAppAnalyticsLinkIdentifier nadal korzystaj z AccountLinkService.