Method: customers.smartCampaignSettings.getSmartCampaignStatus

傳回所請求智慧廣告活動的狀態。

HTTP 要求

GET https://googleads.googleapis.com/v14/{resourceName=customers/*/smartCampaignSettings/*}:getSmartCampaignStatus

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

路徑參數

參數
resourceName

string

必要欄位。智慧廣告活動要擷取狀態的智慧廣告活動設定資源名稱。

要求主體

要求主體必須為空白。

回應主體

SmartCampaignSettingService.GetSmartCampaignStatus 的回應訊息。

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

JSON 表示法 
{
  "smartCampaignStatus": enum (SmartCampaignStatus),

  // Union field smart_campaign_status_details can be only one of the following:
  "notEligibleDetails": {
    object (SmartCampaignNotEligibleDetails)
  },
  "eligibleDetails": {
    object (SmartCampaignEligibleDetails)
  },
  "pausedDetails": {
    object (SmartCampaignPausedDetails)
  },
  "removedDetails": {
    object (SmartCampaignRemovedDetails)
  },
  "endedDetails": {
    object (SmartCampaignEndedDetails)
  }
  // End of list of possible types for union field smart_campaign_status_details.
}
欄位
smartCampaignStatus

enum (SmartCampaignStatus)

這個智慧廣告活動的狀態。
聯集欄位 smart_campaign_status_details。與智慧廣告活動狀態相關的其他詳細資料。smart_campaign_status_details 只能是下列其中一項：
notEligibleDetails

object (SmartCampaignNotEligibleDetails)

不符合放送資格的智慧廣告活動相關詳細資料。
eligibleDetails

object (SmartCampaignEligibleDetails)

符合放送資格的智慧廣告活動相關詳細資料。
pausedDetails

object (SmartCampaignPausedDetails)

已暫停智慧廣告活動的相關詳細資料。
removedDetails

object (SmartCampaignRemovedDetails)

已移除智慧廣告活動的詳細資料。
endedDetails

object (SmartCampaignEndedDetails)

已結束的智慧廣告活動相關詳細資料。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

SmartCampaignStatus

智慧廣告活動狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN

這個版本不支援收到的值。

此值僅用於回應。
PAUSED 廣告活動已暫停。
NOT_ELIGIBLE 廣告活動不符合放送資格，且有問題可能需要介入措施。
PENDING 廣告活動尚待至少核准一個廣告。
ELIGIBLE 廣告活動符合放送資格。
REMOVED 廣告活動已遭移除。
ENDED 廣告活動已結束。

SmartCampaignNotEligibleDetails

不符合放送資格的智慧廣告活動相關詳細資料。

JSON 表示法 
{
  "notEligibleReason": enum (SmartCampaignNotEligibleReason)
}
欄位
notEligibleReason

enum (SmartCampaignNotEligibleReason)

智慧廣告活動不符合放送資格的原因。

SmartCampaignNotEligibleReason

智慧廣告活動不符合放送資格的原因。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN

這個版本不支援收到的值。

此值僅用於回應。
ACCOUNT_ISSUE 帳戶發生問題，因此廣告活動不符合放送資格。
BILLING_ISSUE 廣告活動有付款問題，因此無法放送。
BUSINESS_PROFILE_LOCATION_REMOVED 與廣告活動相關聯的商家檔案地點已遭移除。
ALL_ADS_DISAPPROVED 所有系統產生的廣告都遭到拒登。詳情請參閱 AdAd 資源中的 policySummary 欄位。

SmartCampaignEligibleDetails

符合放送資格的智慧廣告活動相關詳細資料。

JSON 表示法 
{
  "lastImpressionDateTime": string,
  "endDateTime": string
}
欄位
lastImpressionDateTime

string

這個廣告活動過去 48 小時內觀察到的最終曝光時間戳記。時間戳記會以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。
endDateTime

string

廣告活動結束的時間戳記 (如適用)。時間戳記會以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。

SmartCampaignPausedDetails

已暫停智慧廣告活動的相關詳細資料。

JSON 表示法 
{
  "pausedDateTime": string
}
欄位
pausedDateTime

string

廣告活動上次暫停時的時間戳記。時間戳記會以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。

SmartCampaignRemovedDetails

已移除智慧廣告活動的詳細資料。

JSON 表示法 
{
  "removedDateTime": string
}
欄位
removedDateTime

string

廣告活動移除時的時間戳記。時間戳記會以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。

SmartCampaignEndedDetails

已結束的智慧廣告活動相關詳細資料。

JSON 表示法 
{
  "endDateTime": string
}
欄位
endDateTime

string

廣告活動結束的時間戳記。時間戳記會以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。