Method: orders.reviewrefund

Podawanie preferencji dotyczących zwrotu środków i informacji o użytkowaniu zakupu w przypadku żądania zwrotu środków

Żądanie HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Wymagane. Nazwa pakietu aplikacji, w której kupiono subskrypcję lub produkt w aplikacji (np. „com.some.thing”).
orderId

string

Wymagane. Identyfikator zamówienia podany użytkownikowi podczas zakupu subskrypcji lub zamówienia w aplikacji.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Pola
pendingRefundToken

string

Wymagane. Token oczekującego zwrotu środków zawarty w powiadomieniu o oczekującym zwrocie środków.
sampleContentProvided

boolean

Wymagane. Wskazuje, czy przed zakupem udostępniono bezpłatną próbkę, okres próbny lub informacje o funkcjonalności.
refundPreference

enum (RefundPreference)

Wymagane. Wskazuje, czy według Twojej logiki operacyjnej Sklep Play powinien przyznać zwrot środków.
consumptionPercentageMilliunits

integer

Opcjonalnie. Odsetek zakupu w aplikacji, z którego skorzystał klient, w milijednostkach. Minimum: 0,maksimum: 100 000. W przypadku płatnych aplikacji można pominąć tę informację. Przykład : 45200 oznacza 45,2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Opcjonalnie. Lista zdarzeń, z których każde reprezentuje przypadek, w którym użytkownik skorzystał z zakupionego produktu lub usługi. Listy zawierające ponad 1000 elementów zostaną odrzucone.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

RefundPreference

Wskazuje, czy według Twojej logiki operacyjnej Sklep Play powinien przyznać zwrot środków.

Wartości w polu enum
REFUND_PREFERENCE_UNSPECIFIED Nieokreślona preferencja orders.refund. Ta wartość nie jest używana.
DECLINE Deweloper woli, aby Google Play odrzucił prośbę o zwrot środków.
APPROVE Deweloper woli, aby Google Play przyznało pełny zwrot środków.
NEUTRAL Deweloper nie ma preferencji co do decyzji Google o przyznaniu zwrotu środków.

ConsumptionUsageEvent

Lista zdarzeń, z których każde reprezentuje przypadek, w którym użytkownik skorzystał z zakupionego produktu lub usługi.

Zapis JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Pola
obfuscatedAccountId

string

Opcjonalnie. Zaciemniony ciąg znaków, który jest jednoznacznie powiązany z kontem użytkownika kupującego w aplikacji. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String
obfuscatedProfileId

string

Opcjonalnie. Zaciemniony ciąg znaków, który jest jednoznacznie powiązany z profilem użytkownika kupującego w aplikacji. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Opcjonalnie. Czas, w którym użytkownik korzystał z treści, pobrał je, otworzył lub odtworzył strumieniowo.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
ipAddress

string

Opcjonalnie. Adres IP, z którego nastąpiło wykorzystanie.
consumptionItemDescription

string

Opcjonalnie. Tekst w dowolnej formie, który umożliwia deweloperom podanie dodatkowych informacji o wykorzystanym produkcie. Maksymalna długość to 5000 znaków.
location

object (CoarseLocation)

Opcjonalnie. Lokalizacja geograficzna, w której nastąpiło zużycie.

CoarseLocation

Szczegóły przybliżonej lokalizacji geograficznej, w której nastąpiło wykorzystanie.

Zapis JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Pola
regionCode

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu. Ta wartość nigdy nie jest wywnioskowana, więc musisz zadbać o jej poprawność. Przykład: „CH” w przypadku Szwajcarii.
administrativeArea

string

Opcjonalnie. Najwyższy stopień podziału administracyjnego, który jest używany w przypadku adresów pocztowych w danym kraju lub regionie. Może to być na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, a nie „Katalonia”). W wielu krajach w adresach pocztowych nie używa się obszaru administracyjnego. Na przykład w Szwajcarii to pole powinno pozostać puste.
locality

string

Opcjonalnie. Zwykle odnosi się do części adresu, która określa miasto lub miejscowość. Przykłady: miasto w Stanach Zjednoczonych, gmina we Włoszech, miasto pocztowe w Wielkiej Brytanii. W regionach świata, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, pozostaw pole locality puste.
sublocality

string

Opcjonalnie. Podregion adresu. Może to być np. dzielnica lub okręg. W przypadku większości adresów możesz pominąć tę informację.