Method: orders.reviewrefund

Fornire le preferenze di rimborso e l'utilizzo dell'acquisto per una richiesta di storno di addebito

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

Obbligatorio. Il nome del pacchetto dell'applicazione per cui è stato acquistato questo abbonamento o articolo in-app (ad esempio "com.some.thing").
orderId

string

Obbligatorio. L'ID ordine fornito all'utente al momento dell'acquisto dell'abbonamento o dell'ordine in-app.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

string

Obbligatorio. Il token di rimborso in attesa incluso nella notifica di revisione del rimborso in attesa.
sampleContentProvided

boolean

Obbligatorio. Indica se hai fornito un campione senza costi, una prova o informazioni sulla funzionalità prima dell'acquisto.
refundPreference

enum (RefundPreference)

Obbligatorio. Indica la tua preferenza, in base alla tua logica operativa, in merito alla concessione del rimborso da parte del Play Store.
consumptionPercentageMilliunits

integer

Facoltativo. Percentuale dell'acquisto in-app consumato dal cliente, in millisecondi. Minimo: 0. Massimo: 100.000. Per le app a pagamento, questo campo può essere omesso. Esempio : 45200 rappresenta il 45,2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Facoltativo. Elenco di eventi, ognuno dei quali rappresenta un'istanza in cui l'utente ha consumato o utilizzato l'articolo o il servizio acquistato. Gli elenchi con più di 1000 elementi verranno rifiutati.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

RefundPreference

Indica la tua preferenza, in base alla tua logica operativa, in merito alla concessione del rimborso da parte del Play Store.

Enum
REFUND_PREFERENCE_UNSPECIFIED orders.refund preference unspecified. Questo valore non viene utilizzato.
DECLINE Lo sviluppatore preferisce che Play rifiuti il rimborso.
APPROVE Lo sviluppatore preferisce che Play conceda il rimborso completo.
NEUTRAL Lo sviluppatore non ha preferenze in merito alla decisione di Google Play di emettere un rimborso

ConsumptionUsageEvent

Elenco di eventi, ognuno dei quali rappresenta un'istanza in cui l'utente ha consumato o utilizzato l'articolo o il servizio acquistato.

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

string

Facoltativo. Stringa offuscata associata in modo univoco all'account utente dell'acquirente nell'app. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

Facoltativo. Stringa offuscata associata in modo univoco al profilo utente dell'acquirente nell'app. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Facoltativo. Ora in cui l'utente ha consumato, utilizzato, scaricato, aperto o riprodotto in streaming i contenuti.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
ipAddress

string

Facoltativo. L'indirizzo IP da cui è stato effettuato il consumo.
consumptionItemDescription

string

Facoltativo. Testo in formato libero che consente agli sviluppatori di fornire maggiori informazioni sull'articolo consumato. La lunghezza massima è di 5000 caratteri.
location

object (CoarseLocation)

Facoltativo. Posizione geografica in cui si è verificato il consumo.

CoarseLocation

Dettagli approssimativi della posizione geografica in cui è avvenuto il consumo.

Rappresentazione JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Campi
regionCode

string

Obbligatorio. Codice regione CLDR del paese/della regione dell'indirizzo. Questo valore non viene mai dedotto e devi assicurarti che sia corretto. Esempio: "CH" per la Svizzera.
administrativeArea

string

Facoltativo. Suddivisione amministrativa di grado più alto usata per l'indirizzo postale di un paese o di una regione. Ad esempio, può trattarsi di uno stato, una provincia, un oblast o una prefettura. Per la Spagna, si tratta della provincia e non della comunità autonoma (ad esempio, "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad esempio, in Svizzera questo campo deve essere lasciato vuoto.
locality

string

Facoltativo. Solitamente si riferisce alla porzione di città dell'indirizzo. Esempio: "city" per gli Stati Uniti, "comune" in Italia, "post town" nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non rientrano nella struttura, lascia il campo locality vuoto.
sublocality

string

Facoltativo. Quartiere dell'indirizzo. Ad esempio, un quartiere, un distretto o una zona. Per la maggior parte degli indirizzi, puoi ometterlo.