- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- PoiSearch Terms
- BusinessChainSearch Terms
- GeoRegionSearch Terms
- آن را امتحان کنید!
بر اساس عبارات جستجوی داده شده، گزینه های هدف گیری از یک نوع معین را جستجو می کند.
درخواست 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 ممکن است پر شود و باید با targeting_type مطابقت داشته باشد. search_terms فقط می تواند یکی از موارد زیر باشد: | |
poiSearchTerms | عبارت های جستجو برای گزینه های هدف گذاری POI. فقط زمانی قابل استفاده است که |
businessChainSearchTerms | عبارات جستجو برای گزینه های هدف گذاری زنجیره کسب و کار. فقط زمانی قابل استفاده است که |
geoRegionSearchTerms | عبارات جستجو برای گزینه های هدف گذاری منطقه جغرافیایی. فقط زمانی قابل استفاده است که |
بدن پاسخگو
پیام پاسخ برای targetingOptions.search
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"targetingOptions": [
{
object ( |
فیلدها | |
---|---|
targetingOptions[] | لیستی از گزینه های هدف که با معیارهای جستجو مطابقت دارند. در صورت خالی بودن این لیست وجود نخواهد داشت. |
nextPageToken | نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
PoiSearch Terms
عبارت های جستجو برای گزینه های هدف گذاری POI.
نمایندگی JSON |
---|
{ "poiQuery": string } |
فیلدها | |
---|---|
poiQuery | عبارت جستجو برای نام POI مورد نظر، آدرس خیابان، یا مختصات POI مورد نظر. پرس و جو می تواند یک پیشوند باشد، به عنوان مثال "Times Squar"، "40.7505045،-73.99562"، "315 W 44th St"، و غیره. |
BusinessChainSearch Terms
عبارات جستجو برای گزینه های هدف گذاری زنجیره کسب و کار.
حداقل یکی از فیلدها باید پر شود.
نمایندگی JSON |
---|
{ "businessChainQuery": string, "regionQuery": string } |
فیلدها | |
---|---|
businessChainQuery | جستجوی زنجیره کسب و کار مورد نظر. درخواست باید نام کامل کسب و کار باشد، به عنوان مثال "KFC"، "mercedes-benz". |
regionQuery | عبارت جستجو برای منطقه جغرافیایی مورد نظر، به عنوان مثال "Seattle"، "United State". |
GeoRegionSearch Terms
عبارات جستجو برای گزینه های هدف گذاری منطقه جغرافیایی.
نمایندگی JSON |
---|
{ "geoRegionQuery": string } |
فیلدها | |
---|---|
geoRegionQuery | عبارت جستجو برای منطقه جغرافیایی مورد نظر. پرس و جو می تواند یک پیشوند باشد، به عنوان مثال "New Yor"، "Seattle"، "USA"، و غیره. |