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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
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 w ramach tej samej nazwy pakietu muszą być unikalne. Ustawiany podczas tworzenia transakcji zewnętrznej.
originalPreTaxAmount

object (Price)

Wymagane. Pierwotna kwota transakcji przed opodatkowaniem. Jest to kwota przed opodatkowaniem, o której Google zostało pierwotnie powiadomione przed zastosowaniem jakichkolwiek zwrotów środków.
originalTaxAmount

object (Price)

Wymagane. Oryginalna kwota podatku. Jest to kwota podatku pierwotnie zgłoszona Google przed zastosowaniem zwrotów środków.
currentPreTaxAmount

object (Price)

Tylko dane wyjściowe. Aktualna kwota transakcji przed opodatkowaniem. Jest to bieżąca kwota przed opodatkowaniem, która obejmuje wszelkie zwroty środków zastosowane w tej transakcji.
currentTaxAmount

object (Price)

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

object (ExternalTransactionTestPurchase)

Tylko dane wyjściowe. Jeśli ta wartość jest ustawiona, transakcja była testowym zakupem. Google nie pobierze opłaty za transakcję testową.
transactionTime

string (Timestamp format)

Wymagane. Czas zakończenia transakcji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
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 rozliczeń alternatywnych. Jeśli jesteś kwalifikującym się deweloperem, skontaktuj się z menedżerem ds. rozwoju biznesu, aby dowiedzieć się więcej o tym, jak ustawić to pole. Uwaga: tego pola nie można używać w przypadku transakcji dotyczących ofert zewnętrznych.
Typ wykonanej transakcji. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
oneTimeTransaction

object (OneTimeExternalTransaction)

Jest to transakcja jednorazowa, która nie jest częścią subskrypcji.
recurringTransaction

object (RecurringExternalTransaction)

Niniejsza transakcja jest częścią serii cyklicznych transakcji.
Koniec pól wykluczających się nawzajem.
szczegóły programu niezbędne do raportowania transakcji. Szczegóły powinny być ustawione tylko w przypadku programu, z którym powiązana jest transakcja. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
externalOfferDetails

object (ExternalOfferDetails)

Opcjonalnie. Szczegóły niezbędne do dokładnego raportowania transakcji dotyczących ofert zewnętrznych.
externalContentLinkDetails

object (ExternalContentLinkDetails)

Opcjonalnie. Szczegóły niezbędne do prawidłowego zgłaszania transakcji związanych z linkami do treści zewnętrznych.
Koniec pól wykluczających się nawzajem.

ExternalTransactionTestPurchase

Ten typ nie ma pól.

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

OneTimeExternalTransaction

Reprezentuje transakcję jednorazową.

Zapis JSON 
{
  "externalTransactionToken": string
}
Pola
externalTransactionToken

string

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

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. zamówienie w przedsprzedaży).

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
Pola
Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
initialExternalTransactionId

string

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

string

Tylko dane wejściowe. Podawane podczas wywołania funkcji Create. Pobierane od klienta po uruchomieniu rozliczeń alternatywnych. Wymagane tylko w przypadku zakupu początkowego.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Tylko dane wejściowe. Podane podczas połączenia z Create. Może być używany tylko podczas przenoszenia subskrypcji z ręcznego raportowania miesięcznego na raportowanie automatyczne.
Koniec pól wykluczających się nawzajem.
Wymagane. Szczegóły produktu w powtarzającej się transakcji zewnętrznej. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
externalSubscription

object (ExternalSubscription)

Szczegóły subskrypcji zewnętrznej.
otherRecurringProduct

object (OtherRecurringProduct)

Szczegóły dotyczące produktu związanego z cykliczną transakcją zewnętrzną, który nie należy do żadnej innej kategorii.
Koniec pól wykluczających się nawzajem.

ExternalTransactionProgram

Określa program transakcji zewnętrznych, w którym użytkownik dokonał transakcji.

Wartości w polu enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Nieokreślony program transakcyjny. Nie używane.
USER_CHOICE_BILLING System rozliczeniowy oparty na wyborze użytkownika, w którym użytkownik może wybrać rozliczenia zarządzane przez dewelopera w ramach Płatności w Google Play.
ALTERNATIVE_BILLING_ONLY Tylko rozliczenia alternatywne, w których użytkownicy mogą korzystać tylko z rozliczeń konta 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żywać.
RECURRING Jest to cykliczna subskrypcja, w ramach której opłata jest pobierana od użytkownika co cykl rozliczeniowy.
PREPAID Jest to subskrypcja przedpłacona, za którą użytkownik płaci z góry.

OtherRecurringProduct

Ten typ nie ma pól.

Szczegóły dotyczące produktu związanego z cykliczną transakcją zewnętrzną, który nie należy do żadnej innej, bardziej szczegółowej kategorii.

TransactionState

Stan transakcji.

Wartości w polu enum
TRANSACTION_STATE_UNSPECIFIED Nieokreślony stan transakcji. Nie używane.
TRANSACTION_REPORTED Transakcja została zgłoszona do Google.
TRANSACTION_CANCELED Transakcja została w całości 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 Alpha-2 (kody regionów 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 I NICOBAR ISLANDS”, „ANDHRA PRADESH”, „ARUNACHAL PRADESH”, „ASSAM”, „BIHAR”, „CHANDIGARH”, „CHHATTISGARH”, „DADRA I NAGAR HAVELI”, „DADRA I NAGAR HAVELI AND DAMAN AND DIU”, „DAMAN AND DIU”, „DELHI”, „GOA”, „GUJARAT”, „HARYANA”, „HIMACHAL PRADESH”, „DŻAMMU I KASZMIR”, „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 „BENGAL ZACHODNI”.

ExternalOfferDetails

Szczegóły raportowania dotyczące programu ofert zewnętrznych.

Zapis JSON 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Pola
installedAppPackage

string

Opcjonalnie. Nazwa pakietu aplikacji pobranej w ramach tej transakcji. Wymagane, gdy linkType ma wartość LINK_TO_APP_DOWNLOAD.
installedAppCategory

enum (ExternalOfferAppCategory)

Opcjonalnie. Kategoria pobranej aplikacji w ramach tej transakcji. Musi ona być zgodna z kategorią podaną w Konsoli Play podczas procesu weryfikacji aplikacji zewnętrznej. Wymagane tylko w przypadku pobrań aplikacji.
appDownloadEventExternalTransactionId

string

Opcjonalnie. Identyfikator transakcji zewnętrznej powiązany ze zdarzeniem pobrania aplikacji za pomocą linku zewnętrznego. Wymagane przy raportowaniu transakcji wykonanych w zewnętrznie zainstalowanych aplikacjach.

ExternalOfferLinkType

Typ linku zewnętrznego.

Wartości w polu enum
LINK_TO_DIGITAL_CONTENT_OFFER Oferta zakupu treści cyfrowych.

ExternalOfferAppCategory

Kategoria pobranej aplikacji. Więcej informacji o kategoriach aplikacji znajdziesz na stronie https://support.google.com/googleplay/android-developer/answer/9859673.

Wartości w polu enum
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Nie określono, nie używać.
APP Aplikacja jest klasyfikowana w ramach kategorii aplikacji.
GAME Aplikacja jest sklasyfikowana w kategorii gier.

ExternalContentLinkDetails

Szczegóły raportowania charakterystyczne dla programu linkującego do treści zewnętrznych.

Zapis JSON 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
Pola
installedAppPackage

string

Opcjonalnie. Nazwa pakietu aplikacji pobranej w ramach tej transakcji. Wymagane tylko do instalacji aplikacji.
externalAppCategory

enum (ExternalContentAppCategory)

Opcjonalnie. Kategoria pobranej aplikacji. Musi być zgodna z kategorią podaną w Konsoli Play podczas procesu weryfikacji zewnętrznej aplikacji. Wymagane tylko do instalacji aplikacji.

ExternalContentLinkType

Typ linku zewnętrznego.

Wartości w polu enum
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED Nie określono, nie używać.
LINK_TO_DIGITAL_CONTENT_OFFER Oferta zakupu treści cyfrowych.

ExternalContentAppCategory

Kategoria pobranej aplikacji. Więcej informacji o kategoriach aplikacji znajdziesz na stronie https://support.google.com/googleplay/android-developer/answer/9859673.

Wartości w polu enum
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED Nie określono, nie używać.
APP Aplikacja jest klasyfikowana w ramach kategorii aplikacji.
GAME Aplikacja jest sklasyfikowana w kategorii gier.

Metody

createexternaltransaction

 Tworzy nową transakcję zewnętrzną.

getexternaltransaction

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

refundexternaltransaction

 Zwraca środki lub częściowo zwraca środki za istniejącą transakcję zewnętrzną.

Kody błędów

Operacje na tym zasobie zwracają te kody błędów HTTP:

Kod błędu Przyczyna Opis Rozdzielczość