Method: advertisers.audit

広告主を監査します。広告主が提供したリソースタイプごとに使用されているエンティティの数を返します。使用されたエンティティは、それぞれのリソース上限にカウントされます。https://support.google.com/displayvideo/answer/6071450 をご覧ください。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。監査する広告主の ID。

クエリ パラメータ

パラメータ
readMask

string (FieldMask format)

省略可。返すフィールド。マスクが指定されていない場合、レスポンス proto のすべてのフィールドが入力されます。指定できる値は次のとおりです。

  • 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)

この広告主の [有効]、[一時停止]、[下書き] の広告申込情報の数。これらの広告申込情報は、広告主ごとに 9,999 件の広告申込情報という上限にカウントされます。
usedInsertionOrdersCount

string (int64 format)

この広告主の [有効]、[一時停止]、[下書き] の広告掲載オーダーの数。これらの広告掲載オーダーは、広告主 1 社あたり 9,999 件の広告掲載オーダーの上限にカウントされます。
usedCampaignsCount

string (int64 format)

この広告主の有効なキャンペーンと一時停止中のキャンペーンの数。これらのキャンペーンは、広告主 1 人あたりのキャンペーン数の上限である 9,999 個にカウントされます。
channelsCount

string (int64 format)

この広告主の下に作成されたチャネルの数。これらのチャネルは、広告主 1 人あたり 1,000 個のチャネルの上限にカウントされます。
negativelyTargetedChannelsCount

string (int64 format)

この広告主で作成された除外対象チャンネルの数。除外設定されたチャンネルは、広告主 1 人あたり 5 つの除外設定されたチャンネルの上限にカウントされます。
negativeKeywordListsCount

string (int64 format)

この広告主で作成された除外キーワード リストの数。これらの除外キーワード リストは、広告主 1 人あたり 20 個の除外キーワード リストの上限にカウントされます。
adGroupCriteriaCount

string (int64 format)

この広告主の広告申込情報に割り当てられている、以下のターゲティング タイプの個々のターゲティング オプションの数。これらの個々のターゲティング オプションは、広告主様 1 人あたりの広告グループのターゲティング オプションの上限である 4,500,000 個にカウントされます。

対象となるターゲティング タイプ:

  • チャネル、URL、アプリ、コレクション
  • ユーザー属性
  • Google オーディエンス（アフィニティ、カスタム アフィニティ、購買意向の強いオーディエンスを含む）
  • 広告枠ソース
  • キーワード
  • Mobile app category
  • ユーザーリスト
  • 動画ターゲティング
  • 視認性
campaignCriteriaCount

string (int64 format)

この広告主の広告申込情報に割り当てられている、以下のターゲティング タイプの個々のターゲティング オプションの数。これらの個々のターゲティング オプションは、広告主様 1 人あたり 900,000 個のキャンペーン ターゲティング オプションの上限にカウントされます。

対象となるターゲティング タイプ:

  • 位置
  • ブラウザ
  • 接続速度
  • 曜日と時間
  • デバイスとオペレーティング システム
  • デジタル コンテンツのラベル
  • デリケートなカテゴリ
  • 環境
  • 地域（ビジネス チェーン、近隣地域を含む）
  • ISP
  • 言語
  • サードパーティによる認証

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。