REST Resource: monetization.subscriptions.basePlans.offers

{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}

string

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

string

Необходимый. Неизменяемый. Идентификатор родительской подписки, которой принадлежит это предложение.

string

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

string

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

enum ( State )

Только вывод. Текущее состояние этого предложения. Можно изменить с помощью действий Активировать и Деактивировать. Примечание: состояние базового плана заменяет это состояние, поэтому активное предложение может быть недоступно, если базовый план не активен.

object ( SubscriptionOfferPhase )

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

object ( SubscriptionOfferTargeting )

Требования, которые пользователи должны выполнить, чтобы иметь право на участие в этом предложении. Представляет требования, которые Play оценит, чтобы решить, следует ли вернуть предложение. Разработчики могут самостоятельно фильтровать эти предложения.

object ( RegionalSubscriptionOfferConfig )

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

object ( OtherRegionsSubscriptionOfferConfig )

Конфигурация для любых новых локаций, которые Play может запустить в будущем.

object ( OfferTag )

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

{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}

integer

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

string

Необходимый. Продолжительность однократного рецидива этой фазы. Указывается в формате ISO 8601.

object ( RegionalSubscriptionOfferPhaseConfig )

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

object ( OtherRegionsSubscriptionOfferPhaseConfig )

Информация о ценах на любые новые места, где может появиться Play.

{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}

string

Необходимый. Неизменяемый. Регион, к которому применяется эта конфигурация.

object ( Money )

Абсолютная цена, которую пользователь платит за этот этап предложения. Цена не должна быть ниже минимальной цены, разрешенной для этого региона.

number

Доля цены базового плана, пропорциональная продолжительности фазы, которую пользователь платит за эту фазу предложения. Например, если базовая цена плана для этого региона составляет 12 долларов США сроком на 1 год, то скидка 50 % на этап продолжительностью 3 месяца будет соответствовать цене 1,50 доллара США. Скидку необходимо указывать в виде дроби строго больше 0 и строго меньше 1. Полученная цена будет округлена до ближайшей расчетной единицы (например, центов за доллар США). Относительная скидка считается недействительной, если цена со скидкой оказывается меньше минимальной цены, разрешенной в этом регионе.

object ( Money )

Абсолютная сумма денег, вычтенная из цены базового плана, пропорционально продолжительность фазы, которую пользователь платит за эту фазу предложения. Например, если базовая цена плана для этого региона составляет 12 долларов США сроком на 1 год, то абсолютная скидка в 1 доллар США для этапа продолжительностью 3 месяца будет соответствовать цене в 2 доллара США. Итоговая цена не может быть меньше минимальной цены, разрешенной для этого региона.

object ( RegionalSubscriptionOfferPhaseFreePriceOverride )

Установите, чтобы указать, что это предложение можно получить бесплатно.

{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}

object ( OtherRegionsSubscriptionOfferPhasePrices )

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

number

Доля цены базового плана, пропорциональная продолжительности фазы, которую пользователь платит за эту фазу предложения. Например, если базовая цена плана для этого региона составляет 12 долларов США сроком на 1 год, то скидка 50 % на этап продолжительностью 3 месяца будет соответствовать цене 1,50 доллара США. Скидку необходимо указывать в виде дроби строго больше 0 и строго меньше 1. Полученная цена будет округлена до ближайшей расчетной единицы (например, центов за доллар США). Относительная скидка считается недействительной, если цена со скидкой оказывается меньше минимальной цены, разрешенной в любых новых местах, где может запускаться Play.

object ( OtherRegionsSubscriptionOfferPhasePrices )

Абсолютная сумма денег, вычтенная из цены базового плана, пропорционально продолжительность фазы, которую пользователь платит за эту фазу предложения. Например, если базовая цена плана для этого региона составляет 12 долларов США сроком на 1 год, то абсолютная скидка в 1 доллар США для этапа продолжительностью 3 месяца будет соответствовать цене в 2 доллара США. Полученная цена не может быть меньше минимальной цены, разрешенной для любых новых мест, где может запускаться Play.

object ( OtherRegionsSubscriptionOfferPhaseFreePriceOverride )

Установите, чтобы указать, что это предложение можно получить бесплатно.

{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}

object ( Money )

Необходимый. Цена в долларах США для использования во всех новых местах, где может появиться Play.

object ( Money )

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

{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}

object ( AcquisitionTargetingRule )

Предложите правило таргетинга для привлечения новых пользователей.

object ( UpgradeTargetingRule )

Предложите правило таргетинга для обновления существующих планов пользователей.

{
  "scope": {
    object (TargetingRuleScope)
  }
}

object ( TargetingRuleScope )

Необходимый. Объем подписок, которые учитывает это правило. Разрешены только «эта подписка» и «любая подписка в приложении».

{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}

object ( TargetingRuleScopeThisSubscription )

Областью действия текущего правила таргетинга является подписка, в которой определено это предложение.

object ( TargetingRuleScopeAnySubscriptionInApp )

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

string

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

{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}

boolean

Ограничьте это предложение только один раз для каждого пользователя. Если установлено значение true, пользователь никогда больше не сможет получить право на это предложение, если он когда-либо подписался на это предложение.

object ( TargetingRuleScope )

Необходимый. Объем подписок, которые учитывает это правило. Разрешены только «эта подписка» и «конкретная подписка в приложении».

string

Конкретная продолжительность расчетного периода, указанная в формате ISO 8601, на которую пользователь должен быть в настоящее время подписан, чтобы иметь право на это правило. Если не указано, сопоставляются пользователи, подписанные на любой расчетный период.

{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}

string

Необходимый. Неизменяемый. Код региона, к которому применяется данная конфигурация, согласно определению ISO 3166-2, например «США».

boolean

Доступно ли предложение подписки в указанном регионе для новых подписчиков. Подписка существующих подписчиков не будет отменена, если для этого значения установлено значение false. Если не указано, по умолчанию будет установлено значение false.

{
  "otherRegionsNewSubscriberAvailability": boolean
}

boolean

Может ли предложение подписки в каких-либо новых местах появиться в будущем? Если не указано, по умолчанию будет установлено значение false.