- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- 試してみる
指定した検索キーワードに基づいて、指定したタイプのターゲティング オプションを検索します。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v2/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」など)。 |