Method: purchases.voidedpurchases.list

Lista zakupów, które zostały anulowane, objęte zwrotem środków lub zwrotem środków.

Żądanie HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Nazwa pakietu aplikacji, w której przypadku należy zwrócić unieważnione zakupy (np. „com.jakiś.thing”).

Parametry zapytania

Parametry
pageSelection.maxResults

integer (uint32 format)

Określa, ile wyników powinna zwrócić operacja listy. Liczba domyślna zależy od zbioru zasobów.
pageSelection.startIndex

integer (uint32 format)

Określa indeks pierwszego zwróconego elementu. Tej opcji można używać tylko wtedy, gdy włączone jest zindeksowane stronicowanie.
pageSelection.token

string

Określa token zwracanej strony, zwykle pobierany z obiektu TokenPagination. Tej opcji można użyć tylko wtedy, gdy jest włączone stronicowanie tokenów.
startTime

string (int64 format)

Czas (w milisekundach od początku epoki) najstarszego unieważnionego zakupu, który chcesz zobaczyć w odpowiedzi. Wartość tego parametru nie może być starsza niż 30 dni i jest ignorowana, jeśli ustawiony jest token podziału na strony. Wartość domyślna to bieżący czas minus 30 dni. Uwaga: ten filtr jest stosowany w momencie, gdy nasze systemy uznają, że rekord został unieważniony, a nie rzeczywisty czas unieważnienia zwrócony w odpowiedzi.
endTime

string (int64 format)

Czas (w milisekundach od początku epoki) ostatniego unieważnionego zakupu, który ma być podany w odpowiedzi. Wartość tego parametru nie może być większa niż bieżąca godzina i jest ignorowana, jeśli ustawiony jest token podziału na strony. Wartość domyślna to bieżący czas. Uwaga: ten filtr jest stosowany w momencie, gdy nasze systemy uznają, że rekord został unieważniony, a nie rzeczywisty czas unieważnienia zwrócony w odpowiedzi.
type

integer

Typ unieważnionych zakupów, które mają być uwzględnione w odpowiedzi. Możliwe wartości to: 0. W odpowiedzi zwracane są tylko unieważnione zakupy produktów w aplikacji. jest to wartość domyślna 1. W odpowiedzi zostaną zwrócone zarówno unieważnione zakupy w aplikacji, jak i zakupy unieważnione.

Uwaga: zanim poprosisz o odbiór unieważnionych subskrypcji, musisz użyć pola orderId w odpowiedzi, która jednoznacznie identyfikuje jednorazowe zakupy i subskrypcje. W przeciwnym razie otrzymasz wiele zamówień subskrypcji z tym samym tokenem zakupu, ponieważ w przypadku zamówień odnowienia subskrypcji ten sam token jest sprzedawany.
includeQuantityBasedPartialRefund

boolean

Opcjonalnie. Określa, czy uwzględniać unieważnione zakupy częściowych zwrotów środków na podstawie ilości, które mają zastosowanie tylko w przypadku zakupu większej liczby sztuk produktu. Jeśli ma wartość true (prawda), dodatkowe anulowane zakupy mogą być zwracane z atrybutem voidedQuantity, który wskazuje kwotę zwrotu środków w przypadku częściowego zwrotu środków na podstawie ilości. Wartość domyślna to false (fałsz).

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dotycząca interfejsu API voidedpurchases.list.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Pola
pageInfo

object (PageInfo)

Ogólne informacje o podziale na strony.
tokenPagination

object (TokenPagination)

Informacje o podziale na strony tokenów.
voidedPurchases[]

object (VoidedPurchase)

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/androidpublisher

PageSelection

Typ parametru żądania pageSelection, który określa, które wyniki ma zwrócić operacja voidedpurchases.list i ile ich ma.

Zapis JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Pola
maxResults

integer (uint32 format)

Określa, ile wyników powinna zwrócić operacja listy. Liczba domyślna zależy od zbioru zasobów.
startIndex

integer (uint32 format)

Określa indeks pierwszego zwróconego elementu. Tej opcji można używać tylko wtedy, gdy włączone jest zindeksowane stronicowanie.
token

string

Określa token zwracanej strony, zwykle pobierany z obiektu TokenPagination. Tej opcji można użyć tylko wtedy, gdy jest włączone stronicowanie tokenów.