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,
  "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.
}
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 transakcji. Wszystkie identyfikatory transakcji w ramach tej samej nazwy pakietu muszą być unikalne. Ustaw podczas tworzenia transakcji zewnętrznej.

originalPreTaxAmount

object (Price)

Wymagane. Pierwotna kwota transakcji przed opodatkowaniem. Jest to kwota przed opodatkowaniem, która została pierwotnie zgłoszona do Google przed dokonaniem zwrotu środków.

originalTaxAmount

object (Price)

Wymagane. Pierwotna kwota podatku. Jest to kwota podatku zgłoszona do Google przed zwrotem ś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ć użyte w przypadku tej transakcji.

currentTaxAmount

object (Price)

Tylko dane wyjściowe. Bieżąca kwota podatku. Reprezentuje ona aktualną kwotę podatku, w tym wszelkie zwroty środków, które mogły zostać użyte w przypadku tej transakcji.

testPurchase

object (ExternalTransactionTestPurchase)

Tylko dane wyjściowe. Jeśli została ustawiona, była to transakcja testowa. Google nie obciąży Cię za transakcję testową.

transactionTime

string (Timestamp format)

Wymagane. Czas realizacji transakcji.

Sygnatura czasowa w RFC3339 UTC „Zulu” 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. Czas utworzenia transakcji. To moment, w którym firma Google została powiadomiona o transakcji.

Sygnatura czasowa w RFC3339 UTC „Zulu” 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. Bieżący stan transakcji.

userTaxAddress

object (ExternalTransactionAddress)

Wymagane. Adres użytkownika do obliczenia podatku.

transactionProgramCode

integer

Opcjonalnie: Kod programu transakcji używany do określenia opłaty za obsługę w przypadku kwalifikujących się aplikacji uczestniczących w programach partnerskich. Deweloperzy uczestniczący w programie Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) muszą podać kod programu podczas zgłaszania transakcji realizowanych za pomocą rozliczeń alternatywnych. Jeśli jesteś kwalifikującym się deweloperem, skontaktuj się z BDM, aby uzyskać więcej informacji o ustawianiu tego pola. Uwaga: tego pola nie można używać w przypadku transakcji w ramach ofert zewnętrznych.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

Opcjonalnie: Szczegółowe informacje o pierwszej transakcji zrealizowanej przez użytkownika lub urządzenie za pomocą ofert zewnętrznych. Nie jest wymagane w przypadku transakcji dokonanych za pomocą systemu rozliczeniowego opartego na wyborze użytkownika lub systemu rozliczeniowego alternatywnego.

Pole sumy transaction_type. Typ dokonanej transakcji. transaction_type może mieć tylko jedną z tych wartości:
oneTimeTransaction

object (OneTimeExternalTransaction)

Jest to transakcja jednorazowa i nie stanowi części subskrypcji.

recurringTransaction

object (RecurringExternalTransaction)

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

ExternalTransactionTestPurchase

Ten typ nie zawiera pól.

Reprezentuje transakcję wykonaną na koncie testowym. Google nie obciąża za te transakcje.

OneTimeExternalTransaction

Oznacza transakcję jednorazową.

Zapis JSON
{
  "externalTransactionToken": string
}
Pola
externalTransactionToken

string

Tylko dane wejściowe. Podane podczas wywoływania usługi Create. Dane pobierane od klienta po uruchomieniu alternatywnego procesu rozliczeń.

RecurringExternalTransaction

Reprezentuje transakcję, która jest częścią cyklicznej serii płatności. Może to być subskrypcja lub produkt kupowany raz 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 sumy source.

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

initialExternalTransactionId

string

Zewnętrzny identyfikator transakcji pierwszej transakcji z tej cyklicznej serii transakcji. W przypadku subskrypcji byłby to np. identyfikator pierwszej płatności. Wymagane przy tworzeniu cyklicznych transakcji zewnętrznych.

externalTransactionToken

string

Tylko dane wejściowe. Podane podczas wywoływania usługi Create. Dane pobierane od klienta po uruchomieniu alternatywnego procesu rozliczeń. Wymagane tylko przy pierwszym zakupie.

migratedTransactionProgram

enum (ExternalTransactionProgram)

Tylko dane wejściowe. Podane podczas wywoływania usługi Create. Tej opcji należy używać tylko podczas przechodzenia z ręcznego raportowania miesięcznego na automatyczne raportowanie dotyczące subskrypcji.

Pole sumy product_details. Wymagane. Szczegóły produktu w cyklicznej transakcji zewnętrznej. product_details może mieć 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 konkretnej kategorii.

ExternalTransactionProgram

Reprezentuje program transakcji zewnętrznych, jaki spotkał użytkownik, aby zrealizować transakcję.

Wartości w polu enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Nieokreślony program transakcji. Nieużywane.
USER_CHOICE_BILLING System rozliczeniowy oparty na wyborze użytkownika, w którym użytkownik może wybrać płatności zarządzane przez dewelopera w Płatnościach w Google Play.
ALTERNATIVE_BILLING_ONLY Tylko rozliczenia alternatywne, w przypadku których użytkownicy mogą korzystać wyłącznie z płatności przez 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ętrznej.

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

OtherRecurringProduct

Ten typ nie zawiera pól.

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

TransactionState

Stan dokonanej transakcji.

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

ExternalTransactionAddress

Adres użytkownika na potrzeby transakcji zewnętrznej.

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

string

Wymagane. Dwuliterowy kod regionu zgodny ze standardem ISO-3166-1 alfa-2 (kody regionów ONZ).

administrativeArea

string

Opcjonalnie: Jednostka podziału administracyjnego najwyższego poziomu w kraju/regionie. Wymagane tylko w przypadku transakcji w Indiach. . . . ”. . ”. Na jego wartości są .

ExternalOfferInitialAcquisitionDetails

Szczegóły dotyczące pierwszej transakcji wykonanej przez użytkownika lub urządzenie za pomocą ofert zewnętrznych.

Zapis JSON
{
  "externalTransactionId": string
}
Pola
externalTransactionId

string

Wymagane. Zewnętrzny identyfikator transakcji pierwszego zrealizowanego zakupu dokonanego przez użytkownika.

Metody

createexternaltransaction

Tworzy nową transakcję zewnętrzną.

getexternaltransaction

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

refundexternaltransaction

Zwraca lub częściowy zwrot środków za istniejącą transakcję zewnętrzną.