Voided Purchases API

Interfejs Google Play Voided Purchases API przedstawia listę zamówień, które są powiązane z zakupami unieważnionymi przez użytkownika. Informacje, które można wykorzystać z tej listy, aby wdrożyć system unieważniania, który uniemożliwia użytkownikowi na dostęp do produktów z tych zamówień.

Ten interfejs API dotyczy jednorazowych zamówień w aplikacji i subskrypcji aplikacji.

Zakup można unieważnić na kilka sposobów:

• Użytkownik prosi o zwrot środków za zamówienie.
• Użytkownik anuluje zamówienie.
• Opłata za zamówienie jest zwracana.

• Deweloper anuluje zamówienie lub zwróci środki.

  Uwaga: w interfejsie Voided Purchases API będą widoczne tylko anulowane zamówienia. Jeśli deweloper zwróci środki za zakup bez ustawionej opcji unieważnienia, zamówienie nie zostanie zwrócone przez interfejs API.

• Google anuluje zamówienie lub zwróci środki.

Korzystając z tego interfejsu API, pomagasz wszystkim użytkownikom użytkowników aplikacji, zwłaszcza jeśli jest to gra.

Uwaga: w przeciwieństwie do innych źródeł danych związanych z zamówieniami interfejs Voided Purchases API obejmuje zakupy, za które firmy obsługujące płatności są pobierane zwrotnie. Dlatego mogą pojawić się niespójności między informacjami z tego interfejsu API informacji z innych źródeł danych związanych z zamówieniami.

Uwaga: interfejs Voided Purchases API zwraca unieważnione zakupy tylko wtedy, gdy jest to konieczne. zostać unieważnione. Deweloperzy mogą używać tego interfejsu API jako wskaźnika, dodatkowych działań. Za niektóre zakupy mogą jednak zostać zwrócone środki z powodu tego, że deweloper nigdy nie potwierdził zakupu. dlatego mogą nie znajdować się w danych dewelopera.

Uzyskiwanie dostępu

Aby korzystać z interfejsu Voided Purchases API, musisz mieć uprawnienia do wyświetlania informacje finansowe. Przeprowadzasz autoryzację za pomocą klienta OAuth lub konta usługi. Jeśli używasz konta usługi, włącz opcję „Wyświetl dane finansowe raportów” na tym koncie.

Więcej informacji o uzyskiwaniu autoryzowanego dostępu do interfejsów Google Play Developer API znajdziesz tutaj: następujące przewodniki:

• Konfigurowanie klientów dostępu do interfejsu API
• Dodaj użytkowników konta dewelopera zarządzaj uprawnieniami

Wyświetlanie unieważnionych zakupów

Aby poprosić o listę unieważnionych zakupów, użyj metody GET. W swojej prośbie zawierają pełną nazwę pakietu aplikacji, np. com.google.android.apps.maps – oraz token autoryzacji, otrzymane przy uzyskaniu dostępu do interfejsu API.

GET https://www.googleapis.com/androidpublisher/v3/applications/
your_package_name/purchases/voidedpurchases?access_token=your_auth_token

W żądaniu możesz też umieścić następujące parametry, z których każdy jest opcjonalnie:

startTime

Czas (w milisekundach) od epoki uniksowej, od najstarszej unieważniony zakup, który chcesz widzieć w odpowiedzi. Domyślnie startTime jest ustawiony na 30 dni temu.

Interfejs API może wyświetlać tylko unieważnione zakupy, które miały miejsce w przeszłości 30 dni. Starsze unieważnione zakupy nie są uwzględnione w odpowiedzi, podanej wartości w polu startTime.

Uwaga: unieważnione zakupy w odpowiedzi są filtrowane na podstawie: czas, w którym dany rekord zostaje uznany za unieważniony przez interfejs API, a nie przez wartość voidedTimeMillis zwrócona w odpowiedzi.

endTime

Czas w milisekundach od epoki uniksowej unieważniony zakup, który ma być widoczny w odpowiedzi. Domyślnie endTime jest ustawiony na bieżący czas.

Uwaga: unieważnione zakupy w odpowiedzi są filtrowane na podstawie czasu, w którym dany rekord został uznany za unieważniony przez API, a nie według wartości voidedTimeMillis zwróconej w metodzie .

maxResults

Maksymalna liczba unieważnionych zakupów, które pojawiają się w każdej odpowiedzi. Według domyślna wartość to 1000. Pamiętaj, że maksymalna wartość tego parametru to również 1000.

token

token kontynuacji z poprzedniej odpowiedzi, który pozwala zobaczyć więcej wyników.

typ

Typ unieważnionych zakupów, które pojawiają się w poszczególnych odpowiedziach. Jeśli ustawisz wartość 0, zwracane są tylko unieważnione zakupy w aplikacji. Jeśli ma wartość 1, oba te elementy zostaną unieważnione w aplikacji. zakupy i unieważnione subskrypcje zostaną zwrócone. Wartość domyślna to 0.

Uwaga: zanim poprosisz o unieważnienie zakupów subskrypcji, musisz przełączyć się na użycie orderId w odpowiedzi, jednoznacznie identyfikuje jednorazowe zakupy i subskrypcje. W przeciwnym razie mogą otrzymywać wiele zamówień subskrypcji z tym samym tokenem zakupu.

includeQuantityBasedPartialRefund

Czy uwzględniać 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 tego samego produktu. Jeśli true, dodatkowe unieważnione zakupy mogą zostać zwrócone w drodze voidedQuantity który wskazuje kwotę częściowego zwrotu środków za określoną liczbę produktów. wartość domyślna to false.

Uwaga: jeśli pozostała łączna ilość gdy otrzymasz zwrot środków, analogiczny zakup nie zostanie przypisany voidedQuantity, która sygnalizuje, że w przypadku zakupu zostały w całości zwrócone. Jeśli na przykład za zakup egzemplarza produktu 10 otrzymasz zwrot środków, 3 w przypadku ilości 2, 3 i 5, zostaną 3 unieważnione zakupy. Pierwszy dwa unieważnione zakupy będą miały wartość voidedQuantity równą 2 i 3, trzeci unieważniony zakup nie będzie miał voidedQuantity.

Odpowiedź to ciąg tekstowy JSON zawierający listę unieważnionych zakupów. Jeśli są większą liczbą wyników niż liczba określona w parametrze żądania maxResults , odpowiedź zawiera wartość nextPageToken, którą można przekazać do o wyświetlenie kolejnych wyników. Pierwszy wynik na liście wskazuje najstarszy unieważniony zakup.

{
  "tokenPagination": {
    "nextPageToken": "next_page_token"
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_purchase_token",
      "purchaseTimeMillis": "1468825200000",
      "voidedTimeMillis": "1469430000000",
      "orderId": "some_order_id",
      "voidedSource": "0",
      "voidedReason": "4"
    },
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_other_purchase_token",
      "purchaseTimeMillis": "1468825100000",
      "voidedTimeMillis": "1470034800000",
      "orderId": "some_other_order_id",
      "voidedSource": "2",
      "voidedReason": "5"
    },
  ]
}

Limity

Interfejs Voided Purchases API ustala następujące limity na poziomie pakietu:

• 6000 zapytań dziennie. (dzień zaczyna się i kończy o północy czasu pacyficznego).
• 30 zapytań w dowolnym 30-sekundowym okresie.

Wytyczne dotyczące żądań wstępnych

Podczas początkowego żądania do interfejsu API możesz zechcieć pobrać wszystkie dostępne dane dotyczące do aplikacji. Chociaż jest to mało prawdopodobne, ten proces może spowodować wykorzystanie Twojego dziennego limitu. Do uzyskać dane o unieważnionych zakupach w bezpieczniejszy, bardziej spójny sposób, sprawdzone metody:

• Użyj wartości domyślnej parametru maxResults. Dzięki temu, jeśli używasz całego limitu zapytań na dzień, możesz pobrać szczegóły 6 000 000 unieważnionych zakupów.
• Jeśli odpowiedź zawiera wartość w polu nextPageToken, przypisz ją do parametru token przy następnym żądaniu.

Sprawdzone metody

Uwaga: oprócz korzystania z tego interfejsu API deweloperzy powinni też przeprowadzić integrację z Powiadomienia w czasie rzeczywistym dla deweloperów (RTDN). Dzięki RTDN otrzymujesz powiadomienia od Google, gdy zmiany uprawnień użytkownika w aplikacji, m.in. gdy użytkownik unieważnia zakup.

Korzystając z tego interfejsu API w swojej aplikacji, pamiętaj, że powodów do unieważnienia zakupu i nie ma jednego rozwiązania, które sprawdzi się we wszystkich przypadkach. Podczas projektowania unieważnienia musisz pamiętać o użytkownikach zasadami i strategiami. W tym celu możesz zastosować te zalecane metody:

• Wykorzystaj ten interfejs API jako jeden z wielu elementów kompleksowej strategii niepożądane zachowanie. Anulowanie dostępu do produktów w aplikacji jest zwykle skuteczniejsze w połączeniu z aplikacją, która ma rozsądne ceny za zakupy w aplikacji, projektowanie aplikacji zniechęcające do niepożądanego zachowania, liczne grono użytkowników, kultura odrzuca takie zachowania, a pomoc szybko i efektywnie kanałów.
• Konfiguruj zasady unieważniania w sposób jednolity, aby zapewnić sprawiedliwe traktowanie wszystkich użytkowników.
• Rozważ utworzenie etapowych zasad na wypadek niepożądanych zachowań. Dla: np. zacząć od ostrzeżeń w aplikacji za wczesne naruszenia, a następnie przekazać jest kontynuacja niepożądanego zachowania użytkownika. W ostateczności możesz całkowicie uniemożliwić użytkownikowi interakcję z aplikacją.
• Przy każdej aktualizacji zasad unieważniania użyj swojego kanał komunikacji, aby poinformować użytkowników o zmianach. Udostępnij użytkownikom na dokładne zrozumienie tych zmian, zanim wpłyną one w Twojej aplikacji.
• Należy udzielać użytkownikom szczerości i informować ich o wszelkich działaniach, takich jak odebranie im dostępu do produktu w aplikacji. Użytkownicy powinni mieć możliwość kwestionować swoje decyzje i powinny one być traktowane uczciwie.
• Monitoruj formularze opinii i fora społeczności, aby dowiedzieć się, co skłania użytkowników do podjęcia decyzji nieodpowiednie zachowanie i sposoby ich prowadzenia. Wykonaj te czynności jako pierwszej linii obrony.