Method: customers.generateAdGroupThemes

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

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

طلب HTTP

POST https://googleads.googleapis.com/v15/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

النسخة التي تمت تسويتها من نص الكلمات الرئيسية لتقديم اقتراحات تقريبية/دقيقة/نصية.
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}