Method: customers.generateKeywordIdeas

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

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

طلب HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordIdeas

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

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

المَعلمات
customerId

string

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

نص الطلب

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

تمثيل JSON 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
الحقول
geoTargetConstants[]

string

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

boolean

إذا كانت الإجابة "صحيحة"، سيتم تضمين كلمات رئيسية مخصّصة للبالغين في هذه الحالة. القيمة التلقائية هي false.
pageToken

string

الرمز المميّز للصفحة لاسترداده. في حال عدم تحديد أي خيار، سيتم عرض الصفحة الأولى من النتائج. لطلب الصفحة التالية من النتائج، استخدِم القيمة التي تم الحصول عليها من nextPageToken في الردّ السابق. يجب أن تتطابق حقول الطلب بين الصفحات.
pageSize

integer

عدد النتائج المطلوب استردادها في صفحة واحدة. قد يتم عرض 10,000 نتيجة كحدّ أقصى، وإذا تجاوز حجم الصفحة (pageSize) هذا الحدّ، يتم تجاهله. وفي حال عدم تحديد قيمة، سيتم عرض 10,000 نتيجة كحدّ أقصى. قد يقرر الخادم وضع حد أكبر لعدد الموارد التي يتم عرضها. إذا كانت الإجابة تحتوي على أقل من 10,000 نتيجة، قد لا يتم اعتبارها الصفحة الأخيرة من النتائج.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

التعليقات التوضيحية للكلمات الرئيسية المراد تضمينها في الردّ.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

الحقول المجمّعة التي سيتم تضمينها في الرد.
historicalMetricsOptions

object (HistoricalMetricsOptions)

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

string

اسم مورد اللغة المستهدفة. تنتمي كل كلمة رئيسية إلى مجموعة من اللغات؛ يتم تضمين الكلمة الرئيسية إذا كانت اللغة إحدى لغاتها. وفي حال تركها بدون ضبط، سيتم تضمين جميع الكلمات الرئيسية.
حقل الاتحاد seed نوع المحتوى الأساسي لإنشاء أفكار للكلمات الرئيسية. يمكن أن يكون الحقل "seed" واحدًا فقط مما يلي:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

كلمة رئيسية وعنوان URL محدد لإنشاء أفكار منها، على سبيل المثال، سيارات، www.example.com/cars.
keywordSeed

object (KeywordSeed)

كلمة رئيسية أو عبارة لتوليد الأفكار منها، مثل السيارات.
urlSeed

object (UrlSeed)

عنوان URL محدد لإنشاء أفكار منه، على سبيل المثال، www.example.com/cars.
siteSeed

object (SiteSeed)

الموقع الإلكتروني المطلوب إنشاء أفكار منه، على سبيل المثال، www.example.com.

نص الاستجابة

رسالة الرد لـ "KeywordPlanIdeaService.GenerateKeywordIdeas".

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

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

object (GenerateKeywordIdeaResult)

نتائج توليد أفكار الكلمات الرئيسية.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

المقاييس المجمّعة لجميع أفكار الكلمات الرئيسية.
nextPageToken

string

الرمز المميّز لتقسيم النتائج على عدّة صفحات يُستخدم لاسترداد الصفحة التالية من النتائج. مرِّر محتوى هذه السلسلة كسمة pageToken للطلب التالي. لا يتم عرض nextPageToken للصفحة الأخيرة.
totalSize

string (int64 format)

إجمالي عدد النتائج المتاحة

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

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

KeywordPlanKeywordAnnotation

تعداد التعليقات التوضيحية لخطة الكلمات الرئيسية التي يمكن طلبها.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
KEYWORD_CONCEPT عرض بيانات مفهوم الكلمة الرئيسية ومجموعة المفاهيم.

KeywordAndUrlSeed

الكلمة الرئيسية وعنوان URL الأساسي

تمثيل JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
الحقول
keywords[]

string

يتطلب كلمة رئيسية واحدة على الأقل.
url

string

عنوان URL المطلوب الزحف إليه لإنشاء أفكار للكلمات الرئيسية.

KeywordSeed

المحتوى الأساسي للكلمة الرئيسية

تمثيل JSON 
{
  "keywords": [
    string
  ]
}
الحقول
keywords[]

string

يتطلب كلمة رئيسية واحدة على الأقل.

UrlSeed

المحتوى الأساسي لعنوان Url

تمثيل JSON 
{
  "url": string
}
الحقول
url

string

عنوان URL المطلوب الزحف إليه لإنشاء أفكار للكلمات الرئيسية.

SiteSeed

المحتوى الأساسي للموقع

تمثيل JSON 
{
  "site": string
}
الحقول
site

string

اسم النطاق الخاص بالموقع الإلكتروني إذا كان العميل الذي يطلب الأفكار لا يملك الموقع الإلكتروني، يتم عرض المعلومات العلنية فقط.

GenerateKeywordIdeaResult

نتيجة توليد أفكار الكلمات الرئيسية.

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

object (KeywordPlanHistoricalMetrics)

المقاييس السابقة للكلمة الرئيسية.
keywordAnnotations

object (KeywordAnnotations)

التعليقات التوضيحية للكلمة الرئيسية. لا يتم توفير بيانات التعليقات التوضيحية إلا إذا تم طلبها.
closeVariants[]

string

قائمة بالصيغ القريبة من الكلمات الرئيسية المطلوبة التي تم دمجها في CREATEKeywordIdeaResult هذه. يمكنك الاطّلاع على https://support.google.com/google-ads/answer/9342105 للحصول على تعريف "الصيغ القريبة".
text

string

نص فكرة الكلمة الرئيسية. وكما هو الحال في المقاييس السابقة لخطة الكلمات الرئيسية، قد لا يكون هذا النص كلمة رئيسية فعلية، بل قد يكون الشكل الأساسي لعدة كلمات رئيسية. اطّلِع على رسالة KeywordPlanKeywordHistoryMetrics في KeywordPlanService.

KeywordAnnotations

التعليقات التوضيحية للكلمات الرئيسية لخطة الكلمات الرئيسية

تمثيل JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
الحقول
concepts[]

object (KeywordConcept)

تمثّل هذه السمة قائمة مفاهيم الكلمة الرئيسية.

KeywordConcept

مفهوم الكلمة الرئيسية.

تمثيل JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
الحقول
name

string

اسم مفهوم الكلمة الرئيسية في ConceptGroup.
conceptGroup

object (ConceptGroup)

مجموعة المفاهيم لتفاصيل المفهوم.

ConceptGroup

مجموعة المفاهيم لمفهوم الكلمات الرئيسية.

تمثيل JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
الحقول
name

string

اسم مجموعة المفاهيم.
type

enum (KeywordPlanConceptGroupType)

نوع مجموعة المفاهيم.

KeywordPlanConceptGroupType

تعداد أنواع مجموعات مفاهيم خطط الكلمات الرئيسية

عمليات التعداد
UNSPECIFIED يختلف تصنيف مجموعة المفاهيم عن العلامة التجارية/غيرها. هذه مجموعة تضم جميع التصنيفات التي لا تنطبق على أي مما يلي.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
BRAND يستنِد تصنيف مجموعة المفاهيم إلى BRAND.
OTHER_BRANDS تصنيف مجموعة المفاهيم بناءً على BRAND، والذي لم يتناسب بشكل جيد مع تصنيفات BRAND. وهذه قيَم استثنائية بوجهٍ عام وقد تتضمّن عددًا قليلاً جدًا من الكلمات الرئيسية في هذا النوع من التصنيف.
NON_BRAND لا يستند تصنيف مجموعة المفاهيم هذا إلى BRAND. يتمّ عرض هذه القيمة للكلمات الرئيسية العامة التي لا ترتبط بعلامة تجارية.