REST Resource: externaltransactions

Zasób: ExternalTransaction

Szczegóły transakcji zewnętrznej.

Zapis 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.
}
Pola
packageName

string

Tylko dane wyjściowe. Nazwa zasobu transakcji zewnętrznej. Nazwa pakietu aplikacji, w której sprzedano produkty w aplikacji (np. „com.some.app”).
externalTransactionId

string

Tylko dane wyjściowe. Identyfikator tej transakcji. Wszystkie identyfikatory transakcji o tej samej nazwie pakietu muszą być niepowtarzalne. Ustaw podczas tworzenia transakcji zewnętrznej.
originalPreTaxAmount

object (Price)

Wymagane. Pierwotna kwota transakcji przed podatkami. Jest to kwota przed opodatkowaniem, która została pierwotnie przekazana do Google przed zastosowaniem jakichkolwiek zwrotów.
originalTaxAmount

object (Price)

Wymagane. Pierwotna kwota podatku. Jest to kwota podatku powiadomiona Google przed zastosowaniem jakichkolwiek zwrotów.
currentPreTaxAmount

object (Price)

Tylko dane wyjściowe. Bieżąca kwota transakcji przed podatkiem. Jest to bieżąca kwota przed opodatkowaniem, w tym wszelkie zwroty środków, które zostały zastosowane do tej transakcji.
currentTaxAmount

object (Price)

Tylko dane wyjściowe. Bieżąca kwota podatku. Jest to bieżąca kwota podatku, w tym wszelkie zwroty, które zostały zastosowane do tej transakcji.
testPurchase

object (ExternalTransactionTestPurchase)

Tylko dane wyjściowe. Jeśli jest ustawiona, oznacza, że transakcja była zakupem testowym. Google nie obciąży Cię opłatą za transakcję testową.
transactionTime

string (Timestamp format)

Wymagane. Czas zakończenia transakcji.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tej transakcji. To czas, w którym Google otrzymało powiadomienie o transakcji.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

Tylko dane wyjściowe. Bieżący stan transakcji.
userTaxAddress

object (ExternalTransactionAddress)

Wymagane. Adres użytkownika do obliczenia podatku.
transactionProgramCode

integer

Opcjonalnie: Kod programu transakcji, który pomaga określić opłatę za obsługę w przypadku kwalifikujących się aplikacji uczestniczących w programach partnerskich. Deweloperzy biorący udział w programie Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) muszą podać kod programu podczas zgłaszania transakcji zrealizowanych przy użyciu rozliczeń alternatywnych. Jeśli spełniasz wymagania, skontaktuj się z menedżerem ds. relacji z deweloperami, aby uzyskać więcej informacji o tym, jak ustawić to pole. Uwaga: tego pola nie można używać w przypadku transakcji z ofertą zewnętrzną.
Pole unii transaction_type. Typ wykonanej transakcji. transaction_type może być tylko jednym z tych elementów:
oneTimeTransaction

object (OneTimeExternalTransaction)

Jest to transakcja jednorazowa, a nie część subskrypcji.
recurringTransaction

object (RecurringExternalTransaction)

Ta transakcja jest częścią cyklicznej serii transakcji.

ExternalTransactionTestPurchase

Ten typ nie ma pól.

Reprezentuje transakcję wykonaną za pomocą konta testowego. Google nie obciąży Cię opłatą za te transakcje.

OneTimeExternalTransaction

Odpowiada transakcji jednorazowej.

Zapis JSON 
{
  "externalTransactionToken": string
}
Pola
externalTransactionToken

string

Tylko dane wejściowe. Podane podczas połączenia z Create. Pobierane z klienta po uruchomieniu procesu rozliczeń alternatywnych.

RecurringExternalTransaction

Reprezentuje transakcję, która jest częścią cyklicznej serii płatności. Może to być subskrypcja lub produkt jednorazowy z wieloma płatnościami (np. przedsprzedaż).

Zapis 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.
}
Pola

Pole unii source.

source może być tylko jednym z tych elementów:
initialExternalTransactionId

string

Identyfikator zewnętrzny pierwszej transakcji z cyklicznej serii transakcji. W przypadku subskrypcji będzie to identyfikator transakcji pierwszej płatności. Wymagane podczas tworzenia cyklicznych transakcji zewnętrznych.
externalTransactionToken

string

Tylko dane wejściowe. Podane podczas połączenia z Create. Pobierane z klienta po uruchomieniu procesu rozliczeń alternatywnych. Wymagane tylko w przypadku początkowego zakupu.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Tylko dane wejściowe. Podane podczas połączenia z Create. Należy go używać tylko podczas przenoszenia subskrypcji z raportowania ręcznego miesięcznego na automatyczne.
Pole unii product_details. Wymagane. Szczegóły produktu w cyklicznej transakcji zewnętrznej. product_details może być tylko jednym z tych elementów:
externalSubscription

object (ExternalSubscription)

Szczegóły subskrypcji zewnętrznej.
otherRecurringProduct

object (OtherRecurringProduct)

Szczegóły produktu z cyklicznymi transakcjami zewnętrznymi, który nie należy do żadnej innej kategorii.

ExternalTransactionProgram

Reprezentuje program transakcji zewnętrznych, z którego korzysta użytkownik, aby dokonać transakcji.

Wartości w polu enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Program transakcji nieokreślony. Nieużywane.
USER_CHOICE_BILLING System rozliczeniowy oparty na wyborze użytkownika, w którym użytkownik może wybrać system rozliczeniowy zarządzany przez dewelopera.
ALTERNATIVE_BILLING_ONLY Tylko alternatywne systemy rozliczeniowe, w których przypadku użytkownicy mogą korzystać tylko z systemu rozliczeniowego dla menedżera.

ExternalSubscription

Szczegóły subskrypcji zewnętrznej.

Zapis JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
Pola
subscriptionType

enum (SubscriptionType)

Wymagane. Typ subskrypcji zewnętrznej.

SubscriptionType

Typy subskrypcji zewnętrznych.

Wartości w polu enum
SUBSCRIPTION_TYPE_UNSPECIFIED Nieokreślony, nie używaj.
RECURRING Jest to abonament cykliczny, w którym użytkownik jest obciążany w każdym cyklu rozliczeniowym.
PREPAID Jest to subskrypcja przedpłacona, w której użytkownik płaci z góry.

OtherRecurringProduct

Ten typ nie ma pól.

Szczegóły produktu z cyklicznymi transakcjami zewnętrznymi, który nie należy do żadnej innej, bardziej szczegółowej kategorii.

TransactionState

Stan transakcji.

Wartości w polu enum
TRANSACTION_STATE_UNSPECIFIED Stan transakcji nieokreślony. Nieużywane.
TRANSACTION_REPORTED Transakcja została zgłoszona do Google.
TRANSACTION_CANCELED Transakcja została w pełni zwrócona.

ExternalTransactionAddress

Adres użytkownika w przypadku transakcji zewnętrznej.

Zapis JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
Pola
regionCode

string

Wymagane. Dwuliterowy kod regionu zgodny z normą ISO 3166-1 alfa-2 (kod regionu ONZ).
administrativeArea

string

Opcjonalnie: Najwyższy poziom podziału administracyjnego kraju lub regionu. Wymagane tylko w przypadku transakcji w Indiach. Prawidłowe wartości to „ANDAMAN AND NICOBAR ISLANDS”, „ANDHRA PRADESH”, „ARUNACHAL PRADESH”, „ASSAM”, „BIHAR”, „CHANDIGARH”, „CHHATTISGARH”, „DADRA AND NAGAR HAVELI”, „DADRA AND NAGAR HAVELI AND DAMAN AND DIU”, „DAMAN AND DIU”, „DELHI”, „GOA”, „GUJARAT”, „HARYANA”, „HIMACHAL PRADESH”, „JAMMU AND KASHMIR”, „JHARKHAND”, „KARNATAKA”, „KERALA”, „LADAKH”, „LAKSHADWEEP”, „MADHYA PRADESH”, „MAHARASHTRA”, „MANIPUR”, „MEGHALAYA”, „MIZORAM”, „NAGALAND”, „ODISHA”, „PUDUCHERRY”, „PUNJAB”, „RAJASTHAN”, „SIKKIM”, „TAMIL NADU”, „TELANGANA”, „TRIPURA”, „UTTAR PRADESH”, „UTTARAKHAND” i „WEST BENGAL”.

Metody

createexternaltransaction

 Tworzy nową transakcję zewnętrzną.

getexternaltransaction

 Pobiera istniejącą transakcję zewnętrzną.

refundexternaltransaction

 Zwrot środków lub częściowy zwrot środków za istniejące transakcje zewnętrzne.