REST Resource: accounts.productInputs

Zasób: ProductInput

Ten zasób reprezentuje dane wejściowe przesłane przez Ciebie dla produktu, a nie przetworzony produkt, który widzisz w Merchant Center, reklamach produktowych lub w usługach Google. Dane wejściowe produktów, reguły i dane dodatkowego źródła danych są łączone, aby utworzyć przetworzone dane Product.

Wymagane atrybuty danych produktów, które muszą przejść weryfikację, są zdefiniowane głównie w specyfikacji danych produktów.

Wymagane są te atrybuty: feedLabel, contentLanguage i offerId.

Po wstawieniu, zaktualizowaniu lub usunięciu danych produktu może minąć kilka minut, zanim przetworzony produkt będzie można pobrać.

Wszystkie pola w danych produktu i jego komunikatach podrzędnych są zgodne z angielską nazwą odpowiadającego im atrybutu w specyfikacji branżowej (z niektórymi wyjątkami).

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 dotyczących produktu. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}", gdzie ostatnia sekcja productinput składa się z 4 części: channel~contentLanguage~feedLabel~offerId. Przykład nazwy danych wejściowych produktu to „accounts/123/productInputs/online~en~US~sku123”.

product

string

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

channel

enum (ChannelEnum)

Wymagane. Niezmienna. Kanał produktu.

offerId

string

Wymagane. Niezmienna. Unikalny identyfikator Twojego produktu. To samo dotyczy danych wejściowych i przetworzonego produktu. Odstępy na początku i na końcu ciągu są usuwane, a po przesłaniu liczne odstępy są zastępowane pojedynczym odstępem. Szczegółowe informacje znajdziesz w specyfikacji danych produktów.

contentLanguage

string

Wymagane. Niezmienna. Dwuliterowy kod języka ISO 639-1 produktu.

feedLabel

string

Wymagane. Niezmienna. Etykieta pliku danych produktu.

attributes

object (Attributes)

Opcjonalnie: Lista atrybutów produktu.

customAttributes[]

object (CustomAttribute)

Opcjonalnie: Lista atrybutów niestandardowych (podanych przez sprzedawcę). Można go też używać do przesyłania dowolnego atrybutu specyfikacji danych w formie ogólnej (na przykład { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są jawnie udostępniane 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 10240 (co odpowiada sumie znaków w nazwie i wartości). Na produkt 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 wstawiania.

versionNumber

string (int64 format)

Opcjonalnie: Reprezentuje bieżącą wersję (aktualność) produktu, która może służyć do zachowania prawidłowej kolejności, gdy wprowadzane są jednocześnie liczne aktualizacje.

Jeśli ta opcja jest ustawiona, wstawianie jest blokowane, gdy numer wersji jest niższy niż bieżący numer wersji danego produktu. Ponowna wstawka (np. odświeżenie produktu po 30 dniach) może zostać wykonana za pomocą bieżącego versionNumber.

Obsługiwane tylko w przypadku wstawień do podstawowych źródeł danych.

Jeśli operacja zostanie zablokowana, zostanie wywołany wyjątek przerwania.

Metody

delete

Usuwa dane produktu z konta Merchant Center.

insert

Przesyła dane produktu na konto Merchant Center.