Method: advertisers.audit

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
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)

この広告主様の [有効]、[一時停止中]、[下書き] の広告申込情報の数。これらの広告申込情報は、広告主あたりの広告申込情報数の上限（9,999 件）にカウントされます。
usedInsertionOrdersCount

string (int64 format)

この広告主の ACTIVE、PAUSED、DRAFT の広告掲載オーダーの数。これらの広告掲載オーダーは、広告主 1 件につき上限の 9,999 件の広告掲載オーダーにカウントされます。
usedCampaignsCount

string (int64 format)

この広告主の ACTIVE キャンペーンと PAUSED キャンペーンの数です。これらのキャンペーンは、広告主様あたりのキャンペーン数の上限（9,999 個）にカウントされます。
channelsCount

string (int64 format)

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

string (int64 format)

この広告主で作成されたターゲット除外チャネルの数。除外ターゲットのチャネルは、広告主様 1 社あたり最大 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 の概要をご覧ください。