Method: customers.generateAdGroupThemes

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

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

درخواست HTTP

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

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

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

مولفه های
customerId

string

ضروری. شناسه مشتری.

درخواست بدن

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

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

string

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

adGroups[]

string

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

بدن پاسخگو

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

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

نمایندگی JSON
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
زمینه های
adGroupKeywordSuggestions[]

object ( AdGroupKeywordSuggestion )

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

unusableAdGroups[]

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
}
زمینه های
keywordText

string

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

suggestedKeywordText

string

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

suggestedMatchType

enum ( KeywordMatchType )

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

suggestedAdGroup

string

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

suggestedCampaign

string

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

UnusableAdGroup

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

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

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

string

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

campaign

string

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