- Ресурс: ВнешняяТранзакция
- ВнешняяТранзакцияТестПокупка
- OneTimeExternalTransaction
- Повторяющаяся внешняя транзакция
- Программа внешней транзакции
- Внешняя подписка
- Тип подписки
- ДругоеПериодическийПродукт
- состояние транзакции
- Адрес внешней транзакции
- ВнешнийПредложениеНачальноеПриобретениеДетали
- Методы
Ресурс: ВнешняяТранзакция
Детали внешней транзакции.
JSON-представление |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
Поля | |
---|---|
packageName | Только вывод. Имя ресурса внешней транзакции. Название пакета приложения, в котором были проданы продукты inapp (например, «com.some.app»). |
externalTransactionId | Только вывод. Идентификатор этой транзакции. Все идентификаторы транзакций под одним и тем же именем пакета должны быть уникальными. Устанавливается при создании внешней транзакции. |
originalPreTaxAmount | Необходимый. Первоначальная сумма транзакции до уплаты налогов. Это сумма до уплаты налогов, первоначально сообщенная Google до того, как были применены какие-либо возмещения. |
originalTaxAmount | Необходимый. Исходная сумма налога. Это сумма налога, первоначально сообщенная Google до того, как были применены какие-либо возмещения. |
currentPreTaxAmount | Только вывод. Текущая сумма транзакции до налогообложения. Это представляет собой текущую сумму до уплаты налогов, включая любые возмещения, которые могли быть применены к этой транзакции. |
currentTaxAmount | Только вывод. Текущая сумма налога. Это представляет собой текущую сумму налога, включая любые возмещения, которые могли быть применены к этой транзакции. |
testPurchase | Только вывод. Если установлено, эта транзакция была пробной покупкой. Google не взимает плату за тестовую транзакцию. |
transactionTime | Необходимый. Время завершения транзакции. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
createTime | Только вывод. Время создания этой транзакции. Это время, когда Google был уведомлен о транзакции. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
transactionState | Только вывод. Текущее состояние транзакции. |
userTaxAddress | Необходимый. Адрес пользователя для расчета налогов. |
transactionProgramCode | Необязательный. Код программы транзакции, используемый для определения платы за обслуживание для соответствующих приложений, участвующих в партнерских программах. Разработчики, участвующие в программе Play Media Experience ( https://play.google.com/console/about/programs/mediaprogram/ ), должны предоставить код программы при сообщении об альтернативных платежных транзакциях. Если вы являетесь подходящим разработчиком, обратитесь к своему BDM за дополнительной информацией о том, как настроить это поле. Примечание: это поле нельзя использовать для транзакций внешних предложений. |
externalOfferInitialAcquisitionDetails | Необязательный. Подробная информация о том, когда пользователь/устройство впервые завершил транзакцию с использованием внешних предложений. Не требуется для транзакций, совершаемых только с использованием биллинга по выбору пользователя или альтернативного биллинга. |
Поле объединения transaction_type . Тип выполненной транзакции. transaction_type может быть только одним из следующих: | |
oneTimeTransaction | Это разовая транзакция, а не часть подписки. |
recurringTransaction | Эта транзакция является частью повторяющейся серии транзакций. |
ВнешняяТранзакцияТестПокупка
Этот тип не имеет полей.
Представляет транзакцию, выполненную с использованием тестовой учетной записи. Google не будет взимать плату за эти транзакции.
OneTimeExternalTransaction
Представляет собой одноразовую транзакцию.
JSON-представление |
---|
{ "externalTransactionToken": string } |
Поля | |
---|---|
externalTransactionToken | Только ввод. Предоставляется во время вызова Create. Получается от клиента при запуске альтернативного потока выставления счетов. |
Повторяющаяся внешняя транзакция
Представляет транзакцию, которая является частью повторяющейся серии платежей. Это может быть подписка или разовый товар с несколькими платежами (например, предзаказ).
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
| |
initialExternalTransactionId | Идентификатор внешней транзакции первой транзакции в этой повторяющейся серии транзакций. Например, для подписки это будет идентификатор транзакции первого платежа. Требуется при создании повторяющихся внешних транзакций. |
externalTransactionToken | Только ввод. Предоставляется во время вызова Create. Получается от клиента при запуске альтернативного потока выставления счетов. Требуется только для первоначальной покупки. |
migratedTransactionProgram | Только ввод. Предоставляется во время вызова Create. Следует использовать только при переносе подписки с ежемесячной отчетности вручную на автоматическую отчетность. |
Поле объединения product_details . Необходимый. Подробная информация о продукте в повторяющейся внешней транзакции. product_details может быть только одним из следующих: | |
externalSubscription | Подробности внешней подписки. |
otherRecurringProduct | Подробная информация о продукте повторяющейся внешней транзакции, который не принадлежит какой-либо другой конкретной категории. |
Программа внешней транзакции
Представляет внешнюю программу транзакций, которую использует пользователь для завершения транзакции.
Перечисления | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED | Неуказанная программа транзакций. Не используется. |
USER_CHOICE_BILLING | Биллинг по выбору пользователя: пользователь может выбирать между биллингом Google Play, управляемым разработчиком. |
ALTERNATIVE_BILLING_ONLY | Только альтернативный биллинг, при котором пользователи могут использовать только биллинг менеджера-разработчика. |
Внешняя подписка
Подробности внешней подписки.
JSON-представление |
---|
{
"subscriptionType": enum ( |
Поля | |
---|---|
subscriptionType | Необходимый. Тип внешней подписки. |
Тип подписки
Виды внешней подписки.
Перечисления | |
---|---|
SUBSCRIPTION_TYPE_UNSPECIFIED | Не указано, не использовать. |
RECURRING | Это повторяющаяся подписка, при которой с пользователя взимается плата за каждый платежный цикл. |
PREPAID | Это предоплаченная подписка, при которой пользователь платит авансом. |
ДругоеПериодическийПродукт
Этот тип не имеет полей.
Подробная информация о продукте повторяющихся внешних транзакций, который не принадлежит какой-либо другой более конкретной категории.
состояние транзакции
Состояние совершаемой транзакции.
Перечисления | |
---|---|
TRANSACTION_STATE_UNSPECIFIED | Неопределенное состояние транзакции. Не используется. |
TRANSACTION_REPORTED | О транзакции было успешно сообщено в Google. |
TRANSACTION_CANCELED | Сделка была полностью возмещена. |
Адрес внешней транзакции
Адрес пользователя для внешней транзакции.
JSON-представление |
---|
{ "regionCode": string, "administrativeArea": string } |
Поля | |
---|---|
regionCode | Необходимый. Двухбуквенный код региона на основе ISO-3166-1 Alpha-2 (коды регионов ООН). |
administrativeArea | Необязательный. Высшее административное подразделение страны/региона. Требуется только для транзакций в Индии. Допустимые значения: «АНДАМАНСКИЕ И НИКОБАРСКИЕ ОСТРОВА», «АНДРА-ПРАДЕШ», «АРУНАЧАЛ-ПРАДЕШ», «АССАМ», «БИХАР», «ЧАНДИГАРХ», «ЧХАТТИСГАРХ», «ДАДРА И НАГАР ХАВЕЛИ», «ДАДРА И НАГАР ХАВЕЛИ И ДАМАН». И ДИУ", "ДАМАН И ДИУ", "ДЕЛИ", "ГОА", "ГУДЖАРАТ", "ХАРЬЯНА", "ХИМАЧАЛ-ПРАДЕШ", "ДЖАММУ И КАШМИР", "ДЖАРКХАНД", "КАРНАТАКА", "КЕРАЛА", " ЛАДАКХ", "ЛАКШАДВИП", "МАДХЬЯ-ПРАДЕШ", "МАХАРАШТРА", "МАНИПУР", "МЕГАЛАЙЯ", "МИЗОРАМ", "НАГАЛЕНД", "ОДИША", "ПУДУЧЕРИ", "ПЕНДЖАБ", "РАДЖАСТАН", "СИККИМ" ", "ТАМИЛ НАДУ", "ТЕЛАНГАНА", "ТРИПУРА", "УТТАР-ПРАДЕШ", "УТТАРАХАНД" и "ЗАПАДНАЯ БЕНГАЛИЯ". |
ВнешнийПредложениеНачальноеПриобретениеДетали
Подробная информация о том, когда пользователь/устройство впервые завершил транзакцию с использованием внешних предложений.
JSON-представление |
---|
{ "externalTransactionId": string } |
Поля | |
---|---|
externalTransactionId | Необходимый. Идентификатор внешней транзакции первой завершенной покупки, совершенной пользователем. |
Методы | |
---|---|
| Создает новую внешнюю транзакцию. |
| Получает существующую внешнюю транзакцию. |
| Возвращает или частично возвращает существующую внешнюю транзакцию. |