Method: targetingTypes.targetingOptions.search

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

HTTP リクエスト

POST https://displayvideo.googleapis.com/v4/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

目的のスポットの名前、住所、座標の検索クエリ。クエリは接頭辞にすることができます（例: 「Times squar」、「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」）。