Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

建立或更新一或多個一次性產品優惠。

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
packageName

string

必要欄位。更新後優惠的父項應用程式 (套件名稱)。

必須等於所有更新的 OneTimeProductOffer 資源中的 packageName 欄位。
productId

string

必要欄位。如果所有更新的方案都屬於同一項產品，請提供父項一次性產品的產品 ID。如果這項要求涵蓋多個一次性產品，請將這個欄位設為「-」。
purchaseOptionId

string

必要欄位。要更新優惠的父項購買選項 (ID)。可指定為「-」，更新多個購買選項的方案。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferRequest)
    }
  ]
}
欄位
requests[]

object (UpdateOneTimeProductOfferRequest)

必要欄位。最多 100 個元素的更新要求清單。所有要求都必須更新不同的方案。

回應主體

offers.batchUpdate 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
欄位
oneTimeProductOffers[]

object (OneTimeProductOffer)

更新後的一次性產品方案清單，順序與要求相同。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/androidpublisher

UpdateOneTimeProductOfferRequest

UpdateOneTimeProductOffer 的要求訊息。

JSON 表示法 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
欄位
oneTimeProductOffer

object (OneTimeProductOffer)

必要欄位。要更新的一次性產品優惠。
updateMask

string (FieldMask format)

必要欄位。要更新的欄位清單。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
regionsVersion

object (RegionsVersion)

必要欄位。優惠使用的可用區域版本。
allowMissing

boolean

(選用步驟) 如果設為 true，且具有指定 packageName、productId、purchaseOptionId 和 offerId 的方案不存在，系統就會建立方案。

如果建立新方案，系統會忽略 updateMask。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

(選用步驟) 這項優惠更新的傳播延遲容許量。預設為延遲時間敏感。