- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- PageSelection
- Wypróbuj
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 |
Nazwa pakietu aplikacji, w której przypadku należy zwrócić unieważnione zakupy (np. „com.jakiś.thing”). |
Parametry zapytania
Parametry | |
---|---|
pageSelection.maxResults |
Określa, ile wyników powinna zwrócić operacja listy. Liczba domyślna zależy od zbioru zasobów. |
pageSelection.startIndex |
Określa indeks pierwszego zwróconego elementu. Tej opcji można używać tylko wtedy, gdy włączone jest zindeksowane stronicowanie. |
pageSelection.token |
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 |
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 |
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 |
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 |
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 ( |
Pola | |
---|---|
pageInfo |
Ogólne informacje o podziale na strony. |
tokenPagination |
Informacje o podziale na strony tokenów. |
voidedPurchases[] |
|
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 |
Określa, ile wyników powinna zwrócić operacja listy. Liczba domyślna zależy od zbioru zasobów. |
startIndex |
Określa indeks pierwszego zwróconego elementu. Tej opcji można używać tylko wtedy, gdy włączone jest zindeksowane stronicowanie. |
token |
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. |