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 Overview.

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

الكلمات الرئيسية وبذور عناوين URL

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

string

يجب إدخال كلمة رئيسية واحدة على الأقل ولا يمكن إدخال أكثر من 20 كلمة رئيسية.
url

string

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

KeywordSeed

بذرة الكلمات الرئيسية

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

string

يجب إدخال كلمة رئيسية واحدة على الأقل ولا يمكن إدخال أكثر من 20 كلمة رئيسية.

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

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. يتم عرض هذا المقياس للكلمات الرئيسية العامة التي لا تتضمّن ارتباطًا بعلامة تجارية.