Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Cập nhật một loạt trạng thái ưu đã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

Tham số
packageName

string

Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi sản phẩm tính phí một lần đã 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ả ưu đãi đượ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 lần cập nhật theo lô này áp dụng cho nhiều sản phẩm tính phí 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ả ưu đãi được cập nhật đều thuộc cùng một lựa chọn mua. Nếu nội dung cập nhật theo lô 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 với 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 ưu đãi 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 ưu đãi 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 ưu đãi sản phẩm tính phí một lần.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
Trường
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. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Kích hoạ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 của ưu đãi.

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Huỷ một ưu đãi. Sau khi bị huỷ, ưu đãi sẽ không còn được cung cấp cho người dùng. 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 chỉ dành riêng cho đơn đặt hàng trước.

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Huỷ kích hoạt ưu đãi. Sau khi bị huỷ kích hoạt, ưu đãi sẽ không còn được cung cấp cho người dùng nữa. Quá trình chuyển đổi trạng thái này dành riêng cho ưu đãi giảm giá và ưu đãi phần thưởng trong trò chơi.

Kết thúc các trường loại trừ lẫn nhau.

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 chính (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 tải bản cập nhật này. Giá trị mặc định là nhạy cảm với độ trễ.

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 gốc (mã nhận dạng) của ưu đãi cần huỷ kích hoạt.

purchaseOptionId

string

Bắt buộc. Lựa chọn mua 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 tải bản cập nhật này. Giá trị mặc định là nhạy cảm với độ trễ.