Za pomocą interfejsu Accounts API możesz zarządzać relacjami między kontem Merchant Center a innymi dostawcami usług. Relacja to formalne połączenie, które umożliwia dostawcy oferowanie określonych usług Twojej firmie. Usługa określa uprawnienia i możliwości przyznane dostawcy, takie jak zarządzanie produktami lub kampaniami. Na przykład połączenie konta Merchant Center z kontem Google Ads umożliwia temu ostatniemu wykorzystywanie danych o produktach do prowadzenia kampanii reklamowych.
Relacja składa się z tych atrybutów:
- Konto Merchant Center, które otrzymuje usługę
- Dostawca usług
- usługę lub zestaw usług świadczonych na rzecz konta Merchant Center;
Usługodawcy mogą powiązać alias z kontami, które obsługują (jest to odpowiednik pola seller_id
, które było obecne w zasobie konto w interfejsie Content API for Shopping). Alias można przypisać za pomocą opcjonalnego pola account_id_alias
w zasobie AccountRelationship
. Służy on jako identyfikator niestandardowy.
Struktura adresu URL umożliwiającego dostęp do konta przy użyciu jego aliasu to:GET /accounts/v1/accounts/{provider}~{account_id_alias}
Usługi
W interfejsie Accounts API konta mogą korzystać z tych usług:
Agregacja kont: modeluje relację między zaawansowanym kontem a kontami, którym świadczy usługi. Usługodawca (konto zaawansowane) uzyskuje pełny, nieograniczony dostęp do połączonych kont podrzędnych. W tym przypadku
externalAccountId
to identyfikator konta Merchant Center. Podczas tworzenia subkonta należy pominąć znakexternalAccountId
, ponieważ zostanie on przypisany do identyfikatora konta podczas jego tworzenia.Zarządzanie kampaniami: ta usługa modeluje połączenie między kontem Merchant Center a kontem Google Ads, dzięki czemu konto Google Ads ma dostęp do danych o produktach i kontach potrzebnych do prowadzenia kampanii reklamowych. Dostawcą usług w tym przypadku jest
GOOGLE_ADS
, aexternalAccountId
to identyfikator konta Google Ads.Porównywanie cen: oznacza to relację z usługą porównywania cen, która obsługuje konto Merchant Center.
Zarządzanie informacjami o firmie w Google: oznacza to relację z menedżerem sklepu w zakresie zarządzania lokalnym asortymentem i informacjami o firmie za pomocą profilu firmy w Google.
Zarządzanie kontem: ta usługa umożliwia dostawcy wykonywanie czynności administracyjnych na koncie Merchant Center, takich jak konfigurowanie ustawień konta, zarządzanie użytkownikami czy aktualizowanie informacji o firmie. Firma może też ograniczyć przyznany dostęp.
Zarządzanie produktami: ta usługa umożliwia dostawcom zarządzanie produktami i powiązanymi funkcjami, takimi jak źródła danych i reguły.
Uścisk dłoni
Aby nawiązać połączenie z usługą, zarówno konto, które ją udostępnia, jak i konto, które z niej korzysta, muszą autoryzować połączenie. Ten proces autoryzacji nazywa się uzgadnianiem połączenia.
Uścisk dłoni to proces dwuetapowy:
- Jedna ze stron proponuje link do usługi.
- Druga strona zatwierdza lub odrzuca propozycję.
Po zaakceptowaniu oferty usługa zostaje zatwierdzona i uznana za w pełni utworzoną. Wszelkie prawa dostępu przyznane dostawcy usług są teraz przyznawane kwalifikującym się użytkownikom (patrz prawa dostępu poniżej).
Pamiętaj, że użytkownik, który tworzy propozycję, odrzuca ją lub zatwierdza, musi mieć ADMIN
prawa dostępu do konta, na którym rozpoczyna się proces. Jeśli więc usługodawca proponuje usługę, użytkownik składający propozycję musi być ADMIN
na koncie usługodawcy, a użytkownik akceptujący lub odrzucający propozycję musi być ADMIN
na koncie odbiorcy.
Sposób działania protokołu handshake w poszczególnych usługach
Poniżej znajdziesz opis wymagań dotyczących uzgadniania połączenia w przypadku poszczególnych usług:
Agregacja kont: tę usługę można skonfigurować tylko w ramach tworzenia konta. Dostawca usług powinien mieć konto zaawansowane, a usługa jest zatwierdzana automatycznie, ponieważ użytkownicy konta zaawansowanego mają pełny dostęp do tworzonego konta.
ADMIN
Zarządzanie kampaniami: chociaż ten proces przebiega w standardowy sposób, propozycje są składane w jednym systemie (np. Google Ads), a zatwierdzenia są dokonywane w innym systemie (np. w Merchant Center lub za pomocą interfejsu Merchant API).
Zarządzanie lokalnymi informacjami o firmie: w przypadku tej usługi uzgadnianie jest proponowane w ramach specjalnej metody, a zatwierdzanie odbywa się w innym systemie (np. w usłudze Profil Firmy w Google). Szczegółowe instrukcje znajdziesz w przewodniku po łączeniu profilu firmy w Google.
Zarządzanie kontem: w przypadku tej usługi obowiązuje standardowy proces uzgadniania (propozycja dostawcy usług lub firmy, a następnie akceptacja drugiej strony).
Zarządzanie produktami: w przypadku tej usługi obowiązuje standardowy proces uzgadniania (propozycja jednej ze stron, a następnie akceptacja drugiej).
Uprawnienia dostępu
Każdy typ usługi zapewnia użytkownikom dostawcy usług określony poziom dostępu do obsługiwanego konta:
Agregacja kont: ta usługa zapewnia pełne prawa
ADMIN
.Zarządzanie kampaniami: ta usługa zapewnia ograniczone prawo dostępu, które umożliwia powiązanemu kontu Ads dostęp do produktów i podstawowych informacji o koncie.
Porównywanie cen: ta usługa domyślnie zapewnia pełne
ADMIN
prawa. Firma może jednak ograniczyć dostęp przyznany w Merchant Center.Zarządzanie lokalną wizytówką: ta usługa nie zapewnia bezpośredniego prawa dostępu. Zamiast tego umożliwia synchronizację produktów z kontem Merchant Center.
Ważne: prawa dostępu opisane w przypadku tych typów usług dotyczą tylko zatwierdzonych dostawców usług. Jeśli jesteś dostawcą usług i chcesz korzystać z tej funkcji, skontaktuj się z naszym zespołem pomocy. Jeśli wcześniej została Ci przyznana zgoda na korzystanie z metody accounts.link
do zarządzania produktami w interfejsie Content API for Shopping, możesz używać tej usługi w Merchant API bez konieczności uzyskiwania dodatkowych zgód.
Zarządzanie kontem: ta usługa domyślnie zapewnia pełne
ADMIN
uprawnienia.Zarządzanie produktami: ta usługa zapewnia pełne uprawnienia
ADMIN
. Uwaga: w przyszłości będzie to ograniczone tylko do praw dostępu związanych z produktami.
Jak relacje działają w przypadku platform innych firm
Jeśli jesteś platformą zewnętrzną, która zarządza kontami w imieniu innych firm, poniżej znajdziesz informacje o tym, jak różne pojęcia odnoszą się do struktury Twojego konta:
- Dostawca usług: Twoje konto zaawansowane.
- Konto, które otrzymuje usługę: konto Merchant Center reprezentujące firmę, którą zarządzasz.
- Usługa:
accountAggregation
, jeśli tworzysz te konta jako subkonta konta zaawansowanego. Jest to jednak odradzane, a preferowaną usługą jestaccountManagement
.accountManagement
, jeśli konfigurujesz tę usługę po utworzeniu konta na kontach, które nie są subkontami Twojego konta zaawansowanego.
Szczegółowe informacje o tym, jak skonfigurować konto zaawansowane i połączyć je z nowymi kontami Merchant Center, znajdziesz w artykule Tworzenie kont podrzędnych i zarządzanie nimi.