Method: customers.generateKeywordIdeas

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

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

طلب HTTP

POST https://googleads.googleapis.com/v18/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 نتيجة كحدّ أقصى، وإذا تجاوز حجم الصفحة هذا الحد، يتم تجاهله. إذا لم يتم تحديدها، سيتم عرض 10,000 نتيجة كحد أقصى. قد يقرر الخادم فرض قيود إضافية على عدد الموارد التي يتم عرضها. إذا كان الردّ يحتوي على أقل من 10,000 نتيجة، قد لا يتم اعتباره الصفحة الأخيرة من النتائج.
keywordPlanNetwork

enum (KeywordPlanNetwork)

استهداف الشبكة: وفي حال عدم ضبط السياسة، سيتم استخدام "شبكة بحث 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

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

string

نص فكرة الكلمة الرئيسية وكما هو الحال في المقاييس السابقة لخطة الكلمات الرئيسية، قد لا يكون هذا النص كلمة رئيسية حقيقية، لكنه الشكل الأساسي لكلمات رئيسية متعددة. اطّلِع على رسالة KeywordPlanKeywordHistoricalMetrics في 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. يتمّ عرض هذه السمة للكلمات الرئيسية العامة التي ليس لها ارتباط بعلامة تجارية.