Method: geoTargetConstants.suggest

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

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

طلب HTTP

POST https://googleads.googleapis.com/v15/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=إسبانيا. إذا locale=es، فإن name=España. سيتم عرض اللغة التلقائية في حال عدم توفّر ترجمة للّغة في الطلب.
reach

string (int64 format)

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

string

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