根據指定搜尋字詞搜尋指定類型的指定目標選項。
HTTP 要求
POST https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions:search
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
targetingType |
必要欄位。要擷取的指定目標選項類型。 可接受的值如下:
|
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
欄位 | |
---|---|
advertiserId |
必要欄位。提出要求的廣告主。 |
pageSize |
要求的頁面大小。必須介於 |
pageToken |
用於識別伺服器應傳回之結果頁面的符記。一般而言,這是從先前呼叫 |
聯集欄位 search_terms 。用來搜尋指定目標選項的查詢。您只能填寫 search_terms 中的一個欄位,且該欄位必須對應 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
「連鎖店」指定目標選項的搜尋字詞。
請填寫至少一個欄位。
JSON 表示法 |
---|
{ "businessChainQuery": string, "regionQuery": string } |
欄位 | |
---|---|
businessChainQuery |
所需連鎖店的搜尋查詢。查詢必須是商家全名,例如「KFC」、「mercedes-benz」 |
regionQuery |
所需地理區域的搜尋查詢,例如「西雅圖」、「聯合國」。 |
GeoRegionSearchTerms
指定地理區域選項的搜尋字詞。
JSON 表示法 |
---|
{ "geoRegionQuery": string } |
欄位 | |
---|---|
geoRegionQuery |
指定地理區域的搜尋查詢。查詢可以是前置字串,例如「New Yor」、「Seattle」、「USA」等。 |