Method: purchases.voidedpurchases.list

Zawiera listę zakupów, które zostały anulowane, zwrócone lub objęte obciążeniem zwrotnym.

Żą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 przypadku której muszą zostać zwrócone unieważnione zakupy (na przykład „com.some.thing”).

Parametry zapytania

Parametry
pageSelection.maxResults

integer (uint32 format)

Określa liczbę wyników, które powinna zwrócić operacja listy. Wartość domyślna zależy od zbioru zasobów.
pageSelection.startIndex

integer (uint32 format)

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

string

Określa token strony do zwrócenia, zwykle pobrany z TokenPagination. Tej opcji można użyć tylko wtedy, gdy włączone jest 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 po ustawieniu tokena podziału na strony. Wartość domyślna to bieżący czas minus 30 dni. Uwaga: ten filtr jest stosowany w momencie, w którym nasze systemy uznały, że rekord został unieważniony, a nie do rzeczywistego unieważnionego czasu zwróconego w odpowiedzi.
endTime

string (int64 format)

Czas (w milisekundach od początku epoki) najnowszego unieważnionego zakupu, który chcesz zobaczyć w odpowiedzi. Wartość tego parametru nie może być większa niż bieżący czas i jest ignorowana, jeśli ustawiono token podziału na strony. Wartość domyślna to bieżący czas. Uwaga: ten filtr jest stosowany w momencie, w którym nasze systemy uznały, że rekord został unieważniony, a nie do rzeczywistego unieważnionego czasu zwróconego w odpowiedzi.
type

integer

Typ unieważnionych zakupów, które chcesz zobaczyć w odpowiedzi. Możliwe wartości to: 0. W odpowiedzi zostaną zwrócone tylko unieważnione zakupy produktów w aplikacji. jest to wartość domyślna 1. Zarówno unieważnione zakupy w aplikacji, jak i unieważnione zakupy subskrypcji zostaną zwrócone w odpowiedzi.

Uwaga: zanim poprosisz o unieważnione zakupy subskrypcji, musisz użyć w odpowiedzi pola orderId, które jednoznacznie identyfikuje zakupy i subskrypcje jednorazowe. W przeciwnym razie otrzymasz wiele zamówień subskrypcji z tym samym tokenem zakupu, ponieważ zamówienia odnowienia subskrypcji mają ten sam token zakupu.
includeQuantityBasedPartialRefund

boolean

Opcjonalnie: Określa, czy uwzględnić unieważnione zakupy częściowych zwrotów środków za określoną liczbę produktów, które mają zastosowanie tylko w przypadku zakupu wielu sztuk produktu. Jeśli ma wartość true (prawda), dodatkowe unieważnione zakupy mogą być zwracane z wartością voidedQuantity, która wskazuje wielkość zwrotu środków w przypadku częściowego zwrotu środków ustalonej 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 tokenów na strony.
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 i ile wyników powinny zostać zwrócone przez operację voidedpurchases.list.

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

integer (uint32 format)

Określa liczbę wyników, które powinna zwrócić operacja listy. Wartość domyślna zależy od zbioru zasobów.
startIndex

integer (uint32 format)

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

string

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