- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- جرِّبه الآن
يبحث عن خيارات استهداف من نوع معيّن استنادًا إلى عبارات البحث المحدّدة.
طلب HTTP
POST https://displayvideo.googleapis.com/v1/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 |
طلب البحث للمنطقة الجغرافية المطلوبة. يمكن أن يكون الاستعلام بادئة، على سبيل المثال: "New Yor" أو "Seattle" أو "USA" وما إلى ذلك. |