- Recurso: SubscriptionOffer
- Estado
- Fase da Oferta de Assinatura
- RegionalSubscriptionOfferFaseConfig
- OtherRegionSignatureOfferOfferConfig
- Outras Regiões Inscrições Oferta Fase Preços
- SignatureOfferSegmentação
- AquisiçãoSegmentaçãoRule
- TargetRuleScope
- UpgradeTargetRule
- RegionalSubscriptionOfferConfig
- OtherRegionSignatureOfferConfig
- Métodos
Recurso: SubscriptionOffer
Uma única oferta temporária
Representação JSON |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
Campos | |
---|---|
packageName |
Obrigatório. Imutável. É o nome do pacote do app do qual a assinatura mãe pertence. |
productId |
Obrigatório. Imutável. É o ID da assinatura mãe a que essa oferta pertence. |
basePlanId |
Obrigatório. Imutável. É o ID do plano básico a que esta oferta é uma extensão. |
offerId |
Obrigatório. Imutável. ID exclusivo desta oferta de assinatura. Precisa ser exclusivo no plano básico. |
state |
Apenas saída. É o estado atual desta oferta. Ela pode ser alterada usando ações de ativação e desativação. Observação: o estado do plano básico substitui esse estado, por isso, uma oferta ativa poderá não estar disponível se o plano básico não estiver ativo. |
phases[] |
Obrigatório. Fases desta oferta de assinatura. Precisa conter pelo menos uma entrada e pode conter no máximo cinco. Os usuários sempre vão receber todas essas fases na ordem especificada. Não é possível adicionar, remover nem reordenar as fases após a criação inicial. |
targeting |
São os requisitos que os usuários precisam atender para se qualificar para esta oferta. Representa os requisitos que o Google Play avaliará para decidir se uma oferta deve ser retornada. Os desenvolvedores podem filtrar ainda mais essas ofertas. |
regionalConfigs[] |
Obrigatório. A configuração específica da região desta oferta. Precisa ter pelo menos uma entrada. |
otherRegionsConfig |
A configuração de todos os novos locais que o Google Play talvez seja lançado no futuro. |
offerTags[] |
apks.list de até 20 tags personalizadas especificadas para esta oferta e voltou ao app por meio da biblioteca de faturamento. |
Estado
É o estado atual da oferta de assinatura.
Enums | |
---|---|
STATE_UNSPECIFIED |
Valor padrão, nunca deve ser usado. |
DRAFT |
A oferta de assinatura não está e nunca esteve disponível para os usuários. |
ACTIVE |
A oferta de assinatura está disponível para usuários novos e atuais. |
INACTIVE |
A oferta de assinatura não está disponível para novos usuários. Os usuários atuais mantêm o acesso. |
Fase da oferta de assinatura
Uma única fase de uma oferta de assinatura.
Representação JSON |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
Campos | |
---|---|
recurrenceCount |
Obrigatório. O número de vezes que essa fase é repetida. Se esta fase da oferta não for sem custo financeiro, cada recorrência vai cobrar do usuário o preço dessa fase da oferta. |
duration |
Obrigatório. A duração de uma única recorrência dessa fase. Especificado no formato ISO 8601. |
regionalConfigs[] |
Obrigatório. A configuração específica da região desta fase de oferta. Essa lista precisa conter exatamente uma entrada para cada região onde a oferta de assinatura tem uma configuração regional. |
otherRegionsConfig |
São informações de preço de todos os novos locais em que o Google Play pode ser lançado. |
Configuração de assinatura regional da fase de configuração
Configuração para uma única fase de uma oferta de assinatura em uma única região.
Representação JSON |
---|
{ "regionCode": string, // Union field |
Campos | |
---|---|
regionCode |
Obrigatório. Imutável. A região a que essa configuração se aplica. |
Campo de união price_override . A substituição de preço desta fase. Obrigatório. price_override pode ser apenas de um dos tipos a seguir: |
|
price |
É o preço absoluto que o usuário paga pela fase de oferta. O preço não pode ser menor do que o valor mínimo permitido para a região. |
relativeDiscount |
A fração do preço do plano básico proporcional à duração da fase que o usuário paga por essa fase de oferta. Por exemplo, se o preço do plano básico para essa região for R $12 por um ano, então um desconto de 50% para uma fase de três meses vai corresponder a um preço de R $1,50. O desconto precisa ser especificado como uma fração estritamente maior que 0 e estritamente menor que 1. O preço resultante será arredondado para a unidade faturável mais próxima (por exemplo, centavos para USD). O desconto relativo será considerado inválido se o preço com desconto acabar sendo menor que o preço mínimo permitido nessa região. |
absoluteDiscount |
É o valor absoluto subtraído do preço do plano básico proporcional à duração da fase em que o usuário paga pela fase de oferta. Por exemplo, se o preço do plano básico nessa região for de R $12 por um período de um ano, um desconto absoluto de R $1 para uma fase de três meses corresponde a um preço de R $2. O preço resultante não pode ser inferior ao preço mínimo permitido para a região. |
free |
Definir para especificar que esta oferta é sem custo financeiro. |
OtherRegionSignatureOfferFaseConfig
Configuração para novos locais em que o Google Play poderá ser lançado em uma única fase de oferta.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união price_override . A substituição de preço desta fase. Obrigatório. price_override pode ser apenas de um dos tipos a seguir: |
|
otherRegionsPrices |
É o preço absoluto que o usuário paga pela fase de oferta. O preço não pode ser inferior ao preço mínimo permitido para novos locais em que o Google Play poderá ser lançado. |
relativeDiscount |
A fração do preço do plano básico proporcional à duração da fase que o usuário paga por essa fase de oferta. Por exemplo, se o preço do plano básico para essa região for R $12 por um ano, então um desconto de 50% para uma fase de três meses vai corresponder a um preço de R $1,50. O desconto precisa ser especificado como uma fração estritamente maior que 0 e estritamente menor que 1. O preço resultante será arredondado para a unidade faturável mais próxima (por exemplo, centavos para USD). O desconto relativo será considerado inválido se o preço com desconto acabar sendo menor que o preço mínimo permitido em novos locais em que o Google Play poderá ser lançado. |
absoluteDiscounts |
É o valor absoluto subtraído do preço do plano básico proporcional à duração da fase em que o usuário paga pela fase de oferta. Por exemplo, se o preço do plano básico nessa região for de R $12 por um período de um ano, um desconto absoluto de R $1 para uma fase de três meses corresponde a um preço de R $2. O preço resultante não pode ser inferior ao preço mínimo permitido para novos locais em que o Google Play pode ser lançado. |
free |
Definir para especificar que esta oferta é sem custo financeiro. |
OtherRegion Offer manu
São informações de preço de todos os novos locais em que o Google Play pode ser lançado.
Representação JSON |
---|
{ "usdPrice": { object ( |
Campos | |
---|---|
usdPrice |
Obrigatório. O preço é usado em USD para qualquer novo local em que o Google Play possa ser lançado. |
eurPrice |
Obrigatório. Preço em EUR para uso em novos locais em que o Google Play poderá ser lançado. |
Segmentação da oferta de assinatura
Define a regra que um usuário precisa satisfazer para receber esta oferta.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união
|
|
acquisitionRule |
Regra de segmentação de ofertas para aquisição de novos usuários. |
upgradeRule |
Regra de segmentação de ofertas para fazer upgrade de planos existentes. |
Regra de aquisição de segmentação
Representa uma regra de segmentação do formulário: o usuário nunca teve {scope}.
Representação JSON |
---|
{
"scope": {
object ( |
Campos | |
---|---|
scope |
Obrigatório. O escopo das assinaturas consideradas por esta regra. Permite apenas "quo;esta assinatura" e "qualquer assinatura no aplicativo". |
Escopo da regra de segmentação
Define o escopo de assinaturas que uma regra de segmentação pode corresponder para segmentar ofertas com base no direito atual ou no passado.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união
|
|
thisSubscription |
O escopo da regra de segmentação atual é a assinatura em que a oferta é definida. |
anySubscriptionInApp |
O escopo da regra de segmentação atual é qualquer assinatura no app principal. |
specificSubscriptionInApp |
O escopo da regra de segmentação atual é a assinatura com o ID de assinatura especificado. É necessário ser uma assinatura no mesmo app pai. |
Atualização da regra de segmentação
Representa uma regra de segmentação do formulário: O usuário tem {scope} [com período de faturamento {billing_period}].
Representação JSON |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
Campos | |
---|---|
oncePerUser |
Limitar esta oferta apenas uma vez por usuário. Se for verdadeiro, o usuário não poderá se qualificar para esta oferta novamente se já tiver se inscrito na oferta. |
scope |
Obrigatório. O escopo das assinaturas consideradas por esta regra. Só permite "esta assinatura" e "assinatura específica no app". |
billingPeriodDuration |
É a duração específica do período de faturamento no formato ISO 8601 em que um usuário precisa estar inscrito para se qualificar para esta regra. Se não for especificado, os usuários inscritos em qualquer período de faturamento serão correspondidos. |
Assinatura regionalOfertaConfig
Configuração de uma oferta de assinatura em uma única região.
Representação JSON |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
Campos | |
---|---|
regionCode |
Obrigatório. Imutável. Código regional ao qual esta configuração se aplica, conforme definido pela ISO 3166-2, por exemplo, "quot;US"". |
newSubscriberAvailability |
Indica se a oferta de assinatura na região especificada está disponível para novos assinantes. Assinantes existentes não terão a assinatura cancelada se esse valor for definido como falso. Se não for especificado, o padrão será falso. |
OtherRegionSignatureOfferConfig
Configuração para todos os novos locais em que o Google Play pode ser lançado em uma oferta de assinatura especificada.
Representação JSON |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
Campos | |
---|---|
otherRegionsNewSubscriberAvailability |
Indica se a oferta de assinatura em novos locais pode ser lançada no futuro. Se não for especificado, o padrão será falso. |
Métodos |
|
---|---|
|
Ativa uma oferta de assinatura. |
|
Cria uma nova oferta de assinatura. |
|
Desativa uma oferta de assinatura. |
|
Exclui uma oferta de assinatura. |
|
Lê uma única oferta |
|
Lista todas as ofertas de uma determinada assinatura. |
|
Atualiza uma oferta de assinatura existente. |