REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

Esse tipo representa um objeto SubscriptionPurchaseV2 no serviço androidpublisher.

string

Código ISO 3166-1 alfa-2 do país/da região de faturamento do usuário no momento em que a assinatura foi concedida.

object (SubscriptionPurchaseLineItem)

Informações no nível do item para uma compra de assinatura. Os itens de uma mesma compra precisam ter o AutoRenewingPlan ou todos com o PrepaidPlan.

string (Timestamp format)

Horário em que a assinatura foi concedida. Não definido para assinaturas pendentes (a assinatura foi criada, mas aguardando pagamento durante a inscrição).

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

O estado atual da assinatura.

string

O código do pedido mais recente associado à compra da assinatura. Para a assinatura de renovação automática, este é o código do pedido de inscrição, caso ele ainda não tenha sido renovado, ou o código do último pedido recorrente (pedido concluído, pendente ou recusado). Para assinaturas pré-pagas, este é o ID do pedido associado ao token de compra consultado.

string

O token de compra da assinatura antiga, se ela for uma das seguintes: * Nova assinatura de uma assinatura cancelada, mas não expirada * Upgrade/downgrade de uma assinatura anterior. * Converta uma assinatura pré-paga para uma assinatura com renovação automática. * Converter de uma assinatura com renovação automática para pré-paga. * Recarregue uma assinatura pré-paga.

object (PausedStateContext)

Mais contexto sobre assinaturas pausadas. Presente apenas se a assinatura tiver subscriptionState SUBSCRIPTION_STATE_PAUSED.

object (CanceledStateContext)

Mais contexto sobre assinaturas canceladas. Presente apenas se a assinatura tiver subscriptionState SUBSCRIPTION_STATE_CANCELED ou SUBSCRIPTION_STATE_EXPIRED.

object (TestPurchase)

Presente apenas se a compra de assinatura for um teste.

enum (AcknowledgementState)

O estado de confirmação da assinatura.

object (ExternalAccountIdentifiers)

Identificador da conta de usuário no serviço de terceiros.

object (SubscribeWithGoogleInfo)

Perfil de usuário associado a compras feitas com o "Assine com o Google".

{
  "autoResumeTime": string
}

string (Timestamp format)

Horário em que a assinatura será retomada automaticamente.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

A assinatura foi cancelada pelo usuário.

object (SystemInitiatedCancellation)

A assinatura foi cancelada pelo sistema, por exemplo, devido a um problema de faturamento.

object (DeveloperInitiatedCancellation)

A assinatura foi cancelada pelo desenvolvedor.

object (ReplacementCancellation)

A assinatura foi substituída por uma nova.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

Informações fornecidas pelo usuário quando ele conclui o fluxo de cancelamento da assinatura (pesquisa de motivo do cancelamento).

string (Timestamp format)

A hora em que a assinatura foi cancelada pelo usuário. O usuário ainda pode ter acesso à assinatura depois desse período. Use lineItems.expiry_time para determinar se um usuário ainda tem acesso.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

O motivo que o usuário selecionou na pesquisa de cancelamento.

string

Definido apenas para CANCEL_SURVEY_REASON_OTHERS. Esta é a resposta livre do usuário à pesquisa.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

Identificador da conta de usuário no serviço de terceiros. Presente apenas se a vinculação da conta tiver ocorrido como parte do fluxo de compra da assinatura.

string

Uma versão ofuscada do código que é exclusivamente associada à conta do usuário no seu app. Presente nas seguintes compras: * Se a vinculação da conta aconteceu como parte do fluxo de compra da assinatura. * Ele foi especificado usando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid quando a compra foi feita.

string

Uma versão ofuscada do ID que é exclusivamente associada ao perfil do usuário no seu app. Presente apenas se especificada usando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid quando a compra foi feita.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

O ID do perfil do Google do usuário quando a assinatura foi comprada.

string

É o nome do perfil do usuário quando a assinatura foi comprada.

string

É o endereço de e-mail do usuário quando a assinatura foi comprada.

string

É o nome do usuário quando a assinatura foi comprada.

string

O sobrenome do usuário quando a assinatura foi comprada.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

O ID do produto comprado (por exemplo, "monthly001").

string (Timestamp format)

Horário em que a assinatura expirou ou vai expirar, a menos que o acesso seja estendido (por exemplo, renovação).

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

O item é renovado automaticamente.

object (PrepaidPlan)

O item é pré-pago.

object (OfferDetails)

Detalhes da oferta para este item.

object (DeferredItemReplacement)

Informações para substituição de item adiado.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

Se a assinatura estiver configurada para renovação automática, por exemplo, se o usuário não cancelou a assinatura

object (SubscriptionItemPriceChangeDetails)

Informações sobre a última mudança de preço do item desde a inscrição.

object (InstallmentPlan)

O compromisso do plano de parcelas e as informações relacionadas ao estado do plano com renovação automática.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

Novo preço recorrente do item de assinatura.

enum (PriceChangeMode)

O modo de alteração de preço especifica como o preço do item de assinatura vai mudar.

enum (PriceChangeState)

Informe a mudança de preço atual.

string (Timestamp format)

A hora da renovação em que a mudança de preço entrará em vigor para o usuário. Isso está sujeito a alterações(em um momento futuro) devido a casos em que o horário de renovação é alterado, como uma pausa. Esse campo só será preenchido se a mudança de preço não tiver entrado em vigor.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

Número total de pagamentos com os quais o usuário se compromete inicialmente.

integer

Número total de pagamentos com os quais o usuário será confirmado após cada período de compromisso. Em branco significa que o plano de parcelas voltará a ser uma assinatura de renovação automática normal após o compromisso inicial.

integer

Número total de pagamentos do compromisso restantes a serem pagos no ciclo de renovação.

object (PendingCancellation)

Se presente, este plano de parcelas está pendente para ser cancelado. O cancelamento só vai acontecer depois que o usuário concluir todos os pagamentos confirmados.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Depois desse período, as compras de recarga são permitidas para o plano pré-pago. Ela não será exibida em planos pré-pagos expirados.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

As tags mais recentes associadas à oferta. Ela inclui tags herdadas do plano básico.

string

O ID do plano básico. Presente em todos os planos básicos e ofertas.

string

O ID da oferta. Presente apenas com ofertas com desconto.

{
  "productId": string
}

string

O productId substituirá o productId existente.