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 độ trễTolerance 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

Thông số
packageName

string

Bắt buộc. Ứng dụng gốc (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 chính, trong trường hợp tất cả các gói cơ bản đã cập nhật đều thuộc về cùng một gói thuê bao. Nếu nội dung 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 "-". 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)
    }
  ]
}
Các 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ả 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)
    }
  ]
}
Các 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 một với một, theo cùng 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 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.
}
Các trường
Trường nhóm state_transition_type. Loại chuyển đổi trạng thái cần áp dụng, phải đặt đúng 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 bạn kích hoạt, gói cơ bản sẽ được cung cấp cho người đăng ký mới.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Huỷ kích hoạt gói cơ bản. Sau khi bị vô hiệu hoá, người đăng ký mới sẽ không sử dụng được gói cơ bản này, nhưng những người đăng ký hiện tại sẽ vẫn duy trì gói thuê bao đó

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)
}
Các trường
packageName

string

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

string

Bắt buộc. Mã nhận dạng gói thuê bao chính của gói cơ bả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. Dung sai về độ trễ khi truyền bản cập nhật sản phẩm này. Giá trị mặc định là phụ thuộc vào độ trễ.

DeactivateBasePlanRequest

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

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

string

Bắt buộc. Ứng dụng gốc (tên gói) của gói cơ bản để huỷ 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 cần vô hiệu hoá.
basePlanId

string

Bắt buộc. Mã nhận dạng gói cơ bản riêng biệt của gói cơ bản cần huỷ kích hoạt.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Không bắt buộc. Dung sai về độ trễ khi truyền bản cập nhật sản phẩm này. Giá trị mặc định là phụ thuộc vào độ trễ.