Method: geoTargetConstants.suggest

تعرض اقتراحات GeoTargetConstant حسب اسم الموقع أو حسب اسم المورد.

قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v16/geoTargetConstants:suggest

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
الحقول
locale

string

إذا أمكن، تتم ترجمة الأهداف الجغرافية المعروضة باستخدام هذه اللغة. وإذا لم يكُن مطابقًا، يتم استخدام en بشكل تلقائي. ويُستخدم هذا أيضًا كتلميح للأهداف الجغرافية التي تم عرضها.
countryCode

string

وتقتصر الاستهدافات الجغرافية المعروضة على رمز البلد هذا.
حقل الاتحاد query مطلوبة. محدّد لثوابت الهدف الجغرافي. يمكن أن يكون الحقل "query" واحدًا فقط مما يلي:
locationNames

object (LocationNames)

أسماء المواقع الجغرافية المطلوب البحث وفقًا لها. يمكن ضبط 25 اسمًا كحدّ أقصى.
geoTargets

object (GeoTargets)

أسماء الموارد الثابتة للاستهداف الجغرافي التي ستتم الفلترة حسبها.

نص الاستجابة

رسالة الرد لـ "GeoTargetConstantService.SuggestGeoTargetConstants".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
الحقول
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

الاقتراحات الثابتة للاستهداف الجغرافي

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

LocationNames

قائمة بأسماء المواقع الجغرافية.

تمثيل JSON 
{
  "names": [
    string
  ]
}
الحقول
names[]

string

قائمة بأسماء المواقع الجغرافية.

GeoTargets

قائمة بأسماء الموارد الثابتة للاستهداف الجغرافي

تمثيل JSON 
{
  "geoTargetConstants": [
    string
  ]
}
الحقول
geoTargetConstants[]

string

قائمة بأسماء الموارد الثابتة للاستهداف الجغرافي

GeoTargetConstantSuggestion

اقتراح ثابت للاستهداف الجغرافي

تمثيل JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
الحقول
geoTargetConstant

object (GeoTargetConstant)

نتيجة GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

قائمة أصل ثابت الهدف الجغرافي.
locale

string

اللغة التي تتم ترجمة GeoTargetConstantاقتراحion هذا إليها حاليًا. يؤثر على اسم حقول الاستهداف الجغرافي. على سبيل المثال، إذا locale=en، ثم name=إسبانيا. إذا كانت locale=es، عندها name=España. سيتم عرض اللغة التلقائية في حال عدم توفُّر أي ترجمة للّغة في الطلب.
reach

string (int64 format)

العدد التقريبي للمستخدمين الذين سيتم استهدافهم، ويتم تقريبه إلى أقرب 100.
searchTerm

string

إذا تم البحث في الطلب حسب اسم الموقع الجغرافي، يكون هذا هو اسم الموقع الجغرافي الذي طابق الاستهداف الجغرافي.