Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Cập nhật hàng loạt trạng thái ưu đãi gói thuê bao.

Đặt trường latencyTolerance trên các yêu cầu lồng nhau thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT để đạt được tốc độ cập nhật tối đa.

Yêu cầu HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/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 các ưu đãi thuê bao đã cập nhật.

Phải bằng với trường packageName trên tất cả tài nguyên SubscriptionOffer đã cập nhật.
productId

string

Bắt buộc. Mã sản phẩm của gói thuê bao mẹ, nếu tất cả các ưu đãi đã cập nhật đều thuộc cùng một gói thuê bao. Nếu yêu cầu này trải dài trên nhiều gói thuê bao, hãy đặt trường này thành "-". Bạn phải đặt trường này.
basePlanId

string

Bắt buộc. Mã (mã nhận dạng) của gói cơ bản gốc mà bạn cần cập nhật ưu đãi. Có thể được chỉ định là "-" để cập nhật ưu đãi từ nhiều gói cơ bản.

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 (UpdateSubscriptionOfferStateRequest)
    }
  ]
}
Trường
requests[]

object (UpdateSubscriptionOfferStateRequest)

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 mặt hàng 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 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Trường
subscriptionOffers[]

object (SubscriptionOffer)

Danh sách ưu đãi gói thuê bao đã cập nhật.

Phạm vi uỷ quyền

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

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

UpdateSubscriptionOfferStateRequest

Yêu cầu thông báo để cập nhật trạng thái của ưu đãi thuê bao.

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

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Trường
Trường hợp hợp nhất state_transition_type. Loại chuyển đổi trạng thái sẽ áp dụng, bạn phải đặt đúng một loại. state_transition_type chỉ có thể là một trong những loại sau:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Kích hoạt ưu đãi. Sau khi được kích hoạt, ưu đãi này sẽ được cung cấp cho người đăng ký mới.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Huỷ kích hoạt ưu đãi. Sau khi bạn huỷ kích hoạt, người đăng ký mới sẽ không thấy ưu đãi này nữa, nhưng người đăng ký hiện tại sẽ tiếp tục duy trì gói thuê bao của họ

ActivateSubscriptionOfferRequest

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

Biểu diễn dưới dạng JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": 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 kích hoạt.
productId

string

Bắt buộc. Gói thuê bao gốc (mã) của ưu đãi cần kích hoạt.
basePlanId

string

Bắt buộc. Gói cơ bản gốc (mã) của ưu đãi cần kích hoạt.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Độ trễ cho phép để truyền tải nội dung cập nhật sản phẩm này. Giá trị mặc định là nhạy cảm với độ trễ.

DeactivateSubscriptionOfferRequest

Yêu cầu thông báo cho offers.deactivate.

Biểu diễn dưới dạng JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": 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. Gói thuê bao mẹ (mã) của ưu đãi cần huỷ kích hoạt.
basePlanId

string

Bắt buộc. Gói cơ bản gốc (mã) của ưu đãi cần vô hiệu hoá.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Độ trễ cho phép để truyền tải nội dung cập nhật sản phẩm này. Giá trị mặc định là nhạy cảm với độ trễ.