Method: advertisers.audit

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

HTTP リクエスト

GET https://displayvideo.googleapis.com/v5/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)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

この広告主の下に作成された、ターゲット除外チャネルの数。これらのターゲット除外チャンネルは、広告主ごとに 5 つのターゲット除外チャンネルの上限にカウントされます。
negativeKeywordListsCount

string (int64 format)

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

string (int64 format)

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

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

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

string (int64 format)

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

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

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

認可スコープ

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

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

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