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)

この広告主様のアクティブ、一時停止、ドラフトの広告掲載オーダーの数。これらの広告掲載オーダーは、広告主様ごとに 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 の概要をご覧ください。