Тарификация продуктов на основе метрик издателя
Marketplace предоставляет API учета потребления, чтобы продукты могли учитывать потребление и выставлять счета пользователям Yandex Cloud через сервис Yandex Cloud Billing. Интеграция с API требуется для любого продукта, использующего один или несколько планов тарификации с пользовательскими измерениями, чтобы учитывать события потребления.
На основе установленных вами метрик приложение (продукт) должно фиксировать события потребления и отправлять данные о них с помощью API учета потребления. В одном запросе вы можете отправить одно или несколько событий потребления.
Спецификацию API выставления счетов по тарифу см. в разделе Yandex Cloud Marketplace Metering API.
Рекомендации по разработке и тестированию
- Для авторизации приложения используйте сервисный аккаунт с ролью
marketplace.meteringAgent
. - Чтобы создать тариф для продукта с пользовательскими метриками, оставьте заявку в кабинете партнера Marketplace. Используйте выданный тарифу
skuId
для отправки записей о потреблении. - При установке приложение должно проверить, что у пользователя достаточно прав для его использования и отправка событий потребления возможна. Для этого необходимо отправить запрос write с параметром
validateOnly: true
. - Приложение должно учитывать возможность неудачной попытки отправки событий потребления.
- Перед публикацией продукта рекомендуем тестировать интеграцию с API с помощью ID и SKU демонстрационного продукта:
productId: f2e4tmlj4qqciunhr7e6
,skuId: dn272e8979uvek5cnuhk
. Примеры работы с API см. в разделе Как начать работать с Marketplace Metering API.
Тестирование интеграции
Примеры кода и тестовый сервер для проверки работы интеграции с Metering API доступны в репозитории на GitHub