Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Cập nhật một loạt trạng thái của sản phẩm tính phí một lần.

Yêu cầu HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers: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 sản phẩm dùng một lần được 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 sản phẩm được 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 "-".
purchaseOptionId

string

Bắt buộc. Mã lựa chọn mua của lựa chọn mua chính, nếu tất cả các sản phẩm được cập nhật đều thuộc cùng một lựa chọn mua. Nếu bản cập nhật hàng loạt này áp dụng cho nhiều lựa chọn mua, 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 (UpdateOneTimeProductOfferStateRequest)
    }
  ]
}
Trường
requests[]

object (UpdateOneTimeProductOfferStateRequest)

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 sản phẩm khác nhau.

Nội dung phản hồi

Thông báo phản hồi cho offers.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 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Trường
oneTimeProductOffers[]

object (OneTimeProductOffer)

Danh sách sản phẩm tính phí một lần đã cập nhật, theo cùng thứ tự như yêu cầu.

Phạm vi uỷ quyền

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

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

UpdateOneTimeProductOfferStateRequest

Thông báo yêu cầu cập nhật trạng thái của một 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:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // 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:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Kích hoạt một ưu đãi. Sau khi được kích hoạt, ưu đãi sẽ được cung cấp cho người dùng, miễn là họ đáp ứng các điều kiện.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Huỷ ưu đãi. Sau khi bị huỷ, người dùng sẽ không thể sử dụng ưu đãi này. Mọi đơn đặt hàng đang chờ xử lý liên quan đến ưu đãi này sẽ bị huỷ. Quá trình chuyển đổi trạng thái này dành riêng cho đơn đặt hàng trước.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Huỷ kích hoạt ưu đãi. Sau khi bạn huỷ kích hoạt, người dùng sẽ không thấy ưu đãi này nữa. Quá trình chuyển đổi trạng thái này dành riêng cho các mặt hàng được chiết khấu.

CancelOneTimeProductOfferRequest

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

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

string

Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi cần huỷ.
productId

string

Bắt buộc. Sản phẩm tính phí một lần gốc (mã nhận dạng) của ưu đãi cần huỷ.
purchaseOptionId

string

Bắt buộc. Lựa chọn mua hàng gốc (mã nhận dạng) của ưu đãi cần huỷ.
offerId

string

Bắt buộc. Mã ưu đãi của ưu đãi cần huỷ.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Độ trễ cho phép đối với việc truyền bản cập nhật này. Mặc định là có độ trễ thấp.

DeactivateOneTimeProductOfferRequest

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

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

string

Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi 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) gốc của ưu đãi cần huỷ kích hoạt.
purchaseOptionId

string

Bắt buộc. Lựa chọn mua tổng/chính (mã nhận dạng) của ưu đãi cần huỷ kích hoạt.
offerId

string

Bắt buộc. Mã ưu đãi của ưu đãi cần huỷ kích hoạt.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Độ trễ cho phép đối với việc truyền bản cập nhật này. Mặc định là có độ trễ thấp.