Method: customers.generateKeywordHistoricalMetrics

تعرِض هذه الدالة قائمة بالمقاييس السابقة للكلمات الرئيسية.

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

طلب HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordHistoricalMetrics

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

مَعلمات المسار

المعلمات
customerId

string

رقم تعريف العميل الذي يتضمّن الاقتراح.

نص الطلب

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

تمثيل JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
الحقول
keywords[]

string

قائمة بالكلمات الرئيسية للحصول على المقاييس السابقة لن يتم عرض جميع الإدخالات نتيجةً لإزالة تكرار العناصر بشكل شبه تام. على سبيل المثال، إذا تم طلب إحصاءات عن "سيارة" و "سيارات"، سيتم عرض "سيارة" فقط. يمكن استخدام 10,000 كلمة رئيسية كحدّ أقصى.
includeAdultKeywords

boolean

إذا كان صحيحًا، سيتم تضمين الكلمات الرئيسية للبالغين في الردّ. القيمة التلقائية هي false.
geoTargetConstants[]

string

أسماء الموارد للموقع الجغرافي المطلوب استهدافه الحدّ الأقصى هو 10. يجوز استخدام قائمة فارغة لتحديد جميع المواقع الجغرافية المستهدَفة.
keywordPlanNetwork

enum (KeywordPlanNetwork)

شبكة الاستهداف في حال عدم ضبط هذه السمة، سيتم استخدام "شبكة بحث Google" و"شبكة الشركاء".
aggregateMetrics

object (KeywordPlanAggregateMetrics)

الحقول المجمّعة المطلوب تضمينها في الاستجابة
historicalMetricsOptions

object (HistoricalMetricsOptions)

خيارات بيانات المقاييس السابقة
language

string

اسم المورد للغة المستهدفة تنتمي كلّ كلمة رئيسية إلى مجموعة من اللغات، ويتمّ تضمين الكلمة الرئيسية إذا كانت اللغة هي إحدى لغاتها. في حال عدم ضبطها، سيتم تضمين جميع الكلمات الرئيسية.

نص الاستجابة

رسالة الردّ بشأن KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics

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

تمثيل JSON 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
الحقول
results[]

object (GenerateKeywordHistoricalMetricsResult)

قائمة بالكلمات الرئيسية ومقاييسها السابقة
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

المقاييس المجمّعة لجميع الكلمات الرئيسية

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

نتيجة إنشاء المقاييس السابقة للكلمات الرئيسية

تمثيل JSON 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
الحقول
closeVariants[]

string

قائمة الصيغ القريبة من الكلمات الرئيسية المطلوبة التي يتم دمج إحصاءاتها في GenerateKeywordHistoricalMetricsResult
keywordMetrics

object (KeywordPlanHistoricalMetrics)

المقاييس السابقة للنص وأشكاله المتشابهة
text

string

نص طلب البحث المرتبط بكلمة رئيسية واحدة أو أكثر. يُرجى العِلم أنّنا نزيل تكرار قائمة الكلمات الرئيسية، ونزيل الصيغ المتشابهة قبل عرض الكلمات الرئيسية كنص. على سبيل المثال، إذا كان طلبك يتضمّن في الأصل الكلمات الرئيسية "سيارة" و "سيارات"، لن يحتوي طلب البحث الذي يتم عرضه إلا على "سيارات". سيتم تضمين قائمة طلبات البحث التي تمّت إزالة تكرارها في حقل closeVariants.