Method: monetization.subscriptions.basePlans.batchUpdateStates

Kích hoạt hoặc huỷ kích hoạt các 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 thông lượng 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 mới cập nhật.
productId

string

Bắt buộc. Mã sản phẩm của gói thuê bao chính nếu tất cả cá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 theo lô này áp dụng cho nhiều gói thuê bao, hãy đặt trường này thành "-". Phải đặt.

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 gồm tối đa 100 phần tử. Tất cả các yêu cầu đề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 các yêu cầu 1 với một 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

Yêu cầu gửi tin nhắn để cập nhật trạng thái của gói cơ bản trong 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 kết hợp state_transition_type. Loại chuyển đổi trạng thái cần áp dụng, 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 đây:
activateBasePlanRequest

object (ActivateBasePlanRequest)

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

object (DeactivateBasePlanRequest)

Vô hiệu hoá gói cơ bản. Sau khi bị 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ẽ duy trì gói thuê bao

ActivateBasePlanRequest

Yêu cầu thông báo 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 sẽ được kích hoạt.
productId

string

Bắt buộc. Gói thuê bao chính (Mã nhận dạng) của gói cơ bản sẽ được 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 sẽ được kích hoạt.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

Yêu cầu thông báo 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 sẽ bị vô hiệu hoá.
productId

string

Bắt buộc. Gói thuê bao gốc (Mã nhận dạng) của gói cơ bản sẽ bị huỷ 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 sẽ bị vô hiệu hoá.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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