- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- جرِّبه الآن
يبحث عن خيارات استهداف من نوع معيّن استنادًا إلى عبارات البحث المحدّدة.
طلب HTTP
POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search
يستخدِم عنوان URL بنية تحويل ترميز 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"، "مرسيدس بنز". |
regionQuery |
طلب البحث عن المنطقة الجغرافية المطلوبة، مثل "سياتل"، "الولايات المتحدة". |
GeoRegionSearchTerms
عبارات البحث لخيارات استهداف المنطقة الجغرافية
تمثيل JSON |
---|
{ "geoRegionQuery": string } |
الحقول | |
---|---|
geoRegionQuery |
طلب البحث عن المنطقة الجغرافية المطلوبة يمكن أن يكون الاستعلام بادئة، على سبيل المثال: "نيويورك" و"سياتل" و"الولايات المتحدة" وما إلى ذلك |