Method: customers.recommendations.apply

采纳提供的建议以及相应的采纳参数。

抛出的错误列表：AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

HTTP 请求

POST https://googleads.googleapis.com/v14/customers/{customerId}/recommendations:apply

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。采纳建议的客户的 ID。

请求正文

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

JSON 表示法 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
字段
operations[]

object (ApplyRecommendationOperation)

必需。要采纳建议的操作列表。如果 partialFailure=false，则所有建议的类型均应相同 - 每个请求对应的操作数上限为 100。
partialFailure

boolean

如果为 true，则会执行成功的操作，并且无效操作将返回错误。如果为 false，当且仅当操作均有效时，操作将作为事务执行。默认值为 false。

响应正文

RecommendationService.ApplyRecommendation 的响应消息。

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

JSON 表示法 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
字段
results[]

object (ApplyRecommendationResult)

应用建议的操作结果。
partialFailureError

object (Status)

与部分失败模式下的操作失败相关的错误。仅当 partialFailure = true 并且操作中出现所有错误时，才返回 partialFailure。如果在操作之外发生任何错误（例如身份验证错误），我们将返回 RPC 级错误。

授权范围

需要以下 OAuth 作用域：

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

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

ApplyRecommendationOperation

有关应用建议的操作以及用于自定义建议的任何参数的信息。

JSON 表示法 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
字段
resourceName

string

要应用的建议的资源名称。
联合字段 apply_parameters。应用建议的参数。apply_parameters 只能是下列其中一项：
campaignBudget

object (CampaignBudgetParameters)

应用广告系列预算建议的可选参数。
textAd

object (TextAdParameters)

采纳文字广告建议时使用的可选参数。
keyword

object (KeywordParameters)

应用关键字建议时使用的可选参数。
targetCpaOptIn

object (TargetCpaOptInParameters)

采纳目标每次转化费用建议时要使用的可选参数。
targetRoasOptIn

object (TargetRoasOptInParameters)

采纳“目标广告支出回报率”出价策略建议时要使用的可选参数。
calloutExtension

object (CalloutExtensionParameters)

采纳附加宣传信息建议时要使用的参数。
callExtension

object (CallExtensionParameters)

采纳附加电话信息建议时要使用的参数。
moveUnusedBudget

object (MoveUnusedBudgetParameters)

应用未使用的预算建议时要使用的参数。
responsiveSearchAd

object (ResponsiveSearchAdParameters)

应用自适应搜索广告建议时使用的参数。
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

采纳“使用广泛匹配关键字”建议时要使用的参数。
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

采纳自适应搜索广告素材资源建议时要使用的参数。
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

应用自适应搜索广告时要使用的参数会提升广告效力建议。
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

采纳目标每次转化费用出价建议过低时要使用的参数。应用是异步进行的，可能需要几分钟的时间，具体取决于相关广告系列中的广告组数量。
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

应用预测设置目标广告支出回报率建议时使用的参数。
calloutAsset

object (CalloutAssetParameters)

采纳宣传信息素材资源建议时使用的参数。
callAsset

object (CallAssetParameters)

采纳电话素材资源建议的参数。
raiseTargetCpa

object (RaiseTargetCpaParameters)

应用目标每次转化费用提高建议时要使用的参数。
lowerTargetRoas

object (LowerTargetRoasParameters)

采纳较低的目标广告支出回报率建议时使用的参数。

CampaignBudgetParameters

应用广告系列预算建议的参数。

JSON 表示法 
{
  "newBudgetAmountMicros": string
}
字段
newBudgetAmountMicros

string (int64 format)

要为目标预算资源设置的新预算金额。此字段是必填字段。

TextAdParameters

应用文字广告建议时使用的参数。

JSON 表示法 
{
  "ad": {
    object (Ad)
  }
}
字段
ad

object (Ad)

要添加到推荐的广告组的新广告。必须在此消息中设置所有必填字段。此字段是必填字段。

KeywordParameters

应用关键字建议时要使用的参数。

JSON 表示法 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
字段
matchType

enum (KeywordMatchType)

关键字的匹配类型。此字段是必填字段。
adGroup

string

要向其中添加关键字的广告组资源。此字段是必填字段。
cpcBidMicros

string (int64 format)

（可选）为关键字设置的每次点击费用出价。如果未设置，关键字将根据目标广告组使用的出价策略使用出价。

TargetCpaOptInParameters

应用目标每次转化费用建议时要使用的参数。

JSON 表示法 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
字段
targetCpaMicros

string (int64 format)

用于“目标每次转化费用”出价策略的平均每次转化费用。此字段是必填字段。
newCampaignBudgetAmountMicros

string (int64 format)

（可选）要为广告系列设置的预算金额。

TargetRoasOptInParameters

采纳“目标广告支出回报率”出价策略建议时要使用的参数。

JSON 表示法 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
字段
targetRoas

number

要用于“目标广告支出回报率”出价策略的平均广告支出回报率（每单位支出带来的收入）。该值介于 0.01 和 1000.0 之间（含 0.01 和 1000.0）。除非设置了 newCampaignBudgetAmountMicros，否则此字段是必填字段。
newCampaignBudgetAmountMicros

string (int64 format)

（可选）要为广告系列设置的预算金额。

CalloutExtensionParameters

采纳附加宣传信息建议时要使用的参数。

JSON 表示法 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
字段
calloutExtensions[]

object (CalloutFeedItem)

要添加的附加宣传信息。此字段是必填字段。

CallExtensionParameters

采纳附加电话信息建议时要使用的参数。

JSON 表示法 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
字段
callExtensions[]

object (CallFeedItem)

要添加的附加电话信息。此字段是必填字段。

SitelinkExtensionParameters

应用附加链接建议时使用的参数。

JSON 表示法 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
字段

MoveUnusedBudgetParameters

应用未使用的预算建议时要使用的参数。

JSON 表示法 
{
  "budgetMicrosToMove": string
}
字段
budgetMicrosToMove

string (int64 format)

要从超出预算转为预算受限的预算金额。此字段是必填字段。

ResponsiveSearchAdParameters

应用自适应搜索广告建议时使用的参数。

JSON 表示法 
{
  "ad": {
    object (Ad)
  }
}
字段
ad

object (Ad)

必需。要添加到推荐的广告组的新广告。

UseBroadMatchKeywordParameters

采纳“使用广泛匹配关键字”建议时要使用的参数。

JSON 表示法 
{
  "newBudgetAmountMicros": string
}
字段
newBudgetAmountMicros

string (int64 format)

要为目标预算资源设置的新预算金额。

ResponsiveSearchAdAssetParameters

采纳自适应搜索广告素材资源建议时要使用的参数。

JSON 表示法 
{
  "updatedAd": {
    object (Ad)
  }
}
字段
updatedAd

object (Ad)

广告已更新。当前广告的内容将被替换。

ResponsiveSearchAdImproveAdStrengthParameters

应用自适应搜索广告时要使用的参数会提升广告效力建议。

JSON 表示法 
{
  "updatedAd": {
    object (Ad)
  }
}
字段
updatedAd

object (Ad)

广告已更新。当前广告的内容将被替换。

RaiseTargetCpaBidTooLowParameters

采纳目标每次转化费用出价建议过低时要使用的参数。应用是异步进行的，可能需要几分钟的时间，具体取决于相关广告系列中的广告组数量。

JSON 表示法 
{
  "targetMultiplier": number
}
字段
targetMultiplier

number

必需。一个大于 1.0 的数字，表示目标每次转化费用的增加系数。此字段是必填字段。

ForecastingSetTargetRoasParameters

应用预测设置目标广告支出回报率建议时使用的参数。

JSON 表示法 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
字段
targetRoas

number

为广告系列资源设置的新目标广告支出回报率（每支出单位收入）。该值介于 0.01 和 1000.0 之间（含 0.01 和 1000.0）。
campaignBudgetAmountMicros

string (int64 format)

要为广告系列资源设置的新广告系列预算金额。

CalloutAssetParameters

应用宣传信息素材资源建议的参数。

JSON 表示法 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
字段
adAssetApplyParameters

object (AdAssetApplyParameters)

必需。要添加的宣传信息素材资源。此字段是必填字段。

AdAssetApplyParameters

采纳广告素材资源建议时使用的常用参数。

JSON 表示法 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
字段
newAssets[]

object (Asset)

要创建并附加到范围的资源。这可以在同一调用中与 existingAssets 结合使用。
existingAssets[]

string

要附加到范围的现有资产的资源名称。这可以在同一调用中与 newAssets 结合使用。
scope

enum (ApplyScope)

必需。资源的应用范围。广告系列级范围内的素材资源将应用于与相应建议关联的广告系列。客户范围内的素材资源将应用至整个帐号。广告系列范围内的素材资源将覆盖客户范围内附加的所有素材资源。

ApplyScope

素材资源的应用范围。

枚举
UNSPECIFIED 尚未指定应用范围。
UNKNOWN 未知。
CUSTOMER 在客户范围内应用。
CAMPAIGN 在广告系列范围内应用。

CallAssetParameters

采纳电话素材资源建议的参数。

JSON 表示法 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
字段
adAssetApplyParameters

object (AdAssetApplyParameters)

必需。要添加的电话素材资源。此字段是必填字段。

SitelinkAssetParameters

应用站内链接素材资源建议的参数。

JSON 表示法 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
字段
adAssetApplyParameters

object (AdAssetApplyParameters)

必需。要添加的站内链接素材资源。此字段是必填字段。

RaiseTargetCpaParameters

应用目标每次转化费用提高建议时使用的参数。

JSON 表示法 
{
  "targetCpaMultiplier": number
}
字段
targetCpaMultiplier

number

必需。要将每次转化费用调节系数设为目标。此字段是必填字段。

LowerTargetRoasParameters

采纳目标广告支出回报率较低的建议时要使用的参数。

JSON 表示法 
{
  "targetRoasMultiplier": number
}
字段
targetRoasMultiplier

number

必需。设置目标广告支出回报率调节系数。此字段是必填字段。

ApplyRecommendationResult

采纳建议的结果。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

如果应用成功，系统会返回此错误代码。