- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- 試してみる
指定した検索キーワードに基づいて、指定したタイプのターゲティング オプションを検索します。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions:search
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
targetingType |
必須。取得するターゲティング オプションのタイプ。 次の値が利用できます。
|
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
フィールド | |
---|---|
advertiserId |
必須。このリクエストの対象となる広告主です。 |
pageSize |
リクエストされたページサイズです。 |
pageToken |
サーバーが返す必要がある結果のページを特定するトークンです。 通常、これは前回の |
共用体フィールド search_terms 。ターゲティング オプションを検索するためのクエリです。search_terms で入力できるフィールドは 1 つのみで、targeting_type に対応している必要があります。search_terms は次のいずれかになります。 |
|
poiSearchTerms |
スポット ターゲティング オプションの検索語句。 |
businessChainSearchTerms |
ビジネス チェーンのターゲティング オプションの検索語句。 |
geoRegionSearchTerms |
地域ターゲティング オプションの検索語句。 |
レスポンスの本文
targetingOptions.search
に対するレスポンス メッセージです。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"targetingOptions": [
{
object ( |
フィールド | |
---|---|
targetingOptions[] |
検索条件に一致するターゲティング オプションのリスト。 空の場合、このリストは存在しません。 |
nextPageToken |
結果の次のページを取得するためのトークン。 結果の次のページを取得するには、後続の |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 の概要をご覧ください。
PoiSearchTerms
スポット ターゲティング オプションの検索語句。
JSON 表現 |
---|
{ "poiQuery": string } |
フィールド | |
---|---|
poiQuery |
目的のスポットの名前、番地、またはスポットの座標。クエリには「Times squar」、「40.7505045,-73.99562」、「315 W 44th St」などの接頭辞を付けることができます。 |
BusinessChainSearchTerms
ビジネス チェーンのターゲティング オプションの検索語句。
少なくとも 1 つのフィールドに値を設定する必要があります。
JSON 表現 |
---|
{ "businessChainQuery": string, "regionQuery": string } |
フィールド | |
---|---|
businessChainQuery |
目的のビジネス チェーンの検索クエリ。クエリには、お店やサービスの正式名称(例: 「KFC」、「mercedes-benz」)を入力する必要があります。 |
regionQuery |
目的の地域の検索クエリ(「シアトル」、「米国」など)。 |
GeoRegionSearchTerms
地域ターゲティング オプションの検索語句。
JSON 表現 |
---|
{ "geoRegionQuery": string } |
フィールド | |
---|---|
geoRegionQuery |
目的の地域の検索クエリ。クエリには、「New Yor」、「Seattle」、「USA」などの接頭辞を付けることができます。 |