Method: customers.generateAdGroupThemes

فهرستی از AdGroup های پیشنهادی و تغییرات پیشنهادی (متن، نوع مطابقت) را برای کلمات کلیدی داده شده برمی گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError CollectionSizeError HeaderError داخلی خطا QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customer Id

string

مورد نیاز. شناسه مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "keywords": [
    string
  ],
  "adGroups": [
    string
  ]
}
فیلدها
keywords[]

string

مورد نیاز. لیستی از کلمات کلیدی برای گروه بندی در AdGroup های ارائه شده.

ad Groups[]

string

مورد نیاز. فهرستی از نام منابع AdGroups برای گروه بندی کلمات کلیدی در آنها. قالب نام منبع: customers/{customerId}/adGroups/{adGroupId}

بدن پاسخگو

پیام پاسخ برای KeywordPlanIdeaService.GenerateAdGroupThemes .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
فیلدها
ad Group Keyword Suggestions[]

object ( AdGroupKeywordSuggestion )

لیستی از جفت‌های پیشنهادی AdGroup/کلمه کلیدی.

unusable Ad Groups[]

object ( UnusableAdGroup )

فهرستی از AdGroup های ارائه شده که نمی توانند به عنوان پیشنهاد استفاده شوند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

AdGroupKeywordSuggestion

متن پیشنهادی و جفت شدن AdGroup/Campaign برای یک کلمه کلیدی معین.

نمایندگی JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
فیلدها
keyword Text

string

متن اصلی کلمه کلیدی

suggested Keyword Text

string

نسخه عادی کلمه کلیدی برای پیشنهادات BROAD/EXACT/PHRASE.

suggested Match Type

enum ( KeywordMatchType )

نوع تطبیق کلمه کلیدی پیشنهادی.

suggested Ad Group

string

AdGroup پیشنهادی برای کلمه کلیدی. قالب نام منبع: customers/{customerId}/adGroups/{adGroupId}

suggested Campaign

string

کمپین پیشنهادی برای کلمه کلیدی قالب نام منبع: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

یک جفت AdGroup/Campaign که نمی تواند به عنوان پیشنهاد برای کلمات کلیدی استفاده شود.

اگر AdGroup باشد، ممکن است AdGroup ها قابل استفاده نباشند

  • متعلق به کمپینی است که فعال یا متوقف نشده است
  • خود فعال نیست
نمایندگی JSON 
{
  "adGroup": string,
  "campaign": string
}
فیلدها
ad Group

string

نام منبع AdGroup. قالب نام منبع: customers/{customerId}/adGroups/{adGroupId}

campaign

string

نام منبع کمپین قالب نام منبع: customers/{customerId}/campaigns/{campaignId}