- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 承認スコープ
- PoiSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- BusinessChainSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- GeoRegionSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- 試してみる
指定した検索キーワードに基づいて特定のタイプのターゲティング オプションを検索します。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v1/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」、「メルセデス ベンツ」。 |
regionQuery |
目的の地域の検索クエリ(例:「シアトル」、「米国」。 |
GeoRegionSearchTerms
地域ターゲティング オプションの検索キーワード。
JSON 表現 |
---|
{ "geoRegionQuery": string } |
フィールド | |
---|---|
geoRegionQuery |
目的の地域の検索クエリ。クエリには接頭辞を指定できます(例:「New Yor」、「Seattle」、「USA」など |