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
Konto Google Ads można połączyć z kontem innej usługi na 2 sposoby.
Proces zapraszania
Z procesu zapraszania korzystaj, gdy masz dostęp administracyjny do konta Google Ads, ale nie do konta usługi. Ten proces działa w 2 scenariuszach:
- Chcesz połączyć te 2 konta i utworzyć zaproszenie dla administratora konta usługi. Administrator konta usługi akceptuje zaproszenie, aby zakończyć proces łą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 kończysz proces łączenia.
W tym scenariuszu użyj tych metod:
| Scenariusz | Działanie | Uwagi |
|---|---|---|
| Scenariusz 1 | Tworzenie zaproszenia | Aby utworzyć zaproszenie, użyj metody
ProductLinkInvitationService.CreateProductLinkInvitation. Nie należy ustawiać pola status obiektu
ProductLinkInvitation. 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 | Pobieranie zaproszenia | Aby wysłać zapytanie do zasobu product_link_invitation, użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream. Użyj filtra
status = PENDING_APPROVAL, aby zaakceptować lub odrzucić oczekujące zaproszenie. |
| Akceptowanie i odrzucanie zaproszenia | Użyj metody
ProductLinkInvitationService.UpdateProductLinkInvitation, aby zmienić stan
ProductLinkInvitation na ACCEPTED lub REJECTED. |
|
| Anulowanie zaproszenia | Użyj metody
ProductLinkInvitationService.RemoveProductLinkInvitation, aby unieważnić istniejący obiekt
ProductLinkInvitation. |
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 tego działania. |
ProductLinkInvitationError.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ć usługi ProductLinkService, aby bezpośrednio utworzyć aktywne połączenie. |
Proces łączenia bezpośredniego
Z bezpośredniego łączenia możesz korzystać, 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 element ProductLink. |
| Pobieranie aktywnych linków | Użyj
GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu
product_link. |
W tym przepływie pracy mogą wystąpić te typowe błędy:
| Kod błędu | Wyjaśnienie |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Podjęto próbę połączenia kont za pomocą procesu bezpośredniego linku, ale nie jest to obsługiwane z powodu braku uprawnień. Użytkownik powinien zamiast tego użyć ProductLinkInvitationService, aby przejść przez proces zapraszania.
|
ProductLinkError.INVITATION_EXISTS |
Nie można utworzyć połączenia, ponieważ istnieje już oczekujące zaproszenie. |
Pobieranie istniejących linków do produktów
Możesz pobrać wszystkie linki do produktów powiązane z Twoim kontem Google Ads, używając zapytania GAQL dotyczącego 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 wartości pola type zostaną wypełnione inne pola w zasobie product_link, co pozwoli uzyskać więcej informacji o połączeniu. 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 lub dostawcy danych.
Zmiany w: AccountLinkService
Jeśli używasz AccountLinkService do łączenia konta Google Ads z kontem innej usługi, musisz przenieść dotychczasową aplikację do jednego z wymienionych wcześniej przepływów pracy. W przypadku tych typów linków przestań używać AccountLinkService i zacznij używać ProductLinkService:
W przypadku ThirdPartyAppAnalyticsLinkIdentifier nadal używaj AccountLinkService.