Method: accounts.productInputs.insert

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

string

Wymagane. Konto, na którym chcesz wstawić ten produkt. Format: konta/{konto}

Parametry zapytania

Parametry
dataSource

string

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: accounts/{account}/dataSources/{datasource}.

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 atrybutu [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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Pola
name

string

Identyfikator. Nazwa danych wejściowych o produkcie. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Tylko dane wyjściowe. Nazwa przetworzonego produktu. Format: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Wymagane. Stała. Kanał produktu.
offerId

string

Wymagane. Stała. 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

string

Wymagane. Stała. Dwuliterowy kod języka ISO 639-1.
feedLabel

string

Wymagane. Stała. Etykieta pliku danych produktu.
attributes

object (Attributes)

Opcjonalnie. Lista atrybutów produktów.
customAttributes[]

object (CustomAttribute)

Opcjonalnie. Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Można go również wykorzystać do przesyłania dowolnych atrybutów specyfikacji danych w ogólnej formie (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są wyraźnie widoczne przez interfejs API, takich jak dodatkowe atrybuty używane w usłudze Kup przez Google. Maksymalna dozwolona liczba znaków dla każdego atrybutu niestandardowego to 10 240 (reprezentuje sumę znaków nazwy i wartości). Dla każdego produktu można ustawić maksymalnie 2500 atrybutów niestandardowych o łącznym rozmiarze 102, 4 kB. Podkreślenia w nazwach atrybutów niestandardowych są zastępowane spacjami podczas ich wstawiania.
versionNumber

string (int64 format)

Opcjonalnie. Reprezentuje istniejącą wersję (aktualność) produktu, która pozwala zachować właściwą kolejność w przypadku przeprowadzania wielu aktualizacji jednocześnie.

Jeśli jest ustawiony, wstawianie jest blokowane, gdy numer wersji jest niższy niż bieżący numer wersji istniejącego produktu. Ponowne wstawienie (na przykład odświeżenie produktu po 30 dniach) można wykonać za pomocą obecnej wartości versionNumber.

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.