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

Этот вид представляет объект SubscriptionPurchaseV2 в службе androidpublisher.

string

Код страны/региона выставления счетов пользователя ISO 3166-1 Alpha-2 на момент предоставления подписки.

object ( SubscriptionPurchaseLineItem )

Информация на уровне элемента для покупки подписки. Все товары в одной покупке должны быть либо все с AutoRenewingPlan, либо все с PrepaidPlan.

string ( Timestamp format)

Время предоставления подписки. Не настроено для ожидающих подписок (подписка создана, но ожидает оплаты во время регистрации).

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

enum ( SubscriptionState )

Текущее состояние подписки.

string

Идентификатор последнего заказа, связанного с покупкой подписки. Для подписки с автоматическим продлением это идентификатор заказа на регистрацию, если он еще не продлен, или идентификатор последнего повторяющегося заказа (успешный, ожидающий или отклоненный заказ). Для предоплаченной подписки это идентификатор заказа, связанный с запрошенным токеном покупки.

string

Токен покупки старой подписки, если эта подписка является одной из следующих: * Повторная регистрация отмененной, но не истекшей подписки * Обновление/понижение предыдущей подписки. * Переход с предоплаченной подписки на автоматическое продление. * Преобразование подписки с автоматическим продлением на предоплаченную. * Пополните предоплаченную подписку.

object ( PausedStateContext )

Дополнительный контекст приостановленных подписок. Присутствует только в том случае, если подписка в настоящее время имеет свойство subscribeState SUBSCRIPTION_STATE_PAUSED.

object ( CanceledStateContext )

Дополнительный контекст отмененных подписок. Присутствует только в том случае, если подписка в настоящее время имеет состояние подписки SUBSCRIPTION_STATE_CANCELED или SUBSCRIPTION_STATE_EXPIRED.

object ( TestPurchase )

Присутствует только в том случае, если эта покупка подписки является тестовой.

enum ( AcknowledgementState )

Состояние подтверждения подписки.

object ( ExternalAccountIdentifiers )

Идентификатор учетной записи пользователя в стороннем сервисе.

object ( SubscribeWithGoogleInfo )

Профиль пользователя, связанный с покупками, совершенными с помощью «Подписки через Google».

{
  "autoResumeTime": string
}

string ( Timestamp format)

Время, когда подписка будет автоматически возобновлена.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "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 )

Подписка отменена пользователем.

object ( SystemInitiatedCancellation )

Подписка была отменена системой, например, из-за проблемы с выставлением счетов.

object ( DeveloperInitiatedCancellation )

Подписка отменена разработчиком.

object ( ReplacementCancellation )

Подписка заменена на новую.

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

object ( CancelSurveyResult )

Информация, предоставляемая пользователем при завершении процесса отмены подписки (опрос причины отмены).

string ( Timestamp format)

Время, когда подписка была отменена пользователем. По истечении этого времени у пользователя может остаться доступ к подписке. Используйте lineItems.expiry_time, чтобы определить, есть ли у пользователя доступ.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

enum ( CancelSurveyReason )

Причина, которую пользователь выбрал в опросе об отмене.

string

Установлено только для CANCEL_SURVEY_REASON_OTHERS. Это произвольный ответ пользователя на опрос.

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

string

Идентификатор учетной записи пользователя в стороннем сервисе. Отображается только в том случае, если привязка учетной записи произошла в рамках процесса покупки подписки.

string

Запутанная версия идентификатора, которая однозначно связана с учетной записью пользователя в вашем приложении. Присутствует для следующих покупок: * Если привязка учетной записи произошла в рамках процесса покупки подписки. * Он был указан с помощью https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid при совершении покупки.

string

Запутанная версия идентификатора, которая однозначно связана с профилем пользователя в вашем приложении. Присутствует только в том случае, если указано с помощью https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid при совершении покупки.

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

string

Идентификатор профиля Google пользователя на момент приобретения подписки.

string

Имя профиля пользователя на момент приобретения подписки.

string

Адрес электронной почты пользователя на момент приобретения подписки.

string

Имя пользователя при покупке подписки.

string

Фамилия пользователя на момент приобретения подписки.

{
  "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

Идентификатор приобретенного продукта (например, «Monthly001»).

string ( Timestamp format)

Время, когда подписка истекла или истечет, если доступ не будет продлен (например, продлен).

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

object ( AutoRenewingPlan )

Товар обновляется автоматически.

object ( PrepaidPlan )

Товар предоплачен.

object ( OfferDetails )

Подробности предложения для этого товара.

object ( DeferredItemReplacement )

Информация об отсроченной замене товара.

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

boolean

Если подписка в настоящее время настроена на автоматическое продление, например, пользователь не отменил подписку.

object ( SubscriptionItemPriceChangeDetails )

Информация о последнем изменении цены товара с момента оформления подписки.

object ( InstallmentPlan )

Обязательства по рассрочке и информация о состоянии для плана автоматического продления.

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

object ( Money )

Новая повторяющаяся цена для элемента подписки.

enum ( PriceChangeMode )

Режим изменения цены определяет, как будет меняться цена элемента подписки.

enum ( PriceChangeState )

Укажите, в настоящее время происходит изменение цен.

string ( Timestamp format)

Время продления, после которого изменение цены вступит в силу для пользователя. Это может быть изменено (на будущее время) в связи со случаями, когда время обновления сдвигается, как пауза. Это поле заполняется только в том случае, если изменение цены не вступило в силу.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

integer

Общее количество платежей, которые пользователь изначально совершил.

integer

Общее количество платежей, которые пользователь будет совершать после каждого периода действия обязательств. Пусто означает, что после первоначального обязательства для плана рассрочки будет использована обычная подписка с автоматическим продлением.

integer

Общее количество подтвержденных платежей, которые осталось оплатить в этом цикле продления.

object ( PendingCancellation )

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

{
  "allowExtendAfterTime": string
}

string ( Timestamp format)

Если этот параметр присутствует, это время, по истечении которого для предоплаченного плана разрешены пополнения счета. Не будет присутствовать для предоплаченных планов с истекшим сроком действия.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

string

Теги последних предложений, связанные с предложением. Он включает в себя теги, унаследованные от базового плана.

string

Идентификатор базового плана. Присутствует для всех базовых планов и предложений.

string

Идентификатор предложения. Присутствует только для предложений со скидкой.

{
  "productId": string
}

string

ProductId заменит существующий ProductId.