Method: customers.recommendations.generate

根据请求的建议类型生成建议。

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

HTTP 请求

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

必需。要生成的符合条件的建议类型列表。如果上传的条件不足以提供建议，或者广告系列已处于建议状态，则不会针对该类型返回任何建议。通常，如果相应建议类型的所有必填字段均已上传，系统会返回建议，但也存在这样的情况。

生成建议时支持以下 RecommendationsType：KEYWORD、MAXIMIZE_CLICKS_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)

可选。当前广告组信息。支持来自单个广告组的信息。对于以下建议类型，此字段为可选字段：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)

可选。关键字的种子信息。对于以下建议类型，必须使用此字段：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)

当前目标每次转化费用（以微单位表示）。对于出价策略类型为“TARGET_CPA”或“MAXIMIZE_CONVERSIONS”的广告系列，此值可以填充。
targetRoas

number

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

AdGroupInfo

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

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

object (KeywordInfo)

可选。当前关键字。如果设置了 adGroupInfo，则对于以下建议类型，此字段为选填字段：KEYWORD
adGroupType

enum (AdGroupType)

可选。广告组的广告组类型。如果设置了 adGroupInfo，则以下建议类型必须使用此字段：KEYWORD

SeedInfo

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

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

string

可选。可据以生成参考提示的关键字或词组，例如：“汽车”或“附近的汽车经销商”。
urlSeed

string

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