Method: monetization.subscriptions.basePlans.batchUpdateStates

Kích hoạt hoặc huỷ kích hoạt gói cơ bản trên một hoặc nhiều 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: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 gói cơ bản đã 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ả gói cơ bản đã cập nhật đều thuộc cùng một gói thuê bao. Nếu quá trình cập nhật hàng loạt 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.

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

object (UpdateBasePlanStateRequest)

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 gói cơ bản khác nhau.

Nội dung phản hồi

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

object (Subscription)

Danh sách các gói thuê bao đã cập nhật. Danh sách này sẽ so khớp từng yêu cầu với nhau 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

UpdateBasePlanStateRequest

Thông báo yêu cầu cập nhật trạng thái của gói cơ bản của gói thuê bao.

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

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // 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:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Kích hoạt gói cơ bản. Sau khi bạn kích hoạt, người đăng ký mới sẽ thấy các gói cơ bản.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

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

ActivateBasePlanRequest

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

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

string

Bắt buộc. Ứng dụng mẹ (tên gói) của gói cơ bản cần kích hoạt.
productId

string

Bắt buộc. Gói thuê bao mẹ (mã) của gói cơ bản cần kích hoạt.
basePlanId

string

Bắt buộc. Mã nhận dạng gói cơ bản duy nhất của gói cơ bản 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ễ.

DeactivateBasePlanRequest

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

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

string

Bắt buộc. Ứng dụng mẹ (tên gói) của gói cơ bản cần vô hiệu hoá.
productId

string

Bắt buộc. Gói thuê bao mẹ (mã) của gói cơ bản cần vô hiệu hoá.
basePlanId

string

Bắt buộc. Mã nhận dạng gói cơ bản duy nhất của gói cơ bản cần vô hiệu hoá.
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ễ.