Method: advertisers.audit

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

HTTP リクエスト

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

この広告主で作成された、ターゲット除外の対象となったチャネルの数。ターゲット除外の対象となるチャネルは、広告主 1 社につき 5 つまでです。

negativeKeywordListsCount

string (int64 format)

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

adGroupCriteriaCount

string (int64 format)

この広告主の広告申込情報に割り当てられている次のターゲティング タイプの個別のターゲティング オプションの数。これらの個々のターゲティング オプションは、1 つの広告主につき 4500,000 個の広告グループのターゲティング オプションの上限にカウントされます。

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

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

string (int64 format)

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

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

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

認可スコープ

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

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

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