Method: customers.generateAdGroupThemes

تعرِض هذه الدالة قائمة بالمجموعات الإعلانية المقترَحة والتعديلات المقترَحة (النص ونوع المطابقة) للكلمات الرئيسية المحدّدة.

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

طلب HTTP

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

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

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

المعلمات
customerId

string

مطلوب. رقم تعريف العميل.

نص الطلب

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

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

string

مطلوب. قائمة بالكلمات الرئيسية المطلوب تجميعها في المجموعات الإعلانية المقدَّمة
adGroups[]

string

مطلوب. قائمة بأسماء الموارد للمجموعات الإعلانية لتجميع الكلمات الرئيسية فيها. تنسيق اسم المورد: customers/{customerId}/adGroups/{adGroupId}

نص الاستجابة

رسالة ردّ على KeywordPlanIdeaService.GenerateAdGroupThemes.

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

تمثيل JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
الحقول
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

قائمة بأزواج المجموعات الإعلانية/الكلمات الرئيسية المقترحة.
unusableAdGroups[]

object (UnusableAdGroup)

قائمة بالمجموعات الإعلانية المقدَّمة التي تعذّر استخدامها كاقتراحات

نطاقات الأذونات

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

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

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

AdGroupKeywordSuggestion

النص المقترَح وإقران المجموعة الإعلانية/الحملة لكلمة رئيسية معيّنة.

تمثيل JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
الحقول
keywordText

string

نص الكلمة الرئيسية الأصلي
suggestedKeywordText

string

النسخة التي تمت تسويتها من wordText للاقتراحات التقريبية/EXACT/PHRASE.
suggestedMatchType

enum (KeywordMatchType)

نوع مطابقة الكلمة الرئيسية المقترح.
suggestedAdGroup

string

المجموعة الإعلانية المقترَحة للكلمة الرئيسية. تنسيق اسم المورد: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

الحملة المقترَحة للكلمة الرئيسية. تنسيق اسم المورد: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

زوج من المجموعة الإعلانية/الحملة لا يمكن استخدامه كاقتراح للكلمات الرئيسية.

قد لا تكون المجموعات الإعلانية قابلة للاستخدام إذا كانت المجموعة الإعلانية

  • ينتمي إلى حملة غير مُفعّلة أو متوقفة مؤقتًا
  • غير مفعَّل
تمثيل JSON 
{
  "adGroup": string,
  "campaign": string
}
الحقول
adGroup

string

اسم مورد المجموعة الإعلانية. تنسيق اسم المورد: customers/{customerId}/adGroups/{adGroupId}
campaign

string

اسم مورد الحملة. تنسيق اسم المورد: customers/{customerId}/campaigns/{campaignId}