- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- جرِّبه الآن
عرض قائمة بأفكار الكلمات الرئيسية.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordIdeas
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
رقم تعريف العميل الذي يتضمّن الاقتراح. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "geoTargetConstants": [ string ], "includeAdultKeywords": boolean, "pageToken": string, "pageSize": integer, "keywordPlanNetwork": enum ( |
الحقول | |
---|---|
geoTargetConstants[] |
أسماء موارد الموقع الجغرافي المطلوب استهدافه الحد الأقصى هو 10. قد يتم استخدام قائمة فارغة لتحديد جميع المواقع الجغرافية المستهدفة. |
includeAdultKeywords |
إذا كانت الإجابة "صواب"، سيتم تضمين الكلمات الرئيسية للبالغين في هذه الحالة. القيمة التلقائية هي false. |
pageToken |
الرمز المميز للصفحة المطلوب استرداده. إذا لم يتم تحديد ذلك، سيتم عرض الصفحة الأولى من النتائج. لطلب الصفحة التالية من النتائج، استخدِم القيمة التي تم الحصول عليها من |
pageSize |
عدد النتائج المطلوب استردادها في صفحة واحدة. يمكن عرض 10,000 نتيجة كحدّ أقصى، وإذا تجاوز pageSize هذا المعدّل، سيتم تجاهله. وفي حال عدم تحديد هذا الحقل، سيتم عرض 10,000 نتيجة كحدّ أقصى. قد يقرر الخادم وضع حد أكبر لعدد الموارد التي يتم عرضها. إذا كان الرد يحتوي على أقل من 10000 نتيجة، فقد لا يتم افتراض أنها الصفحة الأخيرة من النتائج. |
keywordPlanNetwork |
شبكة الاستهداف. وفي حال تم تركها بدون ضبط، سيتم استخدام "بحث Google" وشبكة الشركاء. |
keywordAnnotation[] |
التعليقات التوضيحية للكلمات الرئيسية المراد تضمينها في الاستجابة. |
aggregateMetrics |
الحقول المجمّعة المطلوب تضمينها في الردّ. |
historicalMetricsOptions |
الخيارات لبيانات المقاييس السابقة. |
language |
اسم مورد اللغة المطلوب استهدافها. تنتمي كل كلمة رئيسية إلى مجموعة معينة من اللغات؛ ويتم تضمين كلمة رئيسية إذا كانت اللغة واحدة من لغاتها. وفي حال ترك هذه السياسة بدون ضبط، سيتم تضمين جميع الكلمات الرئيسية. |
حقل الاتحاد seed نوع المحتوى الأساسي لإنشاء أفكار للكلمات الرئيسية. يمكن أن تكون السمة "seed " واحدة فقط مما يلي: |
|
keywordAndUrlSeed |
كلمة رئيسية وعنوان URL محدد لتوليد أفكار، على سبيل المثال، سيارات، www.example.com/cars. |
keywordSeed |
كلمة رئيسية أو عبارة لتوليد أفكار، مثل السيارات. |
urlSeed |
عنوان URL محدد لإنشاء أفكار منه، على سبيل المثال، www.example.com/cars. |
siteSeed |
الموقع الإلكتروني الذي يتم إنشاء أفكار منه، مثل www.example.com. |
نص الاستجابة
رسالة الرد على KeywordPlanIdeaService.GenerateKeywordIdeas
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "results": [ { object ( |
الحقول | |
---|---|
results[] |
نتائج إنشاء أفكار الكلمات الرئيسية |
aggregateMetricResults |
المقاييس المجمّعة لجميع أفكار الكلمات الرئيسية. |
nextPageToken |
الرمز المميز للتقسيم إلى صفحات يُستخدم لاسترداد الصفحة التالية من النتائج. اضبط محتوى هذه السلسلة على أنّه السمة |
totalSize |
إجمالي عدد النتائج المتاحة |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
KeywordPlanKeywordAnnotation
تعداد التعليقات التوضيحية لخطة الكلمات الرئيسية التي يمكن طلبها
عمليات التعداد | |
---|---|
UNSPECIFIED |
غير محدَّد. |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
KEYWORD_CONCEPT |
عرض بيانات مفهوم الكلمة الرئيسية ومجموعة المفاهيم. |
KeywordAndUrlSeed
المحتوى الأساسي للكلمة الرئيسية وعنوان URL
تمثيل JSON |
---|
{ "keywords": [ string ], "url": string } |
الحقول | |
---|---|
keywords[] |
يتطلب كلمة رئيسية واحدة على الأقل. |
url |
عنوان URL المطلوب الزحف إليه لإنشاء أفكار للكلمات الرئيسية. |
KeywordSeed
المحتوى الأساسي للكلمة الرئيسية
تمثيل JSON |
---|
{ "keywords": [ string ] } |
الحقول | |
---|---|
keywords[] |
يتطلب كلمة رئيسية واحدة على الأقل. |
UrlSeed
المحتوى الأساسي لعنوان URL
تمثيل JSON |
---|
{ "url": string } |
الحقول | |
---|---|
url |
عنوان URL المطلوب الزحف إليه لإنشاء أفكار للكلمات الرئيسية. |
SiteSeed
المحتوى الأساسي للموقع الإلكتروني
تمثيل JSON |
---|
{ "site": string } |
الحقول | |
---|---|
site |
اسم نطاق الموقع الإلكتروني. إذا كان العميل الذي يطلب الأفكار لا يملك الموقع الإلكتروني، يتم عرض المعلومات العلنية فقط. |
GenerateKeywordIdeaResult
نتيجة إنشاء أفكار الكلمات الرئيسية
تمثيل JSON |
---|
{ "keywordIdeaMetrics": { object ( |
الحقول | |
---|---|
keywordIdeaMetrics |
المقاييس السابقة للكلمة الرئيسية. |
keywordAnnotations |
التعليقات التوضيحية للكلمة الرئيسية. ولا يتم توفير بيانات التعليقات التوضيحية إلا إذا طُلب منك ذلك. |
closeVariants[] |
قائمة بالصيغ القريبة من الكلمات الرئيسية المطلوبة التي تم دمجها في GenerateKeywordIdeaResult هذه. يُرجى الاطّلاع على https://support.google.com/google-ads/answer/9342105 للحصول على تعريف "الصيغ القريبة". |
text |
نص فكرة الكلمة الرئيسية. وكما هو الحال في المقاييس السابقة لخطة الكلمات الرئيسية، قد لا يكون هذا النص كلمة رئيسية فعلية، بل الشكل الأساسي لعدة كلمات رئيسية. يُرجى الاطّلاع على رسالة KeywordPlanKeywordHistoryMetrics في KeywordPlanService. |
KeywordAnnotations
التعليقات التوضيحية للكلمات الرئيسية لخطة الكلمات الرئيسية
تمثيل JSON |
---|
{
"concepts": [
{
object ( |
الحقول | |
---|---|
concepts[] |
قائمة مفاهيم الكلمة الرئيسية. |
KeywordConcept
مفهوم الكلمة الرئيسية.
تمثيل JSON |
---|
{
"name": string,
"conceptGroup": {
object ( |
الحقول | |
---|---|
name |
اسم مفهوم الكلمة الرئيسية في ConceptGroup. |
conceptGroup |
مجموعة المفاهيم لتفاصيل المفهوم. |
ConceptGroup
مجموعة المفاهيم لمفهوم الكلمة الرئيسية.
تمثيل JSON |
---|
{
"name": string,
"type": enum ( |
الحقول | |
---|---|
name |
اسم مجموعة المفاهيم. |
type |
نوع مجموعة المفاهيم. |
KeywordPlanConceptGroupType
تعداد أنواع مجموعات مفاهيم خطط الكلمات الرئيسية
عمليات التعداد | |
---|---|
UNSPECIFIED |
يختلف تصنيف مجموعة المفاهيم عن تصنيف العلامة التجارية/غيرها. هذه هي مجموعة كاملة لكل التصنيفات التي لا تطابق أيًا مما يلي. |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
BRAND |
يستند تصنيف مجموعة المفاهيم إلى BRAND. |
OTHER_BRANDS |
تصنيف مجموعة المفاهيم استنادًا إلى BRAND، والذي لم يتناسب جيدًا مع تصنيفات BRAND. وهذه القيم استثنائية عمومًا، وقد تتضمّن عددًا قليلاً جدًا من الكلمات الرئيسية في هذا النوع من التصنيف. |
NON_BRAND |
لا يستند تصنيف مجموعة المفاهيم هذه إلى BRAND. يُعرَض هذا العمود للكلمات الرئيسية العامة التي ليس لها ارتباط بعلامة تجارية. |