根據特定搜尋字詞,搜尋特定類型的指定選項。
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 quar」、「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」等。 |