Method: customers.generateKeywordHistoricalMetrics

عرض قائمة بالمقاييس السابقة للكلمات الرئيسية.

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

طلب HTTP

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

GenerateKeywordHistoricalMetricsResult

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

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

string

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

object (KeywordPlanHistoricalMetrics)

المقاييس السابقة للنص وصيغه القريبة
text

string

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