Method: targetingTypes.targetingOptions.search

指定された検索キーワードに基づいて、指定されたタイプのターゲティング オプションを検索します。

HTTP リクエスト

POST https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions:search

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

パスパラメータ

パラメータ
targetingType

enum (TargetingType)

必須。取得するターゲティング オプションのタイプ。

次の値が利用できます。

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "advertiserId": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field search_terms can be only one of the following:
  "poiSearchTerms": {
    object (PoiSearchTerms)
  },
  "businessChainSearchTerms": {
    object (BusinessChainSearchTerms)
  },
  "geoRegionSearchTerms": {
    object (GeoRegionSearchTerms)
  }
  // End of list of possible types for union field search_terms.
}
フィールド
advertiserId

string (int64 format)

必須。このリクエストがコンテキスト内で作成されている広告主。
pageSize

integer

リクエストされたページサイズ。1～200 の範囲で指定してください。指定しない場合、デフォルトで 100 になります。無効な値が指定された場合は、エラーコード INVALID_ARGUMENT を返します。
pageToken

string

サーバーが返す必要がある結果のページを特定するトークン。通常、これは targetingOptions.search メソッドの前の呼び出しから返された nextPageToken の値です。指定しない場合は、結果の最初のページが返されます。
共用体フィールド search_terms。ターゲティング オプションを検索するためのクエリ。search_terms のフィールドは 1 つのみ入力でき、targeting_type に対応している必要があります。search_terms は次のいずれかになります。
poiSearchTerms

object (PoiSearchTerms)

スポット ターゲティング オプションの検索語句。targetingType が TARGETING_TYPE_POI の場合にのみ使用できます。
businessChainSearchTerms

object (BusinessChainSearchTerms)

ビジネス チェーンのターゲティング オプションの検索語句。targetingType が TARGETING_TYPE_BUSINESS_CHAIN の場合にのみ使用できます。
geoRegionSearchTerms

object (GeoRegionSearchTerms)

地域ターゲティング オプションの検索語句。targetingType が TARGETING_TYPE_GEO_REGION の場合にのみ使用できます。

レスポンスの本文

targetingOptions.search に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
フィールド
targetingOptions[]

object (TargetingOption)

検索条件に一致するターゲティング オプションのリスト。

空の場合、このリストは存在しません。
nextPageToken

string

結果の次のページを取得するためのトークン。 この値を次の targetingOptions.search メソッド呼び出しの pageToken フィールドで渡して、結果の次ページを取得します。

認可スコープ

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

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

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

PoiSearchTerms

スポット ターゲティング オプションの検索語句。

JSON 表現 
{
  "poiQuery": string
}
フィールド
poiQuery

string

目的のスポットの名前、住所、座標の検索クエリ。クエリは接頭辞にできます（例: 「タイムズ スクエア」、「40.7505045,-73.99562」、「315 W 44th St」など）。

BusinessChainSearchTerms

ビジネス チェーンのターゲティング オプションの検索語句。

少なくとも 1 つのフィールドに入力する必要があります。

JSON 表現 
{
  "businessChainQuery": string,
  "regionQuery": string
}
フィールド
businessChainQuery

string

目的のビジネス チェーンの検索クエリ。クエリはビジネスの正式名称（「KFC」、「mercedes-benz」など）である必要があります。
regionQuery

string

目的の地域に関する検索語句（例: 「シアトル」、「米国」）。

GeoRegionSearchTerms

地域ターゲティング オプションの検索語句。

JSON 表現 
{
  "geoRegionQuery": string
}
フィールド
geoRegionQuery

string

目的の地域に関する検索クエリ。クエリは接頭辞にできます（「New Yor」、「Seattle」、「USA」など）。