- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Przesyła dane o produktach na Twoje konto Merchant Center. Jeśli dane wejściowe o tych samych parametrach contentLanguage, offerId i dataSource już istnieją, ta metoda zastępuje ten wpis.
Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie możliwe pobranie przetworzonego produktu.
Żądanie HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
Wymagane. Konto, na którym chcesz wstawić ten produkt. Format: konta/{konto} |
Parametry zapytania
Parametry | |
---|---|
dataSource |
Wymagane. Nazwa podstawowego lub dodatkowego źródła danych produktów. Jeśli produkt już istnieje, a podane źródło danych jest inne, produkt zostanie przeniesiony do nowego źródła danych. Format: |
Treść żądania
Treść żądania zawiera wystąpienie elementu ProductInput
.
Treść odpowiedzi
Ten zasób reprezentuje dane wejściowe, które przesyłasz dotyczące produktu, a nie produktu przetworzonego, który widzisz w Merchant Center, w reklamach produktowych lub w usługach Google. Dane wejściowe produktu, reguły i dodatkowe dane źródeł danych są łączone w celu utworzenia przetworzonego [product][google.shopping.content.bundles.Products.Product].
Wymagane atrybuty wejściowe produktów, które umożliwiają weryfikację danych, są przede wszystkim zdefiniowane w specyfikacji danych produktów.
Wymagane są te atrybuty: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] i [offerId][google.shopping.content.bundles.Products.offer_id].
Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie możliwe pobranie przetworzonego produktu.
Wszystkie pola w danych wejściowych produktu i jego wiadomościach podrzędnych są zgodne z angielską nazwą odpowiedniego atrybutu w specyfikacji branży (z pewnymi wyjątkami).
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
Pola | |
---|---|
name |
Identyfikator. Nazwa danych wejściowych o produkcie. Format: |
product |
Tylko dane wyjściowe. Nazwa przetworzonego produktu. Format: |
channel |
Wymagane. Stały. Kanał produktu. |
offerId |
Wymagane. Stały. Unikalny identyfikator produktu. To samo dotyczy danych wejściowych produktu i przetworzonego produktu. Odstępy na początku i na końcu są usuwane, a wiele odstępów jest zastępowanych pojedynczą spacją podczas przesyłania. Więcej informacji znajdziesz w specyfikacji danych produktów. |
contentLanguage |
Wymagane. Stały. Dwuliterowy kod języka ISO 639-1. |
feedLabel |
Wymagane. Stały. Etykieta pliku danych produktu. |
attributes |
Opcjonalnie: Lista atrybutów produktów. |
customAttributes[] |
Opcjonalnie: Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Możesz go też wykorzystać, aby przesłać dowolny atrybut specyfikacji danych w ogólnej formie (np. |
versionNumber |
Opcjonalnie: Reprezentuje istniejącą wersję (aktualność) produktu, która pozwala zachować właściwą kolejność w przypadku przeprowadzania wielu aktualizacji jednocześnie. Jeśli zasada jest skonfigurowana, wstawianie jest blokowane, gdy numer wersji jest niższy niż bieżący numer wersji istniejącego produktu. Ponowne wstawienie (np. odświeżenie produktu po 30 dniach) można wykonać za pomocą obecnej wartości Obsługiwane tylko w przypadku wstawiania do podstawowych źródeł danych. Jeśli ta operacja jest blokowana, zgłaszany jest przerwany wyjątek. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/content
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.