- طلب 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" أو "mercedes-benz". |
regionQuery |
طلب البحث للمنطقة الجغرافية المطلوبة، مثل "الإسكندرية" أو "المملكة العربية السعودية". |
GeoRegionSearchTerms
عبارات البحث لخيارات استهداف المنطقة الجغرافية
تمثيل JSON |
---|
{ "geoRegionQuery": string } |
الحقول | |
---|---|
geoRegionQuery |
طلب البحث للمنطقة الجغرافية المطلوبة. يمكن أن يكون الاستعلام بادئة، على سبيل المثال: "New Yor" أو "Seattle" أو "USA" وما إلى ذلك. |