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)
  },

  // 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 zostały sprzedane produkty w aplikacji (np. „com.jakaś.aplikacja”).
externalTransactionId

string

Tylko dane wyjściowe. Identyfikator tej transakcji. Wszystkie identyfikatory transakcji w ramach tej samej nazwy pakietu muszą być unikalne. Ustaw podczas tworzenia transakcji zewnętrznej.
originalPreTaxAmount

object (Price)

Wymagane. Kwota pierwotnej transakcji bez podatków. Jest to kwota przed opodatkowaniem, którą powiadomiliśmy Google przed wprowadzeniem zwrotu środków.
originalTaxAmount

object (Price)

Wymagane. Pierwotna kwota podatku. Jest to kwota podatku przesłana pierwotnie do Google przed dokonaniem zwrotu środków.
currentPreTaxAmount

object (Price)

Tylko dane wyjściowe. Bieżąca kwota transakcji bez podatku. Jest to aktualna kwota przed naliczeniem podatku, w tym wszelkie zwroty środków, które mogły zostać zastosowane do tej transakcji.
currentTaxAmount

object (Price)

Tylko dane wyjściowe. Aktualna kwota podatku. Jest to aktualna kwota podatku, w tym wszelkie zwroty środków, które mogły zostać zastosowane w przypadku tej transakcji.
testPurchase

object (ExternalTransactionTestPurchase)

Tylko dane wyjściowe. Jeśli transakcja jest skonfigurowana, była to zakup testowy. Google nie obciąży Cię płatnością za transakcję testową.
transactionTime

string (Timestamp format)

Wymagane. Godzina ukończenia transakcji.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Tylko dane wyjściowe. Godzina utworzenia transakcji. To godzina, kiedy firma Google została powiadomiona o transakcji.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

Tylko dane wyjściowe. Obecny stan transakcji.
userTaxAddress

object (ExternalTransactionAddress)

Wymagane. Adres użytkownika na potrzeby obliczania podatku.
Pole sumy transaction_type. Typ przeprowadzonej transakcji. transaction_type może być tylko jedną z tych wartości:
oneTimeTransaction

object (OneTimeExternalTransaction)

Jest to jednorazowa transakcja i nie jest częścią subskrypcji.
recurringTransaction

object (RecurringExternalTransaction)

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

ExternalTransactionTestPurchase

Ten typ nie ma żadnych pól.

Reprezentuje transakcję wykonaną za pomocą konta testowego. Google nie obciąży ich płatnością.

OneTimeExternalTransaction

Reprezentuje transakcję jednorazową.

Zapis JSON 
{
  "externalTransactionToken": string
}
Pola
externalTransactionToken

string

Tylko wejście. Podana podczas rozmowy z Create. Pobierane od 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 kupowany jednorazowo z wieloma płatnościami (np. zamówienie w przedsprzedaży).

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 sumy source.

source może być tylko jedną z tych wartości:
initialExternalTransactionId

string

Zewnętrzny identyfikator pierwszej transakcji tej cyklicznej serii transakcji. Na przykład w przypadku subskrypcji jest to identyfikator transakcji pierwszej płatności. Wymagane przy tworzeniu cyklicznych transakcji zewnętrznych.
externalTransactionToken

string

Tylko wejście. Podana podczas rozmowy z Create. Pobierane od klienta po uruchomieniu procesu rozliczeń alternatywnych. Wymagane tylko przy pierwszym zakupie.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Tylko wejście. Podana podczas rozmowy z Create. Tej opcji należy używać tylko podczas przenoszenia subskrypcji z ręcznego raportowania miesięcznego do automatycznego raportowania.
Pole sumy product_details. Wymagane. Szczegóły produktu w cyklicznej transakcji zewnętrznej. product_details może być tylko jedną z tych wartości:
externalSubscription

object (ExternalSubscription)

Szczegóły subskrypcji zewnętrznej.
otherRecurringProduct

object (OtherRecurringProduct)

Szczegóły cyklicznej transakcji zewnętrznej, która nie należy do żadnej innej kategorii.

ExternalTransactionProgram

Reprezentuje zewnętrzny program transakcji doświadczony przez użytkownika podczas realizacji transakcji.

Wartości w polu enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Nieokreślony program transakcji. Nieużywany.
USER_CHOICE_BILLING System rozliczeniowy oparty na wyborze użytkownika, który pozwala użytkownikowi wybrać między rozliczeniami zarządzanymi przez dewelopera w Google Play.
ALTERNATIVE_BILLING_ONLY Tylko rozliczenia alternatywne – użytkownicy mogą korzystać tylko z płatności na koncie menedżera dewelopera.

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 Nie określono. Nie używaj.
RECURRING Jest to subskrypcja cykliczna, w której 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 żadnych pól.

Szczegóły cyklicznej transakcji zewnętrznej, która nie należy do żadnej bardziej szczegółowej kategorii.

TransactionState

Stan realizowanej transakcji.

Wartości w polu enum
TRANSACTION_STATE_UNSPECIFIED Nieokreślony stan transakcji. Nieużywany.
TRANSACTION_REPORTED Transakcja została zgłoszona do Google.
TRANSACTION_CANCELED Środki za transakcję zostały zwrócone.

ExternalTransactionAddress

Adres użytkownika do transakcji zewnętrznej.

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

string

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

string

Opcjonalnie. Jednostka administracyjna najwyższego poziomu w kraju/regionie. Wymagane tylko w przypadku transakcji w Indiach. Prawidłowe wartości to

Metody

createexternaltransaction

 Tworzy nową transakcję zewnętrzną.

getexternaltransaction

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

refundexternaltransaction

 Zwraca środki za istniejące transakcje zewnętrzne lub częściowe zwroty środków.