Method: customers.recommendations.generate

根据请求的 RecommendationType 生成建议。

抛出的错误列表：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。生成建议的客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
字段
recommendationTypes[]

enum (RecommendationType)

必需。要生成的合格 RecommendationType 的列表。如果上传的条件不足以生成建议，或者广告系列已处于建议状态，系统将不会针对该类型返回任何建议。通常，如果系统提供了该 RecommendationType 的所有必填字段，就会返回建议，但在某些情况下，这仍然不够。

以下建议类型可用于生成建议：KEYWORD、MAXIMIZE_CLICK_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、SITELINK_ASSET、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

必需。广告系列的广告渠道类型。支持以下 AdvertisingChannelType 生成建议：PERFORMANCE_MAX 和 SEARCH
adGroupInfo[]

object (AdGroupInfo)

可选。当前广告组信息。支持来自单个广告组的信息。对于以下 RecommendationType，此字段是选填字段：KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

可选。当前的转化跟踪状态。对于以下建议类型，此字段是必填字段：MAXIMIZE_clicks_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

可选。广告系列的当前出价信息。对于以下建议类型，此字段是必填字段：MAXIMIZE_clicks_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

可选。关键字的种子信息。对于以下 RecommendationType，此字段是必填字段：KEYWORD

响应正文

RecommendationService.GenerateRecommendations 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
字段
recommendations[]

object (Recommendation)

根据所传递的一系列请求的推荐类型生成的推荐列表。如果没有足够的数据来为请求的 RecommendationType 生成建议，则结果集将不会包含针对该类型的建议。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。

BiddingInfo

广告系列的当前出价信息。提供出价相关信号的封装容器，这些信号可为推荐内容提供参考。

JSON 表示法 
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
字段
biddingStrategyType

enum (BiddingStrategyType)

当前出价策略。对于以下建议类型，此字段是必填字段：MAXIMIZE_clicks_OPT_IN、MAXIMIZE_CONVERSIONS_OPT_IN、MAXIMIZE_CONVERSION_VALUE_OPT_IN、SET_TARGET_CPA、SET_TARGET_ROAS、TARGET_CPA_OPT_IN、TARGET_ROAS_OPT_IN
联合字段 bidding_strategy_target_info。与 bidding_strategy_type 相关的可选详细信息。bidding_strategy_target_info 只能是下列其中一项：
targetCpaMicros

string (int64 format)

当前 targetCpa（以微单位表示）对于出价策略类型为 TARGET_CPA 或 MAXIMIZE_CONVERSIONS 的广告系列，可以填充此值。
targetRoas

number

当前目标 ROAS。对于出价策略类型为“TARGET_ROAS”或“MAXIMIZE_CONVERSION_VALUE”的广告系列，可以填充此值。

AdGroupInfo

广告系列的当前广告组信息。

JSON 表示法 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
字段
keywords[]

object (KeywordInfo)

可选。当前使用的关键字。如果设置了 adGroupInfo，则对于以下 RecommendationType 而言，此字段是可选字段：KEYWORD
adGroupType

enum (AdGroupType)

可选。广告组的广告组类型。如果设置了 adGroupInfo，则以下 RecommendationType 是必填字段：KEYWORD

SeedInfo

关键字种子和用于生成关键字的特定网址。

JSON 表示法 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
字段
keywordSeeds[]

string

可选。用于生成提示的关键字或短语，例如：“汽车”或“附近的汽车经销商”。
urlSeed

string

用于生成提示的特定网址，例如：www.example.com/cars。