REST Resource: purchases.voidedpurchases

Zasób: VoidedPurchase

Zasób VoidedPurchase wskazuje zakup, który został anulowany, za który zwrócono środki lub w przypadku którego nastąpiło obciążenie zwrotne.

Zapis JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Pola
kind

string

Ten rodzaj reprezentuje obiekt anulowanego zakupu w usłudze androidpublisher.
purchaseToken

string

Token, który jednoznacznie identyfikuje zakup jednorazowy lub subskrypcję. Aby jednoznacznie identyfikować odnowienia subskrypcji, używaj identyfikatora orderId (dostępnego od wersji 3 interfejsu API).
purchaseTimeMillis

string (int64 format)

Czas dokonania zakupu w milisekundach od początku epoki (1 stycznia 1970 r.).
voidedTimeMillis

string (int64 format)

Czas anulowania/zwrotu środków/obciążenia zwrotnego zakupu w milisekundach od początku epoki (1 stycznia 1970 r.).
orderId

string

Identyfikator zamówienia, który w niepowtarzalny sposób określa zakup jednorazowy, zakup subskrypcji lub odnowienie subskrypcji.
voidedSource

integer

Inicjator anulowania zakupu. Możliwe wartości: 0. Użytkownik 1. Deweloper 2. Google
voidedReason

integer

Powód anulowania zakupu. Możliwe wartości: 0. Inne 1. Poczucie winy po zakupie 2. Nie_otrzymano 3. Wadliwe 4. Accidental_purchase 5. Oszustwo 6. Friendly_fraud 7. Obciążenie zwrotne 8. Unacknowledged_purchase
voidedQuantity

integer

Unieważniona liczba produktów w wyniku częściowego zwrotu środków za określoną liczbę produktów. Anulowane zakupy z częściowym zwrotem środków za określoną liczbę produktów można zwrócić tylko wtedy, gdy parametr includeQuantityBasedPartialRefund ma wartość „true”.

Metody

list

 Zawiera listę zakupów, które zostały anulowane, zwrócone lub obciążone zwrotem środków.

Kody błędów

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

Kod błędu Przyczyna Opis Rozdzielczość
400 invalidValue W żądaniu podano nieprawidłową wartość. Często jest zwracany w przypadku nieprawidłowego lub nieprawidłowo sformatowanego tokena zakupu. Popraw nieprawidłową wartość pola w treści żądania lub parametrach na podstawie dokumentacji API.
400 required W żądaniu brakuje wymaganego pola lub parametru. Zapoznaj się z dokumentacją interfejsu API, aby upewnić się, że uwzględniono wszystkie obowiązkowe pola i parametry.
403 userInsufficientPermission Użytkownik nie ma wystarczających uprawnień do wykonania żądanej operacji. Sprawdź, czy uwierzytelniony użytkownik ma niezbędne uprawnienia w Konsoli Google Play. Więcej informacji znajdziesz w artykule Korzystanie z konta usługi.
404 notFound Nie znaleziono żądanego zasobu. Sprawdź, czy identyfikatory (np. token zakupu, nazwa pakietu, identyfikator produktu, identyfikator subskrypcji) są prawidłowe.
409 concurrentUpdate Podjęto próbę zaktualizowania obiektu, który jest aktualizowany równolegle. Ponów próbę wysłania żądania ze wzrastającym czasem do ponowienia. Unikaj jednoczesnego modyfikowania tego samego zasobu.
5xx Generic error Ogólny błąd serwera Google Play. Ponów żądanie.

Jeśli problem nie ustąpi, skontaktuj się z menedżerem konta Google Play lub prześlij prośbę o pomoc. Sprawdź Panel stanu Google Play, aby dowiedzieć się, czy występują znane awarie.