Omówienie interfejsu Accounts API

Interfejs podrzędny Accounts w interfejsie Merchant API umożliwia automatyczne tworzenie, konfigurowanie i zarządzanie kontami Google Merchant Center. Zapewnia kompleksowy zestaw narzędzi do zarządzania całym cyklem życia i podstawowymi konfiguracjami kont Merchant Center. Ten interfejs API jest niezbędny dla firm i zewnętrznych dostawców, którzy chcą zautomatyzować zakładanie konta i jego bieżącą obsługę.

Za pomocą podrzędnego interfejsu API kont możesz:

  • wykonywać podstawowe operacje na koncie Merchant Center: tworzyć nowe konta Merchant Center, pobierać ich szczegóły, aktualizować podstawowe ustawienia, sprawdzać problemy na poziomie konta, wyświetlać listę kont, do których masz dostęp, i w razie potrzeby usuwać konta;
  • Podaj informacje o firmie i skonfiguruj obecność sklepu internetowego: skonfiguruj podstawowe informacje o firmie (takie jak adres i dane kontaktowe) oraz atrybuty tożsamości deklarowane przez sprzedawcę, a także skonfiguruj witrynę sklepu internetowego, podając, weryfikując i zgłaszając prawa do adresu URL strony głównej. To kluczowy element prezentacji Twojej firmy.
  • Zarządzanie dostępem użytkowników i ustawieniami komunikacji: dowiedz się, jak kontrolować, kto ma dostęp do Twojego konta Merchant Center, określać uprawnienia użytkowników i konfigurować ustawienia powiadomień e-mail dotyczących ważnych aktualizacji i wiadomości o koncie.
  • Zarządzanie rejestracją i udziałem w programach: zarządzaj rejestracją w różnych programach Merchant Center (takich jak bezpłatne informacje czy reklamy produktowe), zarządzaj stanem udziału i poznaj wymagania dotyczące poszczególnych programów, aby zwiększyć zasięg swoich produktów.
  • Skonfiguruj logistykę: dostawę, zwroty i regiony: skonfiguruj ustawienia dostawy na poziomie konta, określ zasady zwrotów online dla klientów i utwórz regiony geograficzne, aby precyzyjnie kierować reklamy i świadczyć usługi.
  • Korzystanie z zaawansowanych integracji i łączenia kont: dowiedz się, jak zarządzać ustawieniami wielokanałowości, łączyć się z kontami Profilu Firmy w Google i dostawcami lokalnych plików danych oraz nawiązywać relacje z innymi kontami, takimi jak dostawcy zewnętrzni lub agencje, i nimi zarządzać.

Ten zestaw przewodników zawiera szczegółowe instrukcje i przykłady typowych przypadków użycia:

  • Tworzenie konta: dowiedz się, jak automatycznie utworzyć nowe konto Merchant Center i zarządzać jego powiązaniami z kontem zaawansowanym, co jest niezbędne do zarządzania wieloma sprzedawcami lub markami.
  • Relacje: dowiedz się, jak są strukturyzowane i zarządzane relacje usług między różnymi kontami Merchant Center (np. z kontami zaawansowanymi lub dostawcami zewnętrznymi).
  • Połącz z Profilem Firmy w Google: połącz konto Merchant Center z Profilem Firmy w Google, aby zwiększyć widoczność swojej firmy lokalnej.
  • Kontrola dostępu do konta: zarządzaj uprawnieniami i rolami użytkowników na koncie Merchant Center, aby kontrolować, kto może wykonywać określone działania.
  • Zarządzanie e-mailami z powiadomieniami z Merchant Center: dostosuj e-maile z powiadomieniami, które Ty i inni użytkownicy otrzymujecie w związku z alertami, wiadomościami i wskazówkami dotyczącymi konta.
  • Zarządzanie ustawieniami strony głównej: ustaw, zweryfikuj i zgłoś prawa do adresu URL witryny sklepu internetowego, co jest kluczowym krokiem w procesie weryfikacji konta i uczestnictwa w programie.
  • Migracja Content API: aby dowiedzieć się więcej o migracji z Content API for Shopping, przeczytaj artykuł o migracji zarządzania kontem.

Struktura i relacje konta Merchant Center

Ekosystem Merchant Center obsługuje różne struktury kont, aby zaspokoić różne potrzeby biznesowe. Konta te mogą też tworzyć relacje między sobą, w których jedno konto (dostawca usług) oferuje określone usługi innemu. Interfejs sub-API Accounts umożliwia interakcję z tymi typami i ich relacjami oraz zarządzanie nimi.

Konta sprzedawców

Jest to konto Merchant Center, zwykle używane przez pojedynczą firmę do bezpośredniego zarządzania własnymi informacjami o produktach i programami.

Częste przypadki użycia:

  • Małe i średnie firmy, które same zarządzają swoją obecnością w e-commerce.
  • Sprzedawcy, którzy chcą mieć bezpośrednią kontrolę nad konfiguracją Google Merchant Center.
  • sprzedawców, którzy korzystają z kreatorów sklepów lub innych dostawców zewnętrznych, którzy pomagają im tworzyć konta i nimi zarządzać;

Relacje i usługi:

Konta sprzedawców można połączyć z dostawcami usług, aby uzyskać pomoc w takich zadaniach jak zarządzanie danymi produktów czy zarządzanie kontem i kampanią.

Konta zaawansowane

Konto zaawansowane to specjalistyczne konto w Google Merchant Center. Jest przeznaczony dla firm i dostawców zewnętrznych (takich jak kreatory sklepów, partnerzy kanału, agencje i platformy handlowe), którzy muszą zarządzać wieloma kontami Merchant Center na dużą skalę.

Częste przypadki użycia:

  • Kreatory sklepów: dostawcy zewnętrzni, którzy umożliwiają sprzedawcom tworzenie i prowadzenie sklepów internetowych.
  • Platformy handlowe: miejsca do robienia zakupów online, które umożliwiają sprzedawcom indywidualnym udostępnianie swoich produktów.
  • Sprzedawcy posiadający wiele marek: sprzedawcy posiadający wiele marek i sprzedający produkty w sklepach stacjonarnych lub online w wielu domenach.
  • Sprzedawcy międzynarodowi: sprzedawcy, którzy sprzedają produkty w wielu krajach i domenach.
  • Partnerzy kanału: podmioty, które pomagają sprzedawcom wyświetlać produkty w różnych kanałach marketingowych i często świadczą powiązane usługi.
  • Agencje: agencje marketingowe i reklamowe, które zarządzają kontami Merchant Center, plikami danych o produktach i kampaniami w imieniu swoich klientów.

Relacje i usługi:

Chociaż wszystkie konta zaawansowane zarządzają wieloma kontami sprzedawców, optymalna konfiguracja i wykorzystanie relacji oraz usług często różnią się w zależności od konkretnego modelu biznesowego. Zrozumienie tych różnic jest kluczem do skutecznego korzystania z interfejsu API. Oto zalecane sprawdzone metody dotyczące typowych przypadków użycia:

Kreatory sklepów i partnerzy kanału

Partnerzy powinni utworzyć konto zaawansowane i nawiązać relacje ze sprzedawcami, z którymi współpracują:

  • Nowi sprzedawcy bez konta: podczas konwertowania konta na konto zaawansowane w interfejsie Merchant Center Google automatycznie konfiguruje kreatory sklepów i partnerów kanału jako multikonta klientów z usługą Account Aggregation (accountAggregation). Kreator sklepu lub partner kanału może używać accounts.createAndConfigure z accountAggregation, aby tworzyć nowe subkonta dla sprzedawców, które są widoczne i którymi można zarządzać w Merchant Center.
  • W przypadku istniejących kont Merchant Center: istniejących samodzielnych kont nie można przenieść na konto zaawansowane za pomocą accountAggregation. Zamiast tego kreator sklepu lub partner kanału powinien utworzyć połączenie usługi Account Management (accountManagement) z istniejącym kontem indywidualnym sprzedawcy. Dzięki temu twórca sklepu lub partner kanału może zarządzać aspektami konta za zgodą sprzedawcy.

Pobieranie informacji o zarządzanych kontach: aby pobrać informacje o kontach sprzedawców, którymi zarządzasz za pomocą accountManagement, wywołaj accounts.list z filtrem relationship, na przykład filter=relationship(providerId={PROVIDER_ID} AND service(type="ACCOUNT_MANAGEMENT")), a następnie wywołaj accounts.get lub accountServices.list, aby sprawdzić szczegóły konkretnego konta i usługi.

Agencje

Agencje zwykle zarządzają samodzielnymi kontami Merchant Center należącymi do ich klientów, zamiast agregować subkonta w ramach jednego konta zaawansowanego:

  • W przypadku istniejących kont Merchant Center: agencja proponuje połączenie z usługą Account Management (accountManagement) (często w połączeniu z Products Management (productsManagement) lub Campaign Management (campaignsManagement)), które sprzedawca zatwierdza.
  • W przypadku nowych sprzedawców bez konta: agencja może wywołać metodę accounts.createAndConfigure za pomocą usługi Account Management (accountManagement) i dodać sprzedawcę jako użytkownika ADMIN, aby zachował on własność samodzielnego konta.

Platformy handlowe

Platformy handlowe korzystają z jednego konta zaawansowanego na domenę i tworzą konta sprzedawców za pomocą usługi Account Aggregation. Platformy handlowe często korzystają z wielu typów sprzedawców, z których niektóre wymagają dodatkowej konfiguracji przez zespół pomocy Google. Zgłaszanie praw do domeny i zarządzanie programem odbywa się na poziomie konta zaawansowanego i jest dziedziczone przez konta sprzedawców. Więcej informacji znajdziesz w artykule w Centrum pomocy na temat prawidłowej struktury konta platformy handlowej.

  • Konto sprzedawcy na platformie handlowej: dedykowane konto dla produktów platformy handlowej. Dzięki temu platforma handlowa może wykorzystać rozpoznawalność marki, oceny sprzedawcy i konkretne strategie kampanii sprzedawcy.
  • Konta pojedynczego sprzedawcy: każde konto zawiera produkty jednego sprzedawcy zewnętrznego. Ta struktura jest idealna dla większych sprzedawców, którzy potrzebują odrębnych atrybutów dla poszczególnych sprzedawców lub prowadzą kampanie reklamowe dla wybranych sprzedawców.
  • Konta wielu sprzedawców: jedno konto zawiera produkty od wielu sprzedawców zewnętrznych, co upraszcza zarządzanie kontem i produktami. Więcej informacji znajdziesz w artykule w Centrum pomocy na temat kont wielu sprzedawców.

Sprzedawcy posiadający wiele marek

Firmy, które mają wiele marek, zwykle używają konta zaawansowanego do zarządzania poszczególnymi kontami każdej marki, które są połączone za pomocą usługi Account Aggregation. Dzięki temu marki mogą działać niezależnie (np. w zakresie praw do witryny, danych o produktach), a konto zaawansowane upraszcza funkcje scentralizowane, takie jak dostęp użytkowników, raportowanie, a czasem nadzór nad kampanią.

Sprzedawcy międzynarodowi

Sprzedawcy międzynarodowi zarządzają swoją globalną obecnością za pomocą konta zaawansowanego, z indywidualnymi kontami dla każdego kraju lub regionu połączonymi za pomocą usługi Account Aggregation. Ich konfiguracja często różni się w zależności od struktury domeny:

  • Pojedyncza domena (z subdomenami/ścieżkami krajowymi): prawa do domeny głównej są zwykle zgłaszane na poziomie konta zaawansowanego i dziedziczone przez konta regionalne. Te konta regionalne skupiają się na zarządzaniu zlokalizowanymi danymi o produktach, cenami i dostępnością.
  • Wiele domen krajowych: każde konto regionalne zgłasza prawa do własnej domeny. W tym modelu poszczególne konta obsługują operacje lokalne, a konto zaawansowane jest używane głównie do funkcji scentralizowanych, takich jak dostęp użytkowników, raportowanie globalne i ogólne zarządzanie kampaniami.
Dalej
Create accounts