REST Resource: externaltransactions

Ресурс: ВнешняяТранзакция

Детали внешней транзакции.

JSON-представление
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
Поля
packageName

string

Только вывод. Имя ресурса внешней транзакции. Название пакета приложения, в котором были проданы продукты inapp (например, «com.some.app»).

externalTransactionId

string

Только вывод. Идентификатор этой транзакции. Все идентификаторы транзакций под одним и тем же именем пакета должны быть уникальными. Устанавливается при создании внешней транзакции.

originalPreTaxAmount

object ( Price )

Необходимый. Первоначальная сумма транзакции до уплаты налогов. Это сумма до уплаты налогов, первоначально сообщенная Google до того, как были применены какие-либо возмещения.

originalTaxAmount

object ( Price )

Необходимый. Исходная сумма налога. Это сумма налога, первоначально сообщенная Google до того, как были применены какие-либо возмещения.

currentPreTaxAmount

object ( Price )

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

currentTaxAmount

object ( Price )

Только вывод. Текущая сумма налога. Это представляет собой текущую сумму налога, включая любые возмещения, которые могли быть применены к этой транзакции.

testPurchase

object ( ExternalTransactionTestPurchase )

Только вывод. Если установлено, эта транзакция была пробной покупкой. Google не взимает плату за тестовую транзакцию.

transactionTime

string ( Timestamp format)

Необходимый. Время завершения транзакции.

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

createTime

string ( Timestamp format)

Только вывод. Время создания этой транзакции. Это время, когда Google был уведомлен о транзакции.

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

transactionState

enum ( TransactionState )

Только вывод. Текущее состояние транзакции.

userTaxAddress

object ( ExternalTransactionAddress )

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

transactionProgramCode

integer

Необязательный. Код программы транзакции, используемый для определения платы за обслуживание для соответствующих приложений, участвующих в партнерских программах. Разработчики, участвующие в программе Play Media Experience ( https://play.google.com/console/about/programs/mediaprogram/ ), должны предоставить код программы при сообщении об альтернативных платежных транзакциях. Если вы являетесь подходящим разработчиком, обратитесь к своему BDM за дополнительной информацией о том, как настроить это поле. Примечание: это поле нельзя использовать для транзакций внешних предложений.

externalOfferInitialAcquisitionDetails

object ( ExternalOfferInitialAcquisitionDetails )

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

Поле объединения transaction_type . Тип выполненной транзакции. transaction_type может быть только одним из следующих:
oneTimeTransaction

object ( OneTimeExternalTransaction )

Это разовая транзакция, а не часть подписки.

recurringTransaction

object ( RecurringExternalTransaction )

Эта транзакция является частью повторяющейся серии транзакций.

ВнешняяТранзакцияТестПокупка

Этот тип не имеет полей.

Представляет транзакцию, выполненную с использованием тестовой учетной записи. Google не будет взимать плату за эти транзакции.

OneTimeExternalTransaction

Представляет собой одноразовую транзакцию.

JSON-представление
{
  "externalTransactionToken": string
}
Поля
externalTransactionToken

string

Только ввод. Предоставляется во время вызова Create. Получается от клиента при запуске альтернативного потока выставления счетов.

Повторяющаяся внешняя транзакция

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

JSON-представление
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
Поля

source поля Союза.

source может быть только одним из следующих:

initialExternalTransactionId

string

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

externalTransactionToken

string

Только ввод. Предоставляется во время вызова Create. Получается от клиента при запуске альтернативного потока выставления счетов. Требуется только для первоначальной покупки.

migratedTransactionProgram

enum ( ExternalTransactionProgram )

Только ввод. Предоставляется во время вызова Create. Следует использовать только при переносе подписки с ежемесячной отчетности вручную на автоматическую отчетность.

Поле объединения product_details . Необходимый. Подробная информация о продукте в повторяющейся внешней транзакции. product_details может быть только одним из следующих:
externalSubscription

object ( ExternalSubscription )

Подробности внешней подписки.

otherRecurringProduct

object ( OtherRecurringProduct )

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

Программа внешней транзакции

Представляет внешнюю программу транзакций, которую использует пользователь для завершения транзакции.

Перечисления
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Неуказанная программа транзакций. Не используется.
USER_CHOICE_BILLING Биллинг по выбору пользователя: пользователь может выбирать между биллингом Google Play, управляемым разработчиком.
ALTERNATIVE_BILLING_ONLY Только альтернативный биллинг, при котором пользователи могут использовать только биллинг менеджера-разработчика.

Внешняя подписка

Подробности внешней подписки.

JSON-представление
{
  "subscriptionType": enum (SubscriptionType)
}
Поля
subscriptionType

enum ( SubscriptionType )

Необходимый. Тип внешней подписки.

Тип подписки

Виды внешней подписки.

Перечисления
SUBSCRIPTION_TYPE_UNSPECIFIED Не указано, не использовать.
RECURRING Это повторяющаяся подписка, при которой с пользователя взимается плата за каждый платежный цикл.
PREPAID Это предоплаченная подписка, при которой пользователь платит авансом.

ДругоеПериодическийПродукт

Этот тип не имеет полей.

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

состояние транзакции

Состояние совершаемой транзакции.

Перечисления
TRANSACTION_STATE_UNSPECIFIED Неопределенное состояние транзакции. Не используется.
TRANSACTION_REPORTED О транзакции было успешно сообщено в Google.
TRANSACTION_CANCELED Сделка была полностью возмещена.

Адрес внешней транзакции

Адрес пользователя для внешней транзакции.

JSON-представление
{
  "regionCode": string,
  "administrativeArea": string
}
Поля
regionCode

string

Необходимый. Двухбуквенный код региона на основе ISO-3166-1 Alpha-2 (коды регионов ООН).

administrativeArea

string

Необязательный. Высшее административное подразделение страны/региона. Требуется только для транзакций в Индии. Допустимые значения: «АНДАМАНСКИЕ И НИКОБАРСКИЕ ОСТРОВА», «АНДРА-ПРАДЕШ», «АРУНАЧАЛ-ПРАДЕШ», «АССАМ», «БИХАР», «ЧАНДИГАРХ», «ЧХАТТИСГАРХ», «ДАДРА И НАГАР ХАВЕЛИ», «ДАДРА И НАГАР ХАВЕЛИ И ДАМАН». И ДИУ", "ДАМАН И ДИУ", "ДЕЛИ", "ГОА", "ГУДЖАРАТ", "ХАРЬЯНА", "ХИМАЧАЛ-ПРАДЕШ", "ДЖАММУ И КАШМИР", "ДЖАРКХАНД", "КАРНАТАКА", "КЕРАЛА", " ЛАДАКХ", "ЛАКШАДВИП", "МАДХЬЯ-ПРАДЕШ", "МАХАРАШТРА", "МАНИПУР", "МЕГАЛАЙЯ", "МИЗОРАМ", "НАГАЛЕНД", "ОДИША", "ПУДУЧЕРИ", "ПЕНДЖАБ", "РАДЖАСТАН", "СИККИМ" ", "ТАМИЛ НАДУ", "ТЕЛАНГАНА", "ТРИПУРА", "УТТАР-ПРАДЕШ", "УТТАРАХАНД" и "ЗАПАДНАЯ БЕНГАЛИЯ".

ВнешнийПредложениеНачальноеПриобретениеДетали

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

JSON-представление
{
  "externalTransactionId": string
}
Поля
externalTransactionId

string

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

Методы

createexternaltransaction

Создает новую внешнюю транзакцию.

getexternaltransaction

Получает существующую внешнюю транзакцию.

refundexternaltransaction

Возвращает или частично возвращает существующую внешнюю транзакцию.