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)

この広告主の ACTIVE、PAUSED、DRAFT の広告申込情報の数。これらの広告申込情報は、広告主あたりの広告申込情報数の上限 9,999 件にカウントされます。
usedInsertionOrdersCount

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

この広告主の広告申込情報に割り当てられている次のターゲティング タイプの個別のターゲティング オプションの数。これらの個々のターゲティング オプションは、広告主ごとの広告グループのターゲティング オプション 450 万の制限にカウントされます。

対象となるターゲットの種類:

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

string (int64 format)

この広告主の広告申込情報に割り当てられている次のターゲティング タイプの個別のターゲティング オプションの数。これらの個々のターゲティング オプションは、広告主ごとのキャンペーン ターゲティング オプションの上限 90 万にカウントされます。

対象となるターゲットの種類:

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

承認スコープ

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

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

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