Method: geoTargetConstants.suggest

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

قائمة الأخطاء التي تم طرحها: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v17/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

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

string (int64 format)

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

string

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