- Ресурс SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PlanTransitionDetails
- TransitionInfo
- TransitionState
- PriceStepUpConsentDetails
- ConsentState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- ItemReplacement
- ReplacementMode
- OfferPhase
- ProrationPeriodOfferPhase
- OriginalOfferPhaseType
- FreeTrialOfferPhase
- IntroductoryPriceOfferPhase
- BasePriceOfferPhase
- DeveloperTargetedOffer
- OutOfAppPurchaseContext
- OnHoldStateContext
- RenewalDeclinedContext
- InGracePeriodStateContext
- Методы
Ресурс: SubscriptionPurchaseV2
Указывает статус покупки подписки пользователем.
| JSON-представление |
|---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
| Поля | |
|---|---|
kind |
Этот тип представляет объект SubscriptionPurchaseV2 в сервисе androidpublisher. |
regionCode |
Код страны или региона нахождения платежного адреса пользователя в формате ISO 3166-1 alpha-2 на момент предоставления подписки. |
lineItems[] |
Информация о покупке подписки на уровне товара. Все товары в одной покупке должны быть либо с AutoRenewingPlan, либо с PrepaidPlan. |
startTime |
Время, когда подписка была предоставлена. Не задано для ожидающих подписок (подписка создана, но ожидает оплаты при регистрации). Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
subscriptionState |
Текущий статус подписки. |
linkedPurchaseToken |
Токен покупки старой подписки, если текущая подписка: * оформлена повторно после отмены, но до истечения срока действия; * оформлена в результате перехода на другой тарифный план. * Переход с предоплаченного плана на подписку с автоматическим продлением. * Переход с подписки с автоматическим продлением на предоплаченный план. * Пополнить баланс предоплаченной подписки. |
pausedStateContext |
Дополнительная информация о приостановленных подписках. Присутствует, только если подписка в настоящее время имеет статус SUBSCRIPTION_STATE_PAUSED. |
canceledStateContext |
Дополнительная информация об отмененных подписках. Указывается, только если подписка имеет статус SUBSCRIPTION_STATE_CANCELED или SUBSCRIPTION_STATE_EXPIRED. |
testPurchase |
Присутствует, только если покупка подписки является тестовой. |
acknowledgementState |
Статус подтверждения подписки. |
externalAccountIdentifiers |
Идентификатор аккаунта пользователя в стороннем сервисе. |
subscribeWithGoogleInfo |
Профиль пользователя, связанный с покупками, совершенными через сервис "Подписка через Google". |
etag |
Тег объекта, представляющий текущее состояние подписки. Разработчик будет предоставлять этот тег etag для действий с подписками. Этот тег всегда присутствует для подписок с автоматическим продлением и предоплатой. |
outOfAppPurchaseContext |
Дополнительная информация о покупках вне приложения. Эта информация доступна только для покупок, совершенных через центр подписок Google Play после окончания срока действия предыдущей подписки на тот же продукт. Это поле будет удалено после подтверждения подписки. |
onHoldStateContext |
Необязательное поле. Дополнительная информация о подписках в статусе ON_HOLD. Указывается, только если подписка имеет статус subscriptionState SUBSCRIPTION_STATE_ON_HOLD. |
inGracePeriodStateContext |
Необязательное поле. Дополнительная информация о подписках в статусе IN_GRACE_PERIOD. Указывается, только если у подписки в настоящее время есть subscriptionState SUBSCRIPTION_STATE_IN_GRACE_PERIOD. |
SubscriptionState
Возможные статусы подписки, например "активна" или "отменена". В рамках одной покупки можно приобрести только планы с автоматическим продлением или только планы с предоплатой.
| Перечисления | |
|---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
Статус подписки не указан. |
SUBSCRIPTION_STATE_PENDING |
Подписка создана, но ожидает оплаты во время регистрации. В этом состоянии все товары ожидают оплаты. |
SUBSCRIPTION_STATE_ACTIVE |
Подписка активна. 1. Если подписка оформлена по тарифному плану с автоматическим продлением, хотя бы для одного элемента должно быть задано значение autoRenewEnabled и не должен истечь срок действия. - 2) Если подписка оформлена по предоплате, срок действия хотя бы одного элемента не истек. |
SUBSCRIPTION_STATE_PAUSED |
Подписка приостановлена. Это состояние доступно только для тарифных планов с автоматическим продлением. В этом состоянии все элементы приостановлены. |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
Для подписки действует льготный период. Это состояние доступно только для тарифных планов с автоматическим продлением. В этом состоянии все элементы находятся в льготном периоде. |
SUBSCRIPTION_STATE_ON_HOLD |
Подписка заблокирована. Это состояние доступно только для тарифных планов с автоматическим продлением. В этом состоянии все объекты находятся на хранении. |
SUBSCRIPTION_STATE_CANCELED |
Подписка отменена, но срок ее действия ещё не истек. Это состояние доступно только для тарифных планов с автоматическим продлением. Для всех элементов параметр autoRenewEnabled имеет значение false. |
SUBSCRIPTION_STATE_EXPIRED |
Срок действия подписки истек. У всех товаров значение expiryTime в прошлом. |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
Транзакция в обработке для подписки отменена. Если эта незавершенная покупка была для существующей подписки, используйте linkedPurchaseToken, чтобы узнать текущее состояние этой подписки. |
PausedStateContext
Информация о приостановленной подписке.
| JSON-представление |
|---|
{ "autoResumeTime": string } |
| Поля | |
|---|---|
autoResumeTime |
Время, когда подписка будет автоматически возобновлена. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
CanceledStateContext
Информация о подписке со статусом SUBSCRIPTION_STATE_CANCELED или SUBSCRIPTION_STATE_EXPIRED.
| JSON-представление |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "userInitiatedCancellation": { object ( |
| Поля | |
|---|---|
| Причина отмены подписки. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
userInitiatedCancellation |
Подписка отменена пользователем. |
systemInitiatedCancellation |
Подписка была отменена системой, например из-за проблем с оплатой. |
developerInitiatedCancellation |
Подписка отменена разработчиком. |
replacementCancellation |
Подписка была заменена новой. |
| Конец взаимоисключающих полей. | |
UserInitiatedCancellation
Информация об отменах, инициированных пользователями.
| JSON-представление |
|---|
{
"cancelSurveyResult": {
object ( |
| Поля | |
|---|---|
cancelSurveyResult |
Информация, предоставленная пользователем при отмене подписки (опрос о причине отмены). |
cancelTime |
Время, когда пользователь отменил подписку. Пользователь может сохранить доступ к подписке после этого времени. Чтобы определить, есть ли у пользователя доступ, используйте lineItems.expiry_time. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
CancelSurveyResult
Результаты опроса, который пользователь прошел при отмене подписки.
| JSON-представление |
|---|
{
"reason": enum ( |
| Поля | |
|---|---|
reason |
Причина, которую пользователь выбрал в опросе при отмене. |
reasonUserInput |
Задается только для CANCEL_SURVEY_REASON_OTHERS. Это ответ пользователя на опрос в свободной форме. |
CancelSurveyReason
Причина, которую пользователь выбрал в опросе при отмене.
| Перечисления | |
|---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
Неизвестная причина отмены опроса. |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
Подписка используется недостаточно. |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
Технические проблемы при использовании приложения. |
CANCEL_SURVEY_REASON_COST_RELATED |
Проблемы, связанные с ценой. |
CANCEL_SURVEY_REASON_FOUND_BETTER_APP |
Пользователь нашел более подходящее приложение. |
CANCEL_SURVEY_REASON_OTHERS |
Другие причины. |
SystemInitiatedCancellation
У этого типа нет полей.
Информация об отмене, инициированной системой Google.
DeveloperInitiatedCancellation
У этого типа нет полей.
Информация об отменах, инициированных разработчиками.
ReplacementCancellation
У этого типа нет полей.
Информация об отменах, вызванных заменой подписки.
TestPurchase
У этого типа нет полей.
Является ли покупка подписки тестовой.
AcknowledgementState
Возможные статусы подтверждения подписки.
| Перечисления | |
|---|---|
ACKNOWLEDGEMENT_STATE_UNSPECIFIED |
Статус подтверждения не указан. |
ACKNOWLEDGEMENT_STATE_PENDING |
Подписка ещё не подтверждена. |
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED |
Подписка подтверждена. |
ExternalAccountIdentifiers
Идентификатор аккаунта пользователя в стороннем сервисе.
| JSON-представление |
|---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
| Поля | |
|---|---|
externalAccountId |
Идентификатор аккаунта пользователя в стороннем сервисе. Присутствует, только если связывание аккаунтов произошло в рамках процесса покупки подписки. |
obfuscatedExternalAccountId |
Замаскированная версия идентификатора, уникально связанного с аккаунтом пользователя в вашем приложении. Присутствует для следующих покупок: * Если связывание аккаунтов произошло в рамках процесса покупки подписки. * Он был указан с помощью https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid при совершении покупки. |
obfuscatedExternalProfileId |
Замаскированная версия идентификатора, который уникальным образом связан с профилем пользователя в вашем приложении. Присутствует, только если при совершении покупки был указан параметр https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid. |
SubscribeWithGoogleInfo
Информация о покупках, совершенных с помощью сервиса "Подписка через Google".
| JSON-представление |
|---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
| Поля | |
|---|---|
profileId |
Идентификатор профиля Google пользователя, который приобрел подписку. |
profileName |
Имя профиля пользователя на момент покупки подписки. |
emailAddress |
Адрес электронной почты пользователя, который был указан при покупке подписки. |
givenName |
Имя пользователя, указанное при покупке подписки. |
familyName |
Фамилия пользователя на момент покупки подписки. |
SubscriptionPurchaseLineItem
Информация о покупке подписки на уровне товара.
| JSON-представление |
|---|
{ "productId": string, "expiryTime": string, "developerTargetedOffers": [ { object ( |
| Поля | |
|---|---|
productId |
Идентификатор купленного товара, например monthly001. |
expiryTime |
Время, когда срок действия подписки истек или истечет, если доступ не будет продлен (например, при продлении подписки). Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
developerTargetedOffers[] |
Необязательное поле. Сведения о предложениях для разработчиков, зарегистрированных для этой позиции. |
latestSuccessfulOrderId |
Идентификатор последнего успешного заказа, связанного с этим товаром. Не указывается, если пользователь ещё не владеет объектом (например, если объект заменяется отложенным). |
| Тип подписки. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
autoRenewingPlan |
Объект продлевается автоматически. |
prepaidPlan |
Товар оплачен заранее. |
| Конец взаимоисключающих полей. | |
offerDetails |
Сведения о предложении для этого товара. |
| Это поле присутствует, если у объекта есть отложенное изменение. Его можно удалить или заменить. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
deferredItemReplacement |
Информация об отложенной замене товара. |
deferredItemRemoval |
Информация об отложенном удалении объекта. |
| Конец взаимоисключающих полей. | |
signupPromotion |
Информация о промоакции для этого товара. Задается, только если при регистрации была применена промоакция. |
itemReplacement |
Сведения о заменяемом объекте. Это поле заполняется, только если объект заменил другой объект в предыдущей подписке, и доступно только в течение 60 дней после покупки. |
offerPhase |
Сведения о текущем периоде специального предложения для этого объекта. |
AutoRenewingPlan
Информация о тарифном плане с автоматическим продлением.
| JSON-представление |
|---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
| Поля | |
|---|---|
autoRenewEnabled |
Если для подписки настроено автоматическое продление, например пользователь не отменил ее. |
recurringPrice |
Текущая регулярная цена тарифного плана с автоматическим продлением. Обратите внимание, что цена не учитывает скидки и налоги. Если вам нужны сведения о транзакциях, используйте |
priceChangeDetails |
Информация о последнем изменении цены на товар с момента оформления подписки. |
installmentDetails |
Информация об обязательствах и статусе тарифного плана с автоматическим продлением в рассрочку. |
planTransitionDetails |
Информация о связанном переходе на другой тарифный план. Будет присутствовать, только если с этим планом связан план перехода, и будет включать только последние сведения о переходе, связанные с элементом. |
priceStepUpConsentDetails |
Информация о последнем согласии на повышение цены. |
SubscriptionItemPriceChangeDetails
Информация об изменении цены на подписку.
| JSON-представление |
|---|
{ "newPrice": { object ( |
| Поля | |
|---|---|
newPrice |
Новая цена за регулярный платеж по подписке. |
priceChangeMode |
Режим изменения цены определяет, как меняется цена на объект подписки. |
priceChangeState |
Укажите, на каком этапе находится изменение цены. |
expectedNewPriceChargeTime |
Время продления, когда изменение цены вступит в силу для пользователя. Время продления может быть перенесено на более поздний срок, например если подписка была приостановлена. Это поле заполняется, только если изменение цены ещё не вступило в силу. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
PriceChangeMode
Способ изменения цены.
| Перечисления | |
|---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
Режим изменения цены не указан. Это значение не должно быть задано. |
PRICE_DECREASE |
Если цена подписки снижается. |
PRICE_INCREASE |
Если цена подписки повышается и пользователю нужно принять ее. |
OPT_OUT_PRICE_INCREASE |
Если цена подписки повышается без запроса согласия. |
PriceChangeState
Статус изменения цены.
| Перечисления | |
|---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
Статус изменения цены не указан. Это значение не должно использоваться. |
OUTSTANDING |
Ожидание согласия пользователя на изменение цены. |
CONFIRMED |
Пользователь подтвердил изменение цены. |
APPLIED |
Изменение цены вступило в силу, то есть с пользователя начала списываться новая цена. |
CANCELED |
Изменение цены отменено. |
InstallmentPlan
Информация о рассрочке.
| JSON-представление |
|---|
{
"initialCommittedPaymentsCount": integer,
"subsequentCommittedPaymentsCount": integer,
"remainingCommittedPaymentsCount": integer,
"pendingCancellation": {
object ( |
| Поля | |
|---|---|
initialCommittedPaymentsCount |
Общее количество платежей, которые пользователь должен совершить. |
subsequentCommittedPaymentsCount |
Общее количество платежей, которые пользователь должен будет совершить после каждого минимального срока подписки. Если оставить поле пустым, то после первоначального обязательного периода рассрочка будет заменена на обычную подписку с автоматическим продлением. |
remainingCommittedPaymentsCount |
Общее количество обязательных платежей, которые осталось внести в текущем цикле продления. |
pendingCancellation |
Если этот параметр указан, значит рассрочка будет отменена. Отмена произойдет только после того, как пользователь внесет все обязательные платежи. |
PendingCancellation
У этого типа нет полей.
Указывает, есть ли ожидающая отмена виртуального плана рассрочки. Отмена произойдет только после того, как пользователь внесет все обязательные платежи.
PlanTransitionDetails
Информация о переходе на другой тарифный план.
| JSON-представление |
|---|
{
"productId": string,
"basePlanId": string,
"offerId": string,
"transitionInfo": {
object ( |
| Поля | |
|---|---|
productId |
[Обязательно] Идентификатор товара, на который будет осуществлен переход (например, monthly001). |
basePlanId |
[Обязательно] Идентификатор основного плана, на который будет выполнен переход. |
offerId |
Идентификатор предложения. Указывается только для специальных предложений. Это значение задается, только если целевой план не является основным. |
transitionInfo |
Дополнительная информация о запланированном переходе на другой тарифный план. Будет присутствовать, только если запланирован переход на другой план. |
TransitionInfo
Информация о запланированном переходе на другой тарифный план.
| JSON-представление |
|---|
{ "transitionState": enum ( |
| Поля | |
|---|---|
transitionState |
Только для вывода. [Обязательный параметр] Текущий статус перехода. |
price |
Цена основного плана по умолчанию, на который будет выполнен переход. |
expectedTransitionTime |
Текущее ожидаемое время, когда может быть осуществлен переход на план. Это время может измениться, если подписка была приостановлена или аккаунт был временно заблокирован. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
TransitionState
Возможные состояния перехода.
| Перечисления | |
|---|---|
TRANSITION_STATE_UNSPECIFIED |
Неуказанное состояние перехода. |
SCHEDULED |
Переход запланирован на будущее. |
IN_PROGRESS |
Процесс перехода запущен, и пользователю отправлено первое уведомление о переходе. |
COMPLETED |
Переход завершен. |
CANCELED |
Переход был отменен. |
PriceStepUpConsentDetails
Информация о повышении цены, требующем согласия пользователя.
| JSON-представление |
|---|
{ "state": enum ( |
| Поля | |
|---|---|
state |
Только для вывода. Статус согласия на повышение цены. |
consentDeadlineTime |
Крайний срок, до которого пользователь должен дать согласие. Если вы не дадите согласие до этого времени, подписка будет отменена. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
newPrice |
Новая цена, которая требует согласия пользователя. |
ConsentState
Статус согласия на повышение цены.
| Перечисления | |
|---|---|
CONSENT_STATE_UNSPECIFIED |
Статус согласия не указан. |
PENDING |
Пользователь ещё не дал согласие. |
CONFIRMED |
Пользователь дал согласие, и новая цена скоро вступит в силу. |
COMPLETED |
Пользователь дал согласие, и новая цена вступила в силу. |
PrepaidPlan
Информация о тарифном плане с предоплатой.
| JSON-представление |
|---|
{ "allowExtendAfterTime": string } |
| Поля | |
|---|---|
allowExtendAfterTime |
Если это поле заполнено, то в нем указано время, после которого можно пополнять баланс предоплаченного плана. Недоступно для тарифных планов с предоплатой, срок действия которых истек. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
OfferDetails
Информация о предложении, связанная с позицией покупки.
| JSON-представление |
|---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
| Поля | |
|---|---|
offerTags[] |
Последние теги, связанные со специальным предложением. Включает теги, унаследованные от основного плана. |
basePlanId |
Идентификатор основного плана. Указывается для всех основных планов и специальных предложений. |
offerId |
Идентификатор предложения. Указывается только для специальных предложений. |
DeferredItemReplacement
Информация об отложенной замене товара.
| JSON-представление |
|---|
{ "productId": string } |
| Поля | |
|---|---|
productId |
Идентификатор товара, который заменит существующий. |
DeferredItemRemoval
У этого типа нет полей.
Информация об отложенной замене товара.
SignupPromotion
Промоакция, примененная к этому товару при покупке.
| JSON-представление |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "oneTimeCode": { object ( |
| Поля | |
|---|---|
| Тип промоакции, примененной к товару. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
oneTimeCode |
Применен одноразовый код. |
vanityCode |
Применен код Vanity. |
| Конец взаимоисключающих полей. | |
OneTimeCode
У этого типа нет полей.
Одноразовый промокод.
VanityCode
Многоразовый промокод, заданный заранее.
| JSON-представление |
|---|
{ "promotionCode": string } |
| Поля | |
|---|---|
promotionCode |
Промокод. |
ItemReplacement
Сведения о заменяемой позиции подписки.
| JSON-представление |
|---|
{
"productId": string,
"replacementMode": enum ( |
| Поля | |
|---|---|
productId |
Идентификатор товара заменяемой позиции подписки. |
replacementMode |
Режим замены, примененный во время покупки. |
basePlanId |
Идентификатор основного плана заменяемой позиции подписки. |
offerId |
Идентификатор предложения, относящегося к заменяемой строке подписки (если применимо). |
ReplacementMode
Режим замены подписки.
| Перечисления | |
|---|---|
REPLACEMENT_MODE_UNSPECIFIED |
Режим замены не указан. |
WITH_TIME_PRORATION |
Стоимость нового тарифного плана будет рассчитана пропорционально и зачислена со старого тарифного плана. |
CHARGE_PRORATED_PRICE |
С пользователя будет списана сумма, пропорциональная остатку текущего платежного цикла. |
WITHOUT_PRORATION |
Новый тарифный план заменит старый без пропорционального пересчета времени. |
CHARGE_FULL_PRICE |
С пользователя будет списана полная стоимость нового плана. |
DEFERRED |
Старый тарифный план будет отменен, а новый начнет действовать после окончания срока действия старого. |
KEEP_EXISTING |
При такой замене тарифный план останется прежним. |
OfferPhase
Сведения о периоде специального предложения.
| JSON-представление |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "prorationPeriod": { object ( |
| Поля | |
|---|---|
| Сведения о периоде специального предложения. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
prorationPeriod |
Устанавливается, когда этап специального предложения является периодом пропорциональной оплаты. |
freeTrial |
Указывается, если этап предложения – бесплатный пробный период. |
introductoryPrice |
Указывается, если этап предложения является этапом предложения с начальной ценой. |
basePrice |
Укажите, когда этап специального предложения является этапом цены основного плана. |
| Конец взаимоисключающих полей. | |
ProrationPeriodOfferPhase
Подробная информация о периоде пропорциональной оплаты.
| JSON-представление |
|---|
{
"originalOfferPhaseType": enum ( |
| Поля | |
|---|---|
originalOfferPhaseType |
Тип исходного этапа специального предложения до периода пропорционального распределения. Устанавливается, только когда период пропорционального распределения обновляется из существующего этапа специального предложения. |
OriginalOfferPhaseType
Этап исходного предложения, к которому относится платеж, если платеж пропорциональный.
| Перечисления | |
|---|---|
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED |
Тип этапа исходного специального предложения не указан. |
BASE |
Подписка находится на этапе базовой цены (например, полной цены). |
INTRODUCTORY |
Подписка находится в периоде начальной цены. |
FREE_TRIAL |
Подписка находится в бесплатном пробном периоде. |
FreeTrialOfferPhase
У этого типа нет полей.
Сведения о бесплатном пробном периоде.
IntroductoryPriceOfferPhase
У этого типа нет полей.
Подробная информация о этапе специальной цены.
BasePriceOfferPhase
У этого типа нет полей.
Подробная информация об этапе специального предложения с базовой ценой.
DeveloperTargetedOffer
Информация о специальном предложении для разработчиков, связанном со строкой подписки.
| JSON-представление |
|---|
{ "offerId": string, "activateTime": string } |
| Поля | |
|---|---|
offerId |
Необязательное поле. Идентификатор предложения, созданного разработчиком для подписки. |
activateTime |
Необязательное поле. Время, когда был активирован таргетинг предложения. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
OutOfAppPurchaseContext
Информация о покупке вне приложения.
| JSON-представление |
|---|
{
"expiredExternalAccountIdentifiers": {
object ( |
| Поля | |
|---|---|
expiredExternalAccountIdentifiers |
Идентификатор аккаунта пользователя из последней истекшей подписки для этого SKU. |
expiredPurchaseToken |
Токен покупки последней подписки с истекшим сроком действия. Этот токен можно использовать для идентификации пользователя, только если связь между purchaseToken и пользователем хранится в вашей базе данных. Если с момента окончания срока действия прошло более 60 дней, то вызывать Google Developer API нельзя. |
OnHoldStateContext
Дополнительная информация о подписках в статусе ON_HOLD.
| JSON-представление |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"renewalDeclined": {
object ( |
| Поля | |
|---|---|
| Причина, по которой подписка находится в состоянии ON_HOLD. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
renewalDeclined |
Необязательное поле. Платеж за продление был отклонен. |
| Конец взаимоисключающих полей. | |
RenewalDeclinedContext
Контекст, связанный со сценарием отклонения продления.
| JSON-представление |
|---|
{ "pendingOrderId": string } |
| Поля | |
|---|---|
pendingOrderId |
Обязательно. Идентификатор заказа, который находится в состоянии ожидания или не был выполнен. |
InGracePeriodStateContext
Дополнительная информация о подписках в статусе IN_GRACE_PERIOD.
| JSON-представление |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"renewalDeclined": {
object ( |
| Поля | |
|---|---|
| Причина, по которой подписка находится в состоянии IN_GRACE_PERIOD. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
renewalDeclined |
Необязательное поле. Платеж за продление был отклонен. |
| Конец взаимоисключающих полей. | |
Методы |
|
|---|---|
|
Активирует таргетинг для определенного предложения. |
|
Отменить подписку пользователя. |
|
Отмена перехода на другой тарифный план для подписки. |
|
Отключает таргетинг для определенного предложения. |
|
Откладывает продление подписки. |
|
Получение метаданных о подписке |
|
Отменить покупку подписки для пользователя. |
|
Запланируйте переход на другой тарифный план. |
Коды ошибок
Операции этого ресурса возвращают следующие коды ошибок HTTP:
| Код ошибки | Причина | Описание | Разрешение |
|---|---|---|---|
400 / 410 |
subscriptionExpired |
Срок действия подписки истек, и запрошенную операцию выполнить нельзя. | Проверьте срок действия подписки. Это действие нельзя выполнить для подписок с истекшим сроком действия. |
400 |
subscriptionInvalidArgument |
В запросе на подписку указан недопустимый аргумент. | Изучите документацию по API и убедитесь, что все обязательные поля заполнены и правильно отформатированы. |
400 |
invalidPurchaseState |
Покупка не находится в состоянии, позволяющем выполнить запрошенную операцию. Например, вы пытаетесь подтвердить уже использованную покупку или отменить неактивную подписку. | Прежде чем выполнять операцию, проверьте текущее состояние ресурса с помощью соответствующего API Get. Убедитесь, что ресурс находится в состоянии, подходящем для этого действия. |
400 |
invalidValue |
В запросе указано недопустимое значение. Обычно это происходит, если токен покупки недействителен или неправильно оформлен. | Исправьте недопустимое значение поля в теле запроса или параметрах, следуя инструкциям в документации по API. |
400 |
prepaidSubscriptionNotSupported |
Запрошенная операция не поддерживается для подписок с предоплатой. | Убедитесь, что операция применима к типу подписки. Эта ошибка связана с такими методами, как Cancel. |
400 |
productNotOwnedByUser |
Указанный токен покупки действителен, но пользователь в настоящее время не владеет продуктом. Это может произойти, если до подтверждения покупки средства за нее были возвращены, она была аннулирована или срок ее действия истек. | Прежде чем выполнять операцию, проверьте текущее состояние ресурса с помощью соответствующего API Get. Убедитесь, что ресурс находится в состоянии, подходящем для этого действия. |
400 |
purchaseTokenMismatch |
Указанный токен покупки не соответствует покупке, названию пакета, идентификатору подписки или идентификатору товара. | Убедитесь, что все данные в запросе верны и соответствуют друг другу. |
400 |
required |
В запросе отсутствует обязательное поле или параметр. | Чтобы убедиться, что вы указали все обязательные поля и параметры, изучите документацию API. |
400 |
unsupportedIabType |
Операция не поддерживается для указанного типа оплаты контента. | Убедитесь, что метод API совместим с типом объекта, которым вы управляете. |
403 |
userInsufficientPermission |
У пользователя недостаточно разрешений для выполнения запрошенной операции. | Убедитесь, что у аутентифицированного пользователя есть необходимые разрешения в Google Play Console. Подробнее об использовании сервисного аккаунта… |
404 |
notFound |
Запрошенный ресурс не найден. | Проверьте, правильно ли указаны идентификаторы, например токен покупки, название пакета, идентификатор товара или подписки. |
409 |
concurrentUpdate |
Попытка обновить объект, который уже обновляется. | Повторите запрос с экспоненциальной выдержкой. Не изменяйте один и тот же ресурс одновременно. |
410 |
purchaseTokenNoLongerValid |
Токен покупки недействителен, поскольку связанный с ним аккаунт пользователя удален или запись о покупке больше не существует. | Прекратите использовать этот токен покупки. |
410 |
subscriptionNoLongerAvailable |
Запрос на покупку подписки больше недоступен, так как срок его действия истек слишком давно. | Эта ошибка означает, что срок действия подписки истек более 60 дней назад. Не запрашивайте эти подписки. |
5xx |
Generic error |
Общая ошибка на сервере Google Play. | Повторите запрос. Если проблема не исчезнет, обратитесь к менеджеру аккаунта Google Play или отправьте запрос в службу поддержки. Проверьте, нет ли известных сбоев, на панели мониторинга доступности Google Play. |