跳轉到主要內容
PUT
啟動或暫停您透過 Ayrshare 建立的 Google Ads 廣告活動、重新命名,或變更其每日預算或結束日期。
  • 請至少傳送一個欄位。同一請求中的所有變更會一併套用,或全部不套用。
  • 建立廣告活動後,便無法變更 type、accountId 或 euPoliticalAdvertising。
  • 不需要 Idempotency-Key:再次傳送相同的變更只會設定相同的值。
  • 回應會返回廣告活動的 campaignStatus。若要讀取其他欄位,請使用 取得廣告活動。

請求頭參數

路徑參數

string
必填
建立廣告活動時返回的 campaignId。

請求體參數

string
active 或 paused。當 Ayrshare 已在 Google 上暫停廣告時,只傳送 status: "paused" 的請求不會被阻擋。
string
新的廣告活動名稱,1 到 255 個字元,不可包含換行。
object
{ "amount": number }:新的每日支出金額,以廣告帳戶的貨幣計算,最多兩位小數。若廣告活動的預算已在 Google Ads 中與其他廣告活動共用,會返回 code: 101:請在 Google Ads 中變更共用預算。
object
{ "end": string }:新的結束日期,格式為 ISO 日期(2026-11-30)或日期時間。Google 以廣告帳戶時區的完整日期進行排程,因此廣告活動會於當天 23:59:59 結束。結束日期可以與開始日期為同一天,但不能更早。

錯誤