REST Resource: accounts.products

Zasób: Produkt

Przetworzony produkt, utworzony z wielu product inputs po zastosowaniu reguł i dodatkowych źródeł danych. Przetworzony produkt jest zgodny z tym, co jest widoczne na Twoim koncie Merchant Center oraz w reklamach produktowych i innych miejscach w Google. Każdy produkt jest tworzony na podstawie dokładnie jednego źródła danych podstawowego i wielu źródeł danych dodatkowych. Po wstawieniu, zaktualizowaniu lub usunięciu danych produktu może minąć kilka minut, zanim zaktualizowany przetworzony produkt będzie można pobrać.

Wszystkie pola przetworzonego produktu i jego komunikatów podrzędnych są zgodne z nazwą odpowiadającego atrybutu w specyfikacji danych produktów, z pewnymi wyjątkami.

Zapis JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Pola
name

string

Nazwa produktu. Format: "{product.name=accounts/{account}/products/{product}}", gdzie ostatnia sekcja product składa się z 4 części: channel~contentLanguage~feedLabel~offerId. Przykład nazwy produktu to „accounts/123/products/online~pl~PL~sku123”.
channel

enum (ChannelEnum)

Tylko dane wyjściowe. Kanał produktu.
offerId

string

Tylko dane wyjściowe. 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

Tylko dane wyjściowe. Dwuliterowy kod języka ISO 639-1 produktu.
feedLabel

string

Tylko dane wyjściowe. Etykieta pliku danych produktu.
dataSource

string

Tylko dane wyjściowe. Podstawowe źródło danych produktu.
attributes

object (Attributes)

Tylko dane wyjściowe. Lista atrybutów produktu.
customAttributes[]

object (CustomAttribute)

Tylko dane wyjściowe. Lista atrybutów niestandardowych (podanych przez sprzedawcę). Można go też użyć do przesłania dowolnego atrybutu specyfikacji danych w jego ogólnej formie (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są jawnie udostępniane przez interfejs API, np. dodatkowych atrybutów używanych w usłudze Kup przez Google.
productStatus

object (ProductStatus)

Tylko dane wyjściowe. stan produktu, problemy z weryfikacją danych, czyli informacje o produkcie obliczone asynchronicznie.
versionNumber

string (int64 format)

Tylko dane wyjściowe. 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.

ProductStatus

stan produktu, problemy z weryfikacją danych, czyli informacje o produkcie obliczone asynchronicznie.

Zapis JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Pola
destinationStatuses[]

object (DestinationStatus)

Przeznaczenie produktu.
itemLevelIssues[]

object (ItemLevelIssue)

Lista wszystkich problemów związanych z produktem.
creationDate

string (Timestamp format)

Data utworzenia elementu w formacie ISO 8601.
lastUpdateDate

string (Timestamp format)

Data ostatniej aktualizacji elementu w formacie ISO 8601.
googleExpirationDate

string (Timestamp format)

Data wygaśnięcia produktu w formacie ISO 8601.

DestinationStatus

Stan docelowy produktu.

Zapis JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Pola
reportingContext

enum (ReportingContextEnum)

Nazwa kontekstu raportowania.
approvedCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta została zatwierdzona.
pendingCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta oczekuje na zatwierdzenie.
disapprovedCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta została odrzucona.

ItemLevelIssue

Stan produktu na poziomie produktu.

Zapis JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Pola
code

string

Kod błędu.
severity

enum (Severity)

Jak ten problem wpływa na wyświetlanie oferty.
resolution

string

Czy problem może zostać rozwiązany przez sprzedawcę.
attribute

string

nazwę atrybutu, jeśli problem jest spowodowany przez pojedynczy atrybut.
reportingContext

enum (ReportingContextEnum)

Kontekst raportowania, w którym występuje problem.
description

string

Krótki opis problemu w języku angielskim.
detail

string

szczegółowy opis problemu w języku angielskim.
documentation

string

adres URL strony internetowej, która pomoże nam rozwiązać ten problem.
applicableCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w przypadku których problem dotyczy oferty.

Poziom ważności

Jak problem wpływa na wyświetlanie produktu.

Wartości w polu enum
SEVERITY_UNSPECIFIED Nie określono.
NOT_IMPACTED Ten problem jest ostrzeżeniem i nie ma bezpośredniego wpływu na produkt.
DEMOTED Produkt został zdegradowany i najprawdopodobniej ma ograniczoną skuteczność w wynikach wyszukiwania
DISAPPROVED Problem powoduje odrzucenie produktu.

Metody

get

 Pobiera przetworzony produkt z konta Merchant Center.

list

 Wyświetla przetworzone produkty na koncie Merchant Center.