Method: advertisers.audit

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

HTTP リクエスト

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

この広告主の ACTIVE、PAUSED、DRAFT の広告申込情報の数。これらの広告申込情報は、広告主あたりの広告申込情報数の上限(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)

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

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

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

string (int64 format)

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

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

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

認可スコープ

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

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

詳しくは、OAuth 2.0 の概要をご覧ください。