Method: advertisers.audit

對廣告客戶進行稽核，傳回指定廣告主所使用的實體數量 (依資源類型而定)。已使用的實體會計入其個別資源數量上限。請參閱 https://support.google.com/displayvideo/answer/6071450。

HTTP 要求

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:audit

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

路徑參數

參數
advertiserId

string (int64 format)

必要欄位。要稽核的廣告主 ID。

查詢參數

參數
readMask

string (FieldMask format)

選用設定。要傳回的特定欄位。如果未指定遮罩，回應原型中的所有欄位都會填入。有效值如下：

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

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

要求主體

要求主體必須為空白。

回應主體

AdvertiserService.AuditAdvertiser 的回應訊息。

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

JSON 表示法 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
欄位
usedLineItemsCount

string (int64 format)

這個廣告客戶下方「有效」、「已暫停」和「草稿」委刊項的數量。這些委刊項會計入每個廣告主的委刊項上限 (9999 個)。
usedInsertionOrdersCount

string (int64 format)

這個廣告客戶下的有效、已暫停和草稿廣告訂單數量。這些廣告訂單會計入廣告主每人最多可擁有 9999 個廣告訂單的上限。
usedCampaignsCount

string (int64 format)

這個廣告主下的「有效」和「已暫停」廣告活動數量。這些廣告活動會計入廣告主每人 9999 個廣告活動的上限。
channelsCount

string (int64 format)

在這個廣告主下建立的頻道數量。這些管道會計入廣告主的上限 (1,000 個管道)。
negativelyTargetedChannelsCount

string (int64 format)

在這個廣告主下建立的排除指定頻道數量。這些排除指定頻道會計入每個廣告客戶 5 個排除指定頻道的數量上限。
negativeKeywordListsCount

string (int64 format)

在這個廣告主下建立的排除關鍵字清單數量。這些排除關鍵字清單會計入廣告主每人最多 20 份排除關鍵字清單的限制。
adGroupCriteriaCount

string (int64 format)

下列指定目標類型中，指派給這位廣告主委刊項的個別指定目標選項數量。這些個別指定目標選項會計入每位廣告主的廣告群組指定目標選項上限 (4500000 個)。

適用的指定類型：

  • 管道、網址、應用程式和組合
  • 客層
  • Google 目標對象，包括興趣相似目標對象、自訂興趣相似目標對象和潛在目標消費者
  • 廣告空間來源
  • 關鍵字
  • 行動應用程式類別
  • 使用者名單
  • 指定影片
  • 可視度
campaignCriteriaCount

string (int64 format)

下列指定目標類型中，指派給這位廣告主委刊項的個別指定目標選項數量。這些個別指定目標選項會計入廣告客戶的廣告活動指定選項上限 (900,000 個)。

符合資格的指定類型：

  • 位置
  • 瀏覽器
  • 連線速度
  • 日期和時間
  • 裝置和作業系統
  • 數位內容標籤
  • 敏感類別
  • 環境
  • 地理位置 (包含連鎖店和鄰近區域)
  • ISP
  • 語言
  • 第三方驗證

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/display-video

詳情請參閱 OAuth 2.0 總覽。