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 drugiemu 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;
Alias
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. Alias musi składać się z 1–50 znaków wybranych spośród liter ASCII, cyfr dziesiętnych, łączników, podkreśleń, kropek lub tyld ([A-Za-z0-9_~.-]{1,50}).
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ą otrzymywać te usługi: Wiele z tych usług możesz dodać podczas tworzenia konta.
Agregacja kont: ta usługa łączy konto zaawansowane z innym kontem, przyznając kontu zaawansowanemu pełny, nieograniczony dostęp. Jest ono zwykle używane przez platformy handlowe, sprzedawców wielu marek lub sprzedawców międzynarodowych, którzy potrzebują centralnego zarządzania kontami zagnieżdżonymi. Jeśli jesteś platformą e-commerce lub partnerem kanału, zalecamy użycie
accountManagement. Gdy tworzysz konto za pomocą agregacji kont, znakexternalAccountIdmusi zostać pominięty.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, aexternalAccountIdto identyfikator konta Google Ads. Usługa może być też proponowana w przypadku istniejącego konta.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 lokalnych wyszukiwaniach: 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. Gdy usługa jest używana podczas tworzenia konta, tworzy konto połączone z dostawcą. Jest to zalecane podejście w przypadku platform handlu elektronicznego i partnerów kanału. Można go też zaproponować w przypadku istniejącego konta.
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. Gdy jest dodawany podczas tworzenia konta, zwykle występuje w połączeniu z
accountManagementlubaccountAggregation. Usługa może być też proponowana w przypadku istniejącego konta.
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.
ADMINPorównywanie cen: ta usługa jest automatycznie zatwierdzana po dodaniu podczas tworzenia konta za pomocą
createAndConfigure.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 drugim systemie (np. w Merchant Center lub za pomocą 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 podczas korzystania z
proposeobowiązuje standardowy proces uzgadniania. Jeśli usługa zostanie dodana podczas tworzenia konta za pomocą funkcjicreateAndConfigure, zostanie automatycznie zatwierdzona.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
ADMINprawa. Firma może jednak ograniczyć dostęp przyznany w Merchant Center.Zarządzanie lokalnymi informacjami: ta usługa nie zapewnia bezpośredniego prawa dostępu. Zamiast tego umożliwia synchronizację produktów z kontem Merchant Center.
Ważne: uprawnienia dostępu opisane w przypadku tych typów usług dotyczą tylko zatwierdzonych dostawców usług. Jeśli jesteś usługodawcą i chcesz skorzystać 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 Content API for Shopping, możesz używać tej usługi w Merchant API bez dodatkowych zgód.
Zarządzanie kontem: ta usługa domyślnie zapewnia pełne
ADMINuprawnienia.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:
accountManagement: jest to zalecana usługa dla platform e-commerce i partnerów kanału, którzy tworzą nowe konta w imieniu sprzedawców. Tworzy ono konto, którego właścicielem jest sprzedawca, połączone z Twoim kontem w celu zarządzania. Jest to zgodne z preferowaną strukturą Merchant Center w tym przypadku użycia.accountAggregation: ta usługa łączy Twoje konto zaawansowane z innym kontem. Chociaż jest obsługiwany, nie jest zalecany w przypadku platform e-commerce i partnerów kanału.
Szczegółowe informacje o tym, jak skonfigurować konto zaawansowane i połączyć je z nowymi kontami Merchant Center, znajdziesz w artykule Tworzenie kont.