- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- ApplyRecommendationOperation
- CampaignBudgetParameters
- TextAdParameters
- KeywordParameters
- TargetCpaOptInParameters
- TargetRoasOptInParameters
- CalloutExtensionParameters
- CallExtensionParameters
- SitelinkExtensionParameters
- MoveUnusedBudgetParameters
- ResponsiveSearchAdParameters
- UseBroadMatchKeywordParameters
- ResponsiveSearchAdAssetParameters
- ResponsiveSearchAdImproveAdStrengthParameters
- RaiseTargetCpaBidTooLowParameters
- ForecastingSetTargetRoasParameters
- CalloutAssetParameters
- AdAssetApplyParameters
- ApplyScope
- CallAssetParameters
- SitelinkAssetParameters
- RaiseTargetCpaParameters
- LowerTargetRoasParameters
- ForecastingSetTargetCpaParameters
- ApplyRecommendationResult
- 試試看!
使用相應的套用參數套用指定的建議。
擲回錯誤清單:AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
HTTP 要求
POST https://googleads.googleapis.com/v15/customers/{customerId}/recommendations:apply
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。提供建議的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"operations": [
{
object ( |
欄位 | |
---|---|
operations[] |
必要欄位。列出要套用建議的作業。如果部分建議應屬於同一類型,則每個要求最多只能包含 100 個作業。 |
partialFailure |
如果為 true,系統就會執行成功的作業,且無效的作業會傳回錯誤。如果為 false,只有當作業全部有效時,系統才會以交易的形式執行。預設值為 false。 |
回應主體
RecommendationService.ApplyRecommendation
的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "results": [ { object ( |
欄位 | |
---|---|
results[] |
套用最佳化建議的作業結果。 |
partialFailureError |
在部分失敗模式下,與作業失敗相關的錯誤。只有在部分失敗 = true 且作業內發生所有錯誤時,才會傳回這個編號。如果在作業以外發生任何錯誤 (例如驗證錯誤),我們會傳回遠端程序呼叫 (RPC) 層級錯誤。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
ApplyRecommendationOperation
套用建議的作業相關資訊,以及用來自訂建議的任何參數。
JSON 表示法 |
---|
{ "resourceName": string, // Union field |
欄位 | |
---|---|
resourceName |
要套用的建議資源名稱。 |
聯集欄位 apply_parameters 。套用建議時使用的參數。apply_parameters 只能是下列其中一項: |
|
campaignBudget |
套用廣告活動預算建議時使用的選用參數。 |
textAd |
套用文字廣告建議時使用的選用參數。 |
keyword |
套用關鍵字建議時使用的選用參數。 |
targetCpaOptIn |
套用「採用目標單次轉換出價」最佳化建議時要使用的選用參數。 |
targetRoasOptIn |
套用「採用目標廣告投資報酬率」的建議時,要使用的選用參數。 |
calloutExtension |
套用摘要額外資訊建議時使用的參數。 |
callExtension |
套用來電額外資訊建議時使用的參數。 |
sitelinkExtension |
套用網站連結建議時使用的參數。 |
moveUnusedBudget |
套用未用到的預算建議時要使用的參數。 |
responsiveSearchAd |
套用回應式搜尋廣告建議時使用的參數。 |
useBroadMatchKeyword |
套用使用廣泛比對關鍵字建議時要使用的參數。 |
responsiveSearchAdAsset |
套用回應式搜尋廣告素材資源建議時使用的參數。 |
responsiveSearchAdImproveAdStrength |
套用回應式搜尋廣告時要使用的參數,可改善廣告優異度建議。 |
raiseTargetCpaBidTooLow |
套用目標單次轉換出價過低建議值時要使用的參數。這是非同步套用,且可能需要幾分鐘的時間,視相關廣告活動中的廣告群組數量而定。 |
forecastingSetTargetRoas |
套用預測設定目標廣告投資報酬率建議時使用的參數。 |
calloutAsset |
套用摘要素材資源建議時使用的參數。 |
callAsset |
套用電話素材資源最佳化建議時使用的參數。 |
sitelinkAsset |
套用網站連結素材資源建議時使用的參數。 |
raiseTargetCpa |
套用提高目標單次轉換出價建議時使用的參數。 |
lowerTargetRoas |
套用較低目標廣告投資報酬率最佳化建議時要使用的參數。 |
forecastingSetTargetCpa |
套用預測設定目標單次轉換出價建議時使用的參數。 |
setTargetCpa |
套用設定目標單次轉換出價建議時使用的參數。 |
setTargetRoas |
套用設定目標廣告投資報酬率建議時要使用的參數。 |
CampaignBudgetParameters
套用廣告活動預算建議時使用的參數。
JSON 表示法 |
---|
{ "newBudgetAmountMicros": string } |
欄位 | |
---|---|
newBudgetAmountMicros |
要為目標預算資源設定的新預算金額。此為必填欄位。 |
TextAdParameters
套用文字廣告建議時使用的參數。
JSON 表示法 |
---|
{
"ad": {
object ( |
欄位 | |
---|---|
ad |
要加進建議廣告群組中的新廣告。請務必在這則訊息中設定所有必要欄位。此為必填欄位。 |
KeywordParameters
套用關鍵字建議時使用的參數。
JSON 表示法 |
---|
{
"matchType": enum ( |
欄位 | |
---|---|
matchType |
關鍵字比對類型。此為必填欄位。 |
adGroup |
要新增關鍵字的廣告群組資源。此為必填欄位。 |
cpcBidMicros |
選擇性設定:關鍵字的單次點擊出價。如未設定,關鍵字就會根據目標廣告群組使用的出價策略來設定出價。 |
TargetCpaOptInParameters
套用目標單次轉換出價建議時使用的參數。
JSON 表示法 |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
欄位 | |
---|---|
targetCpaMicros |
目標單次轉換出價策略使用的平均單次轉換出價。此為必填欄位。 |
newCampaignBudgetAmountMicros |
(選填) 為廣告活動設定的預算金額。 |
TargetRoasOptInParameters
套用「採用目標廣告投資報酬率」最佳化建議時要使用的參數。
JSON 表示法 |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
欄位 | |
---|---|
targetRoas |
用於目標廣告投資報酬率出價策略的平均廣告投資報酬率 (每單位支出收益)。這個值介於 0.01 和 1000.0 (含) 之間。除非已設定 newCampaignBudgetAmountMicros,否則此為必填欄位。 |
newCampaignBudgetAmountMicros |
(選填) 為廣告活動設定的預算金額。 |
CalloutExtensionParameters
套用摘要額外資訊建議時使用的參數。
JSON 表示法 |
---|
{
"calloutExtensions": [
{
object ( |
欄位 | |
---|---|
calloutExtensions[] |
要新增的摘要額外資訊。此為必填欄位。 |
CallExtensionParameters
套用來電額外資訊建議時使用的參數。
JSON 表示法 |
---|
{
"callExtensions": [
{
object ( |
欄位 | |
---|---|
callExtensions[] |
要加入的來電額外資訊。此為必填欄位。 |
SitelinkExtensionParameters
套用網站連結建議時使用的參數。
JSON 表示法 |
---|
{
"sitelinkExtensions": [
{
object ( |
欄位 | |
---|---|
sitelinkExtensions[] |
要新增的網站連結。此為必填欄位。 |
MoveUnusedBudgetParameters
套用未用到的預算建議時要使用的參數。
JSON 表示法 |
---|
{ "budgetMicrosToMove": string } |
欄位 | |
---|---|
budgetMicrosToMove |
從超出預算的預算金額挪至不足的預算。此為必填欄位。 |
ResponsiveSearchAdParameters
套用回應式搜尋廣告建議時使用的參數。
JSON 表示法 |
---|
{
"ad": {
object ( |
欄位 | |
---|---|
ad |
必要欄位。要加進建議廣告群組中的新廣告。 |
UseBroadMatchKeywordParameters
套用使用廣泛比對關鍵字建議時要使用的參數。
JSON 表示法 |
---|
{ "newBudgetAmountMicros": string } |
欄位 | |
---|---|
newBudgetAmountMicros |
要為目標預算資源設定的新預算金額。 |
ResponsiveSearchAdAssetParameters
套用回應式搜尋廣告素材資源建議時使用的參數。
JSON 表示法 |
---|
{
"updatedAd": {
object ( |
欄位 | |
---|---|
updatedAd |
已更新廣告。系統將替換目前廣告的內容。 |
ResponsiveSearchAdImproveAdStrengthParameters
套用回應式搜尋廣告時要使用的參數,可改善廣告優異度建議。
JSON 表示法 |
---|
{
"updatedAd": {
object ( |
欄位 | |
---|---|
updatedAd |
已更新廣告。系統將替換目前廣告的內容。 |
RaiseTargetCpaBidTooLowParameters
套用目標單次轉換出價過低建議值時要使用的參數。這是非同步套用,且可能需要幾分鐘的時間,視相關廣告活動中的廣告群組數量而定。
JSON 表示法 |
---|
{ "targetMultiplier": number } |
欄位 | |
---|---|
targetMultiplier |
必要欄位。大於 1.0 的數字,表示目標出價提高原因。此為必填欄位。 |
ForecastingSetTargetRoasParameters
套用預測設定目標目標廣告投資報酬率建議時使用的參數。
JSON 表示法 |
---|
{ "targetRoas": number, "campaignBudgetAmountMicros": string } |
欄位 | |
---|---|
targetRoas |
為廣告活動資源設定的新目標廣告投資報酬率 (每單位支出的收益)。這個值介於 0.01 和 1000.0 (含) 之間。 |
campaignBudgetAmountMicros |
為廣告活動資源設定的新廣告活動預算金額。 |
CalloutAssetParameters
套用摘要素材資源建議時使用的參數。
JSON 表示法 |
---|
{
"adAssetApplyParameters": {
object ( |
欄位 | |
---|---|
adAssetApplyParameters |
必要欄位。要新增的摘要素材資源。此為必填欄位。 |
AdAssetApplyParameters
套用廣告素材資源最佳化建議時使用的常見參數。
JSON 表示法 |
---|
{ "newAssets": [ { object ( |
欄位 | |
---|---|
newAssets[] |
要建立並附加至特定範圍的資產。這類屬性可能會與同一通話中的現有資產合併。 |
existingAssets[] |
要附加至範圍的現有資產資源名稱。系統可能會在同一次呼叫中與 newAsset 合併使用。 |
scope |
必要欄位。素材資源的套用範圍。廣告活動層級的素材資源會套用至與建議相關的廣告活動。客戶範圍內的素材資源會套用至整個帳戶。廣告活動範圍內的素材資源會覆寫客戶範圍中的任何附加項目。 |
ApplyScope
資產套用範圍。
列舉 | |
---|---|
UNSPECIFIED |
未指定套用範圍。 |
UNKNOWN |
不明。 |
CUSTOMER |
適用於客戶範圍。 |
CAMPAIGN |
適用於廣告活動範圍。 |
CallAssetParameters
套用電話素材資源建議時使用的參數。
JSON 表示法 |
---|
{
"adAssetApplyParameters": {
object ( |
欄位 | |
---|---|
adAssetApplyParameters |
必要欄位。要新增的電話素材資源。此為必填欄位。 |
SitelinkAssetParameters
套用網站連結素材資源建議時使用的參數。
JSON 表示法 |
---|
{
"adAssetApplyParameters": {
object ( |
欄位 | |
---|---|
adAssetApplyParameters |
必要欄位。要新增的網站連結素材資源。此為必填欄位。 |
RaiseTargetCpaParameters
套用提高目標單次轉換出價建議時使用的參數。
JSON 表示法 |
---|
{ "targetCpaMultiplier": number } |
欄位 | |
---|---|
targetCpaMultiplier |
必要欄位。設定單次轉換出價調節係數的目標。此為必填欄位。 |
LowerTargetRoasParameters
套用較低的目標廣告投資報酬率最佳化建議時要使用的參數。
JSON 表示法 |
---|
{ "targetRoasMultiplier": number } |
欄位 | |
---|---|
targetRoasMultiplier |
必要欄位。將廣告投資報酬率調節係數設為的目標。此為必填欄位。 |
ForecastingSetTargetCpaParameters
套用固定目標單次轉換出價建議時使用的參數。
JSON 表示法 |
---|
{ "targetCpaMicros": string, "campaignBudgetAmountMicros": string } |
欄位 | |
---|---|
targetCpaMicros |
目標單次轉換出價策略使用的平均單次轉換出價。 |
campaignBudgetAmountMicros |
為廣告活動資源設定的新廣告活動預算金額。 |
ApplyRecommendationResult
套用建議的結果。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
因成功套用而傳回。 |