生成广告组主题

使用 KeywordPlanIdeaService，您可以生成与现有关键字和广告组主题相同的关键字。

例如，如果主题是bakery，则该服务会生成可针对bakery near me、local bakery或cake shop等搜索触发广告的关键字。

关键字整理建议

使用 KeywordPlanIdeaService.GenerateAdGroupThemes 为现有广告组整理关键字提示（例如通过 GenerateKeywordIdeas 发现的关键字提示或您自己的候选关键字列表）。您无需手动将建议的关键字分组到广告组中，而是可以自动将关键字和匹配类型分配给最匹配的目标广告组。

构建 GenerateAdGroupThemesRequest 时，请提供以下必填字段：

• customer_id：您要为其 生成广告组主题的客户的 ID。
• keywords：最多包含 10,000 个要整理的种子关键字字符串的列表。
• ad_groups：最多 10,000 个现有广告组资源名称（格式为 customers/{customer_id}/adGroups/{ad_group_id}）的列表，这些广告组将被视为目标主题。

此 API 会返回一个 GenerateAdGroupThemesResponse，其中包含：

• ad_group_keyword_suggestions：AdGroupKeywordSuggestion 对象的列表。每条建议都会将 keyword_text（以及经过标准化的 suggested_keyword_text）和 suggested_match_type（BROAD、PHRASE 或 EXACT）与 suggested_ad_group 和 suggested_campaign 配对。
• unusable_ad_groups：UnusableAdGroup 对象的列表，用于标识服务无法用作主题定位条件的任何输入广告组（例如，如果广告组不是 ENABLED 或属于既不是 ENABLED 也不是 PAUSED 的广告系列）。

由于 GenerateAdGroupThemes 不会直接更改您的账号，因此您可以：

1. 将返回的建议分组到 CampaignToForecast 内的 ForecastAdGroup 对象中，以便使用 GenerateKeywordForecastMetrics 估算未来的流量。
2. 使用 AdGroupCriterionService.MutateAdGroupCriteria 创建 AdGroupCriterion 资源，将最终确定的建议应用于目标投放广告组。