Method: monetization.onetimeproducts.purchaseOptions.batchUpdateStates

Kích hoạt hoặc huỷ kích hoạt lựa chọn mua cho một hoặc nhiều sản phẩm dùng một lần.

Yêu cầu HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchUpdateStates

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

Tham số đường dẫn

Thông số
packageName

string

Bắt buộc. Ứng dụng mẹ (tên gói) của các lựa chọn mua đã cập nhật.

productId

string

Bắt buộc. Mã sản phẩm của sản phẩm tính phí một lần chính, nếu tất cả các lựa chọn mua đã cập nhật đều thuộc cùng một sản phẩm tính phí một lần. Nếu bản cập nhật hàng loạt này áp dụng cho nhiều sản phẩm dùng một lần, hãy đặt trường này thành "-".

Nội dung yêu cầu

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

Biểu diễn dưới dạng JSON
{
  "requests": [
    {
      object (UpdatePurchaseOptionStateRequest)
    }
  ]
}
Trường
requests[]

object (UpdatePurchaseOptionStateRequest)

Bắt buộc. Danh sách yêu cầu cập nhật có tối đa 100 phần tử. Tất cả các yêu cầu phải cập nhật các lựa chọn mua hàng khác nhau.

Nội dung phản hồi

Thông báo phản hồi cho purchaseOptions.batchUpdateStates.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "oneTimeProducts": [
    {
      object (OneTimeProduct)
    }
  ]
}
Trường
oneTimeProducts[]

object (OneTimeProduct)

Danh sách các sản phẩm tính phí một lần đã cập nhật. Danh sách này sẽ khớp với các yêu cầu theo tỷ lệ 1:1, theo cùng một thứ tự.

Phạm vi uỷ quyền

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

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

UpdatePurchaseOptionStateRequest

Thông báo yêu cầu cập nhật trạng thái của một lựa chọn mua sản phẩm tính phí một lần.

Biểu diễn dưới dạng JSON
{

  // Union field state_transition_type can be only one of the following:
  "activatePurchaseOptionRequest": {
    object (ActivatePurchaseOptionRequest)
  },
  "deactivatePurchaseOptionRequest": {
    object (DeactivatePurchaseOptionRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Trường
Trường nhóm state_transition_type. Loại chuyển đổi trạng thái cần áp dụng, bạn phải đặt chính xác một loại. state_transition_type chỉ có thể là một trong những trạng thái sau:
activatePurchaseOptionRequest

object (ActivatePurchaseOptionRequest)

Kích hoạt một lựa chọn mua. Sau khi được kích hoạt, lựa chọn mua sẽ xuất hiện.

deactivatePurchaseOptionRequest

object (DeactivatePurchaseOptionRequest)

Huỷ kích hoạt một lựa chọn mua. Sau khi bạn huỷ kích hoạt, lựa chọn mua sẽ không còn xuất hiện nữa.

ActivatePurchaseOptionRequest

Thông báo yêu cầu cho UpdatePurchaseOptionState.

Biểu diễn dưới dạng JSON
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Trường
packageName

string

Bắt buộc. Ứng dụng mẹ (tên gói) của lựa chọn mua cần kích hoạt.

productId

string

Bắt buộc. Sản phẩm tính phí một lần (mã nhận dạng) gốc của lựa chọn mua cần kích hoạt.

purchaseOptionId

string

Bắt buộc. Mã lựa chọn mua của lựa chọn mua cần kích hoạt.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Mức độ dung sai về độ trễ để truyền bản cập nhật sản phẩm này. Mặc định là có độ trễ thấp.

DeactivatePurchaseOptionRequest

Thông báo yêu cầu cho UpdatePurchaseOptionState.

Biểu diễn dưới dạng JSON
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Trường
packageName

string

Bắt buộc. Ứng dụng mẹ (tên gói) của lựa chọn mua cần huỷ kích hoạt.

productId

string

Bắt buộc. Sản phẩm tính phí một lần (mã nhận dạng) chính của lựa chọn mua cần huỷ kích hoạt.

purchaseOptionId

string

Bắt buộc. Mã lựa chọn mua hàng của lựa chọn mua hàng cần huỷ kích hoạt.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Mức độ dung sai về độ trễ để truyền bản cập nhật sản phẩm này. Mặc định là có độ trễ thấp.