Method: customers.generateKeywordIdeas

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

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

طلب HTTP

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

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