Method: monetization.subscriptions.basePlans.offers.batchUpdate

Cập nhật hàng loạt ưu đã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/{basePlanId}/offers:batchUpdate

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 thuê bao được cập nhật.

Phải bằng trường packageName trên tất cả tài nguyên SubscriptionOffer.

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 ưu đãi được cập nhật đều thuộc về cùng một gói thuê bao. Nếu yêu cầu này áp dụng cho nhiều gói thuê bao, hãy đặt trường này thành "-". Phải đặt.

basePlanId

string

Bắt buộc. Gói cơ bản (ID) gốc cần được cập nhật ưu đãi. Có thể được chỉ định là '-' để cập nhật ưu đãi trong 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 (UpdateSubscriptionOfferRequest)
    }
  ]
}
Trường
requests[]

object (UpdateSubscriptionOfferRequest)

Bắt buộc. Danh sách các 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 ưu đãi thuê bao khác nhau.

Nội dung phản hồi

Thông báo phản hồi cho offer.batchUpdate.

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 thuê bao mới 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

UpdateSubscriptionOfferRequest

Yêu cầu tin nhắn đối với offer.patch.

Biểu diễn dưới dạng JSON
{
  "subscriptionOffer": {
    object (SubscriptionOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Trường
subscriptionOffer

object (SubscriptionOffer)

Bắt buộc. Gói thuê bao cần cập nhật.

updateMask

string (FieldMask format)

Bắt buộc. Danh sách các trường cần cập nhật.

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

regionsVersion

object (RegionsVersion)

Bắt buộc. Phiên bản của các khu vực hiện có đang dùng cho ưu đãi subscriptionOffer.

allowMissing

boolean

Không bắt buộc. Nếu bạn đặt chính sách này thành true và ưu đãi thuê bao có packageName, productId, basePlanId và offerId đã cho không tồn tại, thì một ưu đãi sẽ được tạo.

Nếu một ưu đãi mới được tạo, thì updateMask sẽ bị bỏ qua.

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ễ.