- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- UpdateSubscriptionOfferStateRequest
- ActivateSubscriptionOfferRequest
- DeactivateSubscriptionOfferRequest
- 試試看!
更新訂閱優惠狀態批次。
將巢狀要求的延遲時間 Tolerance 欄位設為 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT,才能達到最大更新處理量。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
packageName |
必要欄位。更新訂閱項目優惠的上層應用程式 (套件名稱)。 必須等於所有已更新 SubscriptionOffer 資源中的 packageName 欄位。 |
productId |
必要欄位。如果所有更新後的優惠都屬於同一個訂閱項目,則父項訂閱項目的產品 ID。如果這項要求涵蓋多個訂閱項目,請將這個欄位設為「-」。必須設定。 |
basePlanId |
必要欄位。要更新優惠的上層基本方案 (ID)。可以指定為「-」更新多個基本方案的優惠。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"requests": [
{
object ( |
欄位 | |
---|---|
requests[] |
必要欄位。更新要求清單,最多包含 100 個元素。所有要求都必須更新不同優惠。 |
回應主體
offer.batchUpdateStates 的回應訊息。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"subscriptionOffers": [
{
object ( |
欄位 | |
---|---|
subscriptionOffers[] |
更新後的訂閱項目優惠清單。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferStateRequest
要求訊息更新訂閱優惠狀態。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 state_transition_type 。要套用的狀態轉換類型,只能設定一項。state_transition_type 只能是下列其中一項: |
|
activateSubscriptionOfferRequest |
啟用優惠。啟用後,新訂閱者就能享有這項優惠。 |
deactivateSubscriptionOfferRequest |
停用優惠。停用方案後,新訂閱者就無法享有這項優惠,但現有訂閱者仍可繼續訂閱 |
ActivateSubscriptionOfferRequest
ActivateSubscriptionOffer 的要求訊息。
JSON 表示法 |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
欄位 | |
---|---|
packageName |
必要欄位。要啟用優惠的父項應用程式 (套件名稱)。 |
productId |
必要欄位。要啟用的優惠父項訂閱項目 (ID)。 |
basePlanId |
必要欄位。要啟用優惠的上層基本方案 (ID)。 |
offerId |
必要欄位。要啟用的優惠專屬優惠 ID。 |
latencyTolerance |
選用設定。這項產品更新傳播的延遲時間容忍度。預設為易受延遲時間影響。 |
DeactivateSubscriptionOfferRequest
要求 Offer.deactivate 的訊息。
JSON 表示法 |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
欄位 | |
---|---|
packageName |
必要欄位。要停用優惠的父項應用程式 (套件名稱)。 |
productId |
必要欄位。要停用優惠的上層訂閱項目 (ID)。 |
basePlanId |
必要欄位。要停用優惠的父項基本方案 (ID)。 |
offerId |
必要欄位。要停用優惠的專屬優惠 ID。 |
latencyTolerance |
選用設定。這項產品更新傳播的延遲時間容忍度。預設為易受延遲時間影響。 |