Связаться с намиПодключиться

Метод write

Статья создана
Обновлена 26 августа 2024 г.

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

HTTP-запрос

POST https://marketplace.api.cloud.yandex.net/marketplace/v1/metering/imageProductUsage/write

Параметры запроса

{
  "validateOnly": true,
  "productId": "string",
  "usageRecords": [
    {
      "uuid": "string",
      "skuId": "string",
      "quantity": "string",
      "timestamp": "string"
    }
  ]
}
Поле Описание
validateOnly boolean (boolean)

Сообщение с параметром validateOnly: true проверяет, возможна ли отправка метрик использования.
productId string

Обязательное поле. ID продукта Marketplace.

Максимальная длина строки — 50 символов.
usageRecords[] object

Обязательное поле. Список записей об использовании продукта (до 25 записей в запросе).

Номера элементов списка должны быть в диапазоне от 1 до 25.
usageRecords[].
uuid		 string

Обязательное поле. Уникальный идентификатор записи об использовании в формате UUID.

Максимальная длина строки — 36 символов.
usageRecords[].
skuId		 string

Обязательное поле. Marketplace SKU ID потребления, связанный с UsageRecord.product_id.

Максимальная длина строки — 50 символов.
usageRecords[].
quantity		 string (int64)

Количество потребленных SKU в юнитах потребления sku.usage_unit (например, байтах).

Значение должно быть больше 0.
usageRecords[].
timestamp		 string (date-time)

Обязательное поле. UTC Timestamp отчетного периода.

Строка в текстовом формате RFC3339.

Ответ

HTTP Code: 200 — OK

{
  "accepted": [
    {
      "uuid": "string"
    }
  ],
  "rejected": [
    {
      "uuid": "string",
      "reason": "string"
    }
  ]
}
Поле Описание
accepted[] object

Список принятых записей о потреблении продукта.
accepted[].
uuid		 string

Уникальный идентификатор записи о потреблении в формате UUID.
rejected[] object

Список отклоненных записей о потреблении продукта с указанием причины.
rejected[].
uuid		 string

Уникальный идентификатор записи о потреблении в формате UUID.
rejected[].
reason		 string

Причина отклонения записи.
Предыдущая
Описание
Следующая
Overview