Method: customers.generateKeywordHistoricalMetrics

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

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

طلب HTTP

POST https://googleads.googleapis.com/v16/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" و"شبكة شركاء 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

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

object (KeywordPlanHistoricalMetrics)

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

string

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