Interfejs API

---

Uwierzytelnianie

Aby używać interfejsu Merchant API for Shopping na danym koncie Merchant Center, musi skonfigurować projekt w konsoli interfejsów API. Pomoc dotycząca projektów Google Cloud Console zarządzasz dostępem do interfejsu API i uwierzytelnianiem w swoim rozwiązaniu Merchant API.

W zależności od przypadku użycia dostęp do interfejsu Merchant API można uzyskać na 2 sposoby:

• Jeśli chcesz uzyskać dostęp do określonego konta Merchant Center, zalecamy użycie protokołu OAuth 2.0. za pomocą aplikacji stworzonej dla użytkowników. Co zrobi użytkownik muszą przyznać dostęp do Twojego konta w celu przesyłania danych w jej imieniu.
• Konto usługi to szczególnego rodzaju konto, zwykle używane przez aplikacji, a nie człowieka. Konto usługi jest identyfikowane na podstawie adresu e-mail który jest unikalny dla konta.

Dowiedz się, jak przeprowadzić uwierzytelnianie przy użyciu protokołu OAuth 2.0 lub usługi .

Wskazówka: gdy przesyłasz dane jako dostawca lokalnego pliku danych, usługa Adres e-mail konta należy dodać do listy użytkowników konta MCA, ponieważ połączenia być uwierzytelniane za pomocą tego konta na wszystkich subkontach MCA.

Włącz ustawienia kraju

Ważne: przed przesłaniem ofert danych, których potrzebujesz, aby włączyć konkretne programu partnerskiego.

Zadzwoń pod numer liasettings.update, aby podać kraje, w których planują oferować lokalne usługi.

Więcej informacji na stronie „Ustawienia kraju”

Wyślij dane ofert

Są 2 typy danych: dane o produktach i dane o asortymencie.

Wysyłaj dane o produktach i asortymencie jednocześnie

Dane produktów i asortymentu można przesyłać jednocześnie za pomocą accounts.lfpInventories.insert

Pole „GTIN” będzie działać jako identyfikator produktu w katalogu Google a plik danych o produktach zostanie utworzony automatycznie.

Ten automatycznie utworzony plik danych będzie wyświetlany w docelowym Merchant Center jako „Lokalny dostawca treści” z odpowiednimi ofertami, z którymi są powiązane.

Ta metoda sprawdza się, jeśli wszystkie produkty sprzedawcy mają numer GTIN i nie można funkcje, które zostaną włączone (np. lokalna witryna sklepowa sprzedawcy w wersji podstawowej). Jeśli planujesz włączyć lokalną witrynę sklepową sprzedawcy, wysyłając specjalny plik danych o produktach to zalecana konfiguracja.

Tę samą procedurę możesz zastosować na stronie accounts.lfpSales.insert.

W tym przypadku dane odnoszą się do wyprzedaży konkretnego produktu w w określonym czasie.

Wysyłaj oddzielnie dane produktów i asortymentu

Jeśli numery GTIN nie są powszechnie dostępne lub wolisz skorzystać z istniejącego pliku danych o produktach na docelowym koncie Merchant Center. włączyć lokalną witrynę sklepową sprzedawcy dla sprzedawców, musisz mieć specjalny plik danych o produktach dostępnych lokalnie.

Aby to zrobić, wywołaj accounts.productInputs.insert. i wstawisz wszystkie wartości statyczne produktu. Pamiętaj o ustawieniu wartości Channel ma wartość „local”.

Więcej informacji o podstawowych danych produktów znajdziesz w tym artykule i w interfejsie API ogólne wskazówki dotyczące wstawiania produktów.

Przepływ danych wygląda tak:

• Aby rozpocząć przesyłanie, najpierw zadzwoń na adres accounts.productInputs.insert produkty Twoich sprzedawców
• Następnie zadzwoń pod numer accounts.lfpInventories.insert, aby przesłać asortyment. i skalowalnych danych.

Dane o asortymencie można też przesłać przez accounts.lfpSales.insert. Model systemów uczących się prognozują cenę i ilość ofert na podstawie tych danych.

Przykładowe omówienie: accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

Ważne: identyfikator offerId wysłany na accounts.productInputs.insert musi: dopasuj identyfikator OfferId w pliku accounts.lfpInventories.insert, aby oferty są prawidłowo mapowane.

Ważne: accounts.lfpInventories.insert ma wartość element nadrzędny w adresie URL. To jest Twoje konto dostawcy usług lokalnych włączone przez Zespół pomocy Konto Merchant Center Twojego sprzedawcy znajduje się w ładunku żądania zamiast identyfikatora TargetMerchant. To jest identyfikator w Merchant Center sprzedawcy, dla którego chcesz przesłać asortyment.

Ważne: dane produktu wygasają po 30 dniach, a dane o asortymencie wygasają po 14. dni. Pozwala to skutecznie usuwać niechciane produkty. Produkty i asortyment można wysyłać dane naraz za pomocą accounts.lfpInventories.insert. jeśli numery GTIN są znane dla wszystkich ofert. Możesz też użyć accounts.productInputs.insert. accounts.lfpInventories.insert (lub accounts.lfpSales.insert).

Wyślij dane z Profilu Firmy

Gdy nie można uzyskać dostępu do konta sprzedawcy w Profilu Firmy w Google aby pobrać kody sklepów, dane sklepu mogą być accounts.lfpStores.insert za pomocą własnych kodów sklepów.

Pamiętaj, że podczas wywoływania accounts.lfpinventories.insert lub accounts.lfpSales.wstaw kod sklepu musi być zgodny z kodem sklepu podane w żądaniach lfp Stores.

Ważne: jeśli nie można znaleźć pasującego sklepu, asortyment lub wyprzedaże przesłane z kodem sklepu nie zostaną użyte. Aby zwiększyć współczynnik dopasowania, podane informacje powinny dokładnie odpowiadać danym dostępnym w Google mapy danego sklepu.

Odpowiedź z adresu accounts.lfpStores.insert przekaże też matchingState i matchingStateHint, jeśli dopasowanie się nie powiedzie.

Wskazówka: monitoruj te odpowiedzi, aby zapisywać i rozwiązywać problemy z dopasowaniem. szybciej niż później i unikaj tworzenia niedopasowanych sklepów, ponieważ aby mogły wyświetlać oferty.