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,

  // 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.
}
Поля
package Name

string

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

external Transaction Id

string

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

original Pre Tax Amount

object ( Price )

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

original Tax Amount

object ( Price )

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

current Pre Tax Amount

object ( Price )

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

current Tax Amount

object ( Price )

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

test Purchase

object ( ExternalTransactionTestPurchase )

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

transaction Time

string ( Timestamp format)

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

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

create Time

string ( Timestamp format)

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

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

transaction State

enum ( TransactionState )

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

user Tax Address

object ( ExternalTransactionAddress )

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

transaction Program Code

integer

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

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

object ( OneTimeExternalTransaction )

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

recurring Transaction

object ( RecurringExternalTransaction )

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

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

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

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

OneTimeExternalTransaction

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

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

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 может быть только одним из следующих:

initial External Transaction Id

string

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

external Transaction Token

string

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

migrated Transaction Program

enum ( ExternalTransactionProgram )

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

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

object ( ExternalSubscription )

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

other Recurring Product

object ( OtherRecurringProduct )

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

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

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

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

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

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

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

enum ( SubscriptionType )

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

Тип подписки

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

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

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

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

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

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

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

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

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

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

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

string

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

administrative Area

string

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

Методы

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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