Method: orders.reviewrefund

Cung cấp lựa chọn hoàn tiền và thông tin sử dụng giao dịch mua cho yêu cầu hoàn phí

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
packageName

string

Bắt buộc. Tên gói của ứng dụng mà người dùng đã mua gói thuê bao hoặc mặt hàng trong ứng dụng này (ví dụ: "com.some.thing").
orderId

string

Bắt buộc. Mã đơn đặt hàng được cung cấp cho người dùng khi họ mua gói thuê bao hoặc đơn đặt hàng trong ứng dụng.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Trường
pendingRefundToken

string

Bắt buộc. Mã thông báo hoàn tiền đang chờ xử lý có trong thông báo xem xét yêu cầu hoàn tiền đang chờ xử lý.
sampleContentProvided

boolean

Bắt buộc. Cho biết bạn có cung cấp mẫu miễn phí, bản dùng thử hoặc thông tin về chức năng trước khi mua hay không.
refundPreference

enum (RefundPreference)

Bắt buộc. Cho biết lựa chọn ưu tiên của bạn (dựa trên logic vận hành của bạn) về việc Cửa hàng Play có nên hoàn tiền hay không.
consumptionPercentageMilliunits

integer

Không bắt buộc. Tỷ lệ phần trăm giao dịch mua hàng trong ứng dụng mà khách hàng đã sử dụng, tính bằng đơn vị mili. Tối thiểu: 0 Tối đa: 100.000. Bạn có thể bỏ qua bước này đối với ứng dụng có tính phí. Ví dụ : 45200 biểu thị 45,2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Không bắt buộc. Danh sách các sự kiện, mỗi sự kiện đại diện cho một trường hợp người dùng tiêu thụ hoặc sử dụng mặt hàng hoặc dịch vụ đã mua. Danh sách có hơn 1.000 mục sẽ bị từ chối.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

RefundPreference

Cho biết lựa chọn ưu tiên của bạn (dựa trên logic vận hành của bạn) về việc Cửa hàng Play có nên hoàn tiền hay không.

Enum
REFUND_PREFERENCE_UNSPECIFIED orders.refund preference chưa được chỉ định. Giá trị này không được sử dụng.
DECLINE Nhà phát triển muốn Play từ chối yêu cầu hoàn tiền.
APPROVE Nhà phát triển muốn Play hoàn tiền toàn bộ.
NEUTRAL Nhà phát triển không có ý kiến về quyết định hoàn tiền của Google Play

ConsumptionUsageEvent

Danh sách các sự kiện, mỗi sự kiện đại diện cho một trường hợp người dùng tiêu thụ hoặc sử dụng mặt hàng hoặc dịch vụ đã mua.

Biểu diễn dưới dạng JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Trường
obfuscatedAccountId

string

Không bắt buộc. Chuỗi bị làm rối được liên kết với một tài khoản người dùng duy nhất của người mua trong ứng dụng. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

Không bắt buộc. Chuỗi bị làm rối được liên kết duy nhất với hồ sơ người dùng của người mua trong ứng dụng. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Không bắt buộc. Thời gian người dùng sử dụng, tải xuống, mở hoặc phát trực tuyến nội dung.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
ipAddress

string

Không bắt buộc. Địa chỉ IP nơi xảy ra mức tiêu thụ.
consumptionItemDescription

string

Không bắt buộc. Văn bản dạng tự do cho phép nhà phát triển cung cấp thêm thông tin về mặt hàng đã sử dụng. Độ dài tối đa là 5.000 ký tự.
location

object (CoarseLocation)

Không bắt buộc. Vị trí địa lý nơi xảy ra lượt sử dụng.

CoarseLocation

Thông tin chi tiết về vị trí địa lý tương đối nơi nội dung được sử dụng.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Trường
regionCode

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực trong địa chỉ. Giá trị này không bao giờ được suy luận và bạn phải đảm bảo giá trị này là chính xác. Ví dụ: "CH" cho Thuỵ Sĩ.
administrativeArea

string

Không bắt buộc. Phân khu hành chính cao nhất được dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: đây có thể là một tiểu bang, tỉnh, vùng hoặc tỉnh. Đối với Tây Ban Nha, đây là tỉnh chứ không phải cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính trong địa chỉ bưu chính. Ví dụ: Ở Thuỵ Sĩ, bạn không nên điền thông tin này.
locality

string

Không bắt buộc. Thường đề cập đến phần thành phố hoặc thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, comune ở Ý, thị trấn bưu điện ở Vương quốc Anh. Ở những khu vực trên thế giới mà địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống locality.
sublocality

string

Không bắt buộc. Tiểu khu của địa chỉ. Ví dụ: đây có thể là một khu dân cư, thị xã hoặc quận. Đối với hầu hết các địa chỉ, bạn có thể bỏ qua bước này.