REST Resource: accounts.languages.productCertifications

Ресурс: ProductCertification

Данные о сертификации товаров.

JSON-представление
{
  "name": string,
  "title": string,
  "brand": string,
  "mpn": [
    string
  ],
  "productCode": [
    string
  ],
  "countryCode": [
    string
  ],
  "productType": [
    string
  ],
  "certification": [
    {
      object (Certification)
    }
  ],
  "issues": [
    {
      object (Issue)
    }
  ],
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ]
}
Поля
name

string

Обязательно. Уникальный идентификатор сертификации по продукту. Формат: accounts/{account}/languages/{language_code}/productCertifications/{id}, где id – уникальный идентификатор, а language_code – двухбуквенный код языка, поддерживаемого в Google Покупках, по стандарту ISO 639-1 (https://support.google.com/merchants/answer/160637).

title

string

Обязательно. Это необходимо, чтобы точно идентифицировать товар, который вы сертифицируете.

brand

string

Обязательно. Название бренда товара. Это нужно, чтобы пользователям было проще найти вашу продукцию.

mpn[]

string

Необязательное поле. Это коды производителя товара (MPN). Это уникальный идентификатор, который производитель присваивает каждому из своих товаров, чтобы их можно было различить.

productCode[]

string

Необязательное поле. Другое название кода GTIN.

countryCode[]

string

Необязательное поле. Двухбуквенный код страны (ISO 3166-1 Alpha 2).

productType[]

string

Необязательное поле. Это ваша собственная система классификации товаров в данных о товаре.

certification[]

object (Certification)

Обязательно. Список сертификатов, связанных с описанным товаром.

issues[]

object (Issue)

Только для вывода. Созданный сервером список проблем, связанных с товаром.

destinationStatuses[]

object (DestinationStatus)

Только для вывода. Статусы целевых сервисов.

Сертификация

Описание сертификации.

JSON-представление
{
  "name": string,
  "authority": string,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string,
  "labelLink": string,
  "documentLink": string
}
Поля
name

string

Обязательно. Название сертификата.

authority

string

Обязательно. Название сертификационного органа.

code

string

Необязательное поле. Уникальный код, по которому можно идентифицировать сертификат.

value

string

Необязательное поле. Специальное значение сертификации.

validUntil

string

Необязательное поле. Дата окончания срока действия (UTC).

Проблема

Проблема с товаром.

JSON-представление
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": string,
  "applicableCountries": [
    string
  ]
}
Поля
type

string

Тип проблемы, созданный сервером, например INCORRECT_TEXT_FORMATTING, IMAGE_NOT_SERVEABLE и т. д.

severity

enum (Severity)

Серьезность проблемы.

attribute

string

атрибут, из-за которого возникла проблема (если есть); Подробнее об атрибутах: https://support.google.com/manufacturers/answer/6124116.

title

string

Краткое название, описывающее суть проблемы.

description

string

Подробное описание проблемы и способов ее решения.

resolution

enum (IssueResolution)

Что нужно сделать, чтобы решить проблему.

destination

string

Целевой сервис, которого касается проблема.

timestamp

string (Timestamp format)

Временная метка, указывающая, когда возникла проблема.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

applicableCountries[]

string

Только для вывода. Список кодов стран (ISO 3166-1 alpha-2), в которых проблема относится к товару производителя.

Уровень серьезности

Степень серьезности проблемы.

Перечисления
SEVERITY_UNSPECIFIED Неуказанная степень серьезности, никогда не используется.
ERROR Серьезность ошибки. Проблема препятствует использованию всего объекта.
WARNING Уровень серьезности предупреждения. Проблема либо препятствует использованию атрибута, который ее вызвал, либо скоро приведет к тому, что весь товар станет недоступен.
INFO Информационное сообщение. Проблема не требует немедленного внимания. Например, с его помощью можно узнать, какие атрибуты ещё не проверены.

IssueResolution

Решение проблемы.

Перечисления
RESOLUTION_UNSPECIFIED Разрешение не указано, никогда не использовалось.
USER_ACTION Чтобы устранить проблему, пользователю, который предоставил данные, необходимо выполнить определенные действия, например исправить данные.
PENDING_PROCESSING Проблема будет решена автоматически (например, сканирование изображений или отзыв из Google). Сейчас от вас не требуется никаких действий. Устранение одной проблемы может привести к возникновению другой (например, если сканирование не удалось).

DestinationStatus

Статус целевого сервиса.

JSON-представление
{
  "destination": string,
  "status": enum (Status),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Поля
destination

string

Название пункта назначения.

status

enum (Status)

Статус целевой страницы.

approvedCountries[]

string

Только для вывода. Список кодов стран (ISO 3166-1 alpha-2), в которых одобрено предложение.

pendingCountries[]

string

Только для вывода. Список кодов стран (ISO 3166-1 alpha-2), в которых предложение ожидает одобрения.

disapprovedCountries[]

string

Только для вывода. Список кодов стран (ISO 3166-1 alpha-2), в которых предложение отклонено.

Статус

Статус.

Перечисления
UNKNOWN Статус не указан, никогда не использовался.
ACTIVE Товар используется для этого целевого сервиса.
PENDING Решение ещё не принято.
DISAPPROVED Товар отклонен. Ознакомьтесь с проблемами.

Методы

delete

Удаляет сертификат товара по его названию.

get

Возвращает сертификат продукта по его названию.

list

Возвращает список сертификаций по продукту от указанного сертифицирующего органа.

patch

Обновляет (или создает, если allow_missing = true) сертификацию по продукту, которая связывает сертификаты с продуктами.