Method: orders.reviewrefund

Укажите предпочтительный способ возврата средств и информацию об использовании покупки для запроса на возврат платежа.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
packageName

string

Обязательно. Название пакета приложения, для которого была приобретена эта подписка или внутриигровой элемент (например, 'com.some.thing').

orderId

string

Обязательно. Идентификатор заказа, предоставленный пользователю при покупке подписки или оформлении заказа внутри приложения.

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Поля
pendingRefundToken

string

Обязательно. Токен подтверждения ожидающего возврата средств, указанный в уведомлении о проверке ожидающего возврата средств.

sampleContentProvided

boolean

Обязательно. Указывает, предоставляли ли вы бесплатный образец, пробную версию или информацию о функциональности до покупки.

refundPreference

enum ( RefundPreference )

Обязательно. Указывает ваше предпочтение, исходя из вашей логики, относительно того, следует ли Play Store предоставить возврат средств.

consumptionPercentageMilliunits

integer

Необязательно. Процент от суммы покупки внутри приложения, уплаченной клиентом, в миллиединицах. Минимум: 0, максимум: 100 000. Для платных приложений этот параметр можно опустить. Пример: 45200 означает 45,2%.

consumptionUsageEvents[]

object ( ConsumptionUsageEvent )

Необязательно. Список событий, каждое из которых представляет собой случай, когда пользователь потребил или использовал приобретенный товар или услугу. Списки, содержащие более 1000 элементов, будут отклонены.

Ответный текст

В случае успеха тело ответа будет пустым.

Области полномочий

Требуется следующая область действия OAuth:

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

Предпочтение возврата средств

Указывает ваше предпочтение, основанное на вашей логике действий, относительно того, следует ли Play Store предоставить возврат средств.

Перечисления
REFUND_PREFERENCE_UNSPECIFIED Предпочтение orders.refund не указано. Это значение не используется.
DECLINE Разработчик предпочитает, чтобы Play отказал в возврате средств.
APPROVE Разработчик предпочитает, чтобы Play вернул деньги в полном объеме.
NEUTRAL Разработчик не имеет права голоса в отношении решения Google Play о возврате средств.

ConsumptionUsageEvent

Список событий, каждое из которых представляет собой случай, когда пользователь воспользовался приобретенным товаром или услугой.

JSON-представление 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Поля
obfuscatedAccountId

string

Необязательный параметр. Зашифрованная строка, однозначно связанная с учетной записью пользователя покупателя в приложении. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String )

obfuscatedProfileId

string

Необязательный параметр. Зашифрованная строка, однозначно связанная с профилем пользователя покупателя в приложении. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String )

consumptionTime

string ( Timestamp format)

Необязательно. Время, когда пользователь просматривал, использовал, скачивал, открывал или транслировал контент.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

ipAddress

string

Необязательно. IP-адрес, с которого было совершено потребление.

consumptionItemDescription

string

Необязательно. Текст в свободной форме, позволяющий разработчикам предоставить дополнительную информацию об используемом товаре. Максимальная длина — 5000 символов.

location

object ( CoarseLocation )

Необязательно. Географическое местоположение, где произошло потребление.

Грубое местоположение

Приблизительные географические данные о месте потребления.

JSON-представление 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Поля
regionCode

string

Обязательно. Региональный код CLDR страны/региона, в котором находится адрес. Это значение никогда не определяется автоматически, и вы должны убедиться в его правильности. Пример: "CH" для Швейцарии.

administrativeArea

string

Необязательно. Высшая административная единица, используемая для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Во многих странах административный район не используется в почтовых адресах. Например, в Швейцарии его следует оставлять незаполненным.

locality

string

Необязательно. Обычно относится к части адреса, обозначающей город или населенный пункт. Примеры: город в США, коммуна в ИТ-секторе, почтовый город в Великобритании. В регионах мира, где населенные пункты плохо определены или не вписываются в эту структуру, оставьте locality пустым.

sublocality

string

Необязательно. Укажите принадлежность адреса к определенному району. Например, это может быть микрорайон, квартал или округ. Для большинства адресов этот параметр можно опустить.