REST Resource: products

Ресурс: Продукт

Один продукт.

JSON-представление
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadTime": string,
  "assignmentLeadTime": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "currencyCode": string
}
Поля
name

string

Имя ресурса продукта в формате: products/{id} . Например products/product123 .

externalId

string

Необязательный. Идентификатор, используемый для сопоставления этого объекта с внешними источниками.

displayName

string

Необходимый. Отображаемое имя продукта.

Должен быть в кодировке UTF-8 с максимальным размером 240 байт.

description

string

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

labels

map (key: string, value: string)

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

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

creativeSpecifications[]

object ( CreativeSpecification )

Необходимый. Список разрешенных креативов, которые можно показывать для этого продукта.

bookingLeadTime

string ( Duration format)

Необходимый. Время выполнения, необходимое для бронирования продукта. Теперь + bookingLeadTime должно быть после начала полета.

Продолжительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « s ». Пример: "3.5s" .

assignmentLeadTime

string ( Duration format)

Необходимый. Время, необходимое для назначения креативов.

Продолжительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « s ». Пример: "3.5s" .

minFlightDuration

string ( Duration format)

Необязательный. Минимальная продолжительность полета для этого продукта.

Продолжительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « s ». Пример: "3.5s" .

maxFlightDuration

string ( Duration format)

Необходимый. Максимальная продолжительность полета для этого продукта.

Продолжительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « s ». Пример: "3.5s" .

slotDuration

string ( Duration format)

Необходимый. Продолжительность слота для этого продукта.

Продолжительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « s ». Пример: "3.5s" .

createTime

string ( Timestamp format)

Только вывод. Временная метка создания продукта.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

Только вывод. Временная метка последнего обновления продукта.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

currencyCode

string

Трехбуквенный код валюты в верхнем регистре, определенный в ISO 4217.

Методы

create

Создает новый продукт.

get

Получает отдельный продукт.

list

Перечисляет продукты.

patch

Обновляет существующий продукт.