更新批次訂閱優惠。
將巢狀要求的延遲時間 Tolerance 欄位設為 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT,才能達到最大更新處理量。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
packageName |
必要欄位。更新訂閱項目優惠的上層應用程式 (套件名稱)。 必須等於所有已更新 SubscriptionOffer 資源中的 packageName 欄位。 |
productId |
必要欄位。如果所有更新後的優惠都屬於同一個訂閱項目,則父項訂閱項目的產品 ID。如果這項要求涵蓋多個訂閱項目,請將這個欄位設為「-」。必須設定。 |
basePlanId |
必要欄位。要更新優惠的上層基本方案 (ID)。可以指定為「-」更新多個基本方案的優惠。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"requests": [
{
object ( |
欄位 | |
---|---|
requests[] |
必要欄位。最多包含 100 個元素的更新要求清單。所有要求都必須更新不同的訂閱優惠。 |
回應主體
offer.batchUpdate 的回應訊息。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"subscriptionOffers": [
{
object ( |
欄位 | |
---|---|
subscriptionOffers[] |
更新後的訂閱項目優惠清單。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferRequest
針對 offer.patch 的要求訊息。
JSON 表示法 |
---|
{ "subscriptionOffer": { object ( |
欄位 | |
---|---|
subscriptionOffer |
必要欄位。要更新的訂閱優惠。 |
updateMask |
必要欄位。要更新的欄位清單。 這是以半形逗號分隔的完整欄位名稱清單。範例: |
regionsVersion |
必要欄位。用於 subscriptionOffer 的可用地區版本。 |
allowMissing |
選用設定。如果設為 true,且指定 packageName、productId、basePlanId 和 offerId 的訂閱優惠不存在,系統將建立優惠。 如果建立新優惠,系統會忽略 updateMask。 |
latencyTolerance |
選用設定。這項產品更新傳播的延遲時間容忍度。預設為易受延遲時間影響。 |