Method: customers.recommendations.apply

ใช้คำแนะนำที่ระบุร่วมกับพารามิเตอร์ "Apply" ที่เกี่ยวข้อง

รายการข้อผิดพลาดที่เกิดขึ้น: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError อยู่เสมอ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ต้องระบุ รหัสของลูกค้าที่มีคำแนะนำ

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
ช่อง
operations[]

object (ApplyRecommendationOperation)

ต้องระบุ รายการการดําเนินการที่จะใช้คําแนะนํา หาก partialFailure=false คำแนะนำทั้งหมดควรเป็นประเภทเดียวกัน จะมีขีดจำกัดการดำเนินการ 100 รายการต่อคำขอ
partialFailure

boolean

หากค่าเป็น "จริง" ระบบจะดําเนินการสําเร็จและการดําเนินการที่ไม่ถูกต้องจะแสดงข้อผิดพลาด หากเป็นเท็จ การดำเนินการจะหมายถึงธุรกรรมก็ต่อเมื่อการดำเนินการทั้งหมดถูกต้องเท่านั้น ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้ที่ false

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ RecommendationService.ApplyRecommendation

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
ช่อง
results[]

object (ApplyRecommendationResult)

ผลลัพธ์การดำเนินการเพื่อใช้คำแนะนำ
partialFailureError

object (Status)

ข้อผิดพลาดที่เกี่ยวข้องกับความล้มเหลวในการดำเนินการในโหมดการทำงานล้มเหลวบางส่วน แสดงผลเฉพาะเมื่อบางส่วนFailure = true และข้อผิดพลาดทั้งหมดเกิดขึ้นภายในการดำเนินการ หากมีข้อผิดพลาดเกิดขึ้นนอกการดำเนินการ (เช่น ข้อผิดพลาดในการตรวจสอบสิทธิ์) เราจะแสดงผลข้อผิดพลาดระดับ 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)
  },
  "forecastingSetTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  }
  // 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)

พารามิเตอร์ที่ไม่บังคับซึ่งควรใช้เมื่อใช้คำแนะนำการเลือกใช้ CPA เป้าหมาย
targetRoasOptIn

object (TargetRoasOptInParameters)

พารามิเตอร์ที่ไม่บังคับเมื่อใช้คำแนะนำการเลือกใช้ ROAS เป้าหมาย
calloutExtension

object (CalloutExtensionParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำส่วนขยายไฮไลต์
callExtension

object (CallExtensionParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำส่วนขยายการโทร
moveUnusedBudget

object (MoveUnusedBudgetParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำการย้ายงบประมาณที่ไม่ได้ใช้
responsiveSearchAd

object (ResponsiveSearchAdParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำโฆษณา Search ที่ปรับเปลี่ยนตามบริบท
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำคีย์เวิร์ดที่ทำงานแบบกว้าง
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำชิ้นงานโฆษณา Search ที่ปรับเปลี่ยนตามบริบท
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำในการปรับปรุงคุณภาพของโฆษณา Search ที่ปรับเปลี่ยนตามบริบท
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำการเพิ่มราคาเสนอ CPA เป้าหมายต่ำเกินไป การใช้รูปแบบนี้ไม่พร้อมกันและอาจใช้เวลาสักครู่ ทั้งนี้ขึ้นอยู่กับจำนวนกลุ่มโฆษณาในแคมเปญที่เกี่ยวข้อง
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ ROAS เป้าหมายที่ตั้งไว้สำหรับการคาดการณ์
calloutAsset

object (CalloutAssetParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำชิ้นงานข้อความไฮไลต์
callAsset

object (CallAssetParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำชิ้นงานการโทร
raiseTargetCpa

object (RaiseTargetCpaParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้การเพิ่มคำแนะนำ CPA เป้าหมาย
lowerTargetRoas

object (LowerTargetRoasParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ ROAS เป้าหมายที่ต่ำลง
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ CPA เป้าหมายที่ตั้งไว้สำหรับการคาดการณ์
setTargetCpa

object (ForecastingSetTargetCpaParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ CPA เป้าหมายที่ตั้งไว้
setTargetRoas

object (ForecastingSetTargetRoasParameters)

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ ROAS เป้าหมายที่ตั้งไว้

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)

การเสนอราคา CPC (ไม่บังคับ) ที่จะตั้งค่าสำหรับคีย์เวิร์ด หากไม่ได้ตั้งค่า คีย์เวิร์ดจะใช้ราคาเสนอตามกลยุทธ์การเสนอราคาที่ใช้โดยกลุ่มโฆษณาเป้าหมาย

TargetCpaOptInParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ CPA เป้าหมาย

การแสดง JSON 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
ช่อง
targetCpaMicros

string (int64 format)

CPA เฉลี่ยที่จะใช้กับกลยุทธ์การเสนอราคา CPA เป้าหมาย นี่เป็นฟิลด์ที่ต้องระบุ
newCampaignBudgetAmountMicros

string (int64 format)

จำนวนงบประมาณ (ไม่บังคับ) ที่จะตั้งให้กับแคมเปญ

TargetRoasOptInParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำในการเลือกใช้ ROAS เป้าหมาย

การแสดง JSON 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
ช่อง
targetRoas

number

ROAS เฉลี่ย (รายได้ต่อหน่วยการใช้จ่าย) ที่จะใช้กับกลยุทธ์การเสนอราคา ROAS เป้าหมาย ค่าโดยรวมอยู่ระหว่าง 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

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำโฆษณา Search ที่ปรับเปลี่ยนตามบริบท

การแสดง JSON 
{
  "ad": {
    object (Ad)
  }
}
ช่อง
ad

object (Ad)

ต้องระบุ โฆษณาใหม่ที่จะเพิ่มในกลุ่มโฆษณาที่แนะนำ

UseBroadMatchKeywordParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำคีย์เวิร์ดที่ทำงานแบบกว้าง

การแสดง JSON 
{
  "newBudgetAmountMicros": string
}
ช่อง
newBudgetAmountMicros

string (int64 format)

จำนวนงบประมาณใหม่ที่จะตั้งค่าสำหรับทรัพยากรงบประมาณเป้าหมาย

ResponsiveSearchAdAssetParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำชิ้นงานโฆษณา Search ที่ปรับเปลี่ยนตามบริบท

การแสดง JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
ช่อง
updatedAd

object (Ad)

อัปเดตโฆษณาแล้ว เนื้อหาของโฆษณาปัจจุบันจะถูกแทนที่

ResponsiveSearchAdImproveAdStrengthParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำในการปรับปรุงคุณภาพของโฆษณา Search ที่ปรับเปลี่ยนตามบริบท

การแสดง JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
ช่อง
updatedAd

object (Ad)

อัปเดตโฆษณาแล้ว เนื้อหาของโฆษณาปัจจุบันจะถูกแทนที่

RaiseTargetCpaBidTooLowParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำการเพิ่มราคาเสนอ CPA เป้าหมายต่ำเกินไป การใช้เป็นการทำงานไม่พร้อมกันและอาจใช้เวลาสักครู่ ทั้งนี้ขึ้นอยู่กับจำนวนกลุ่มโฆษณาในแคมเปญที่เกี่ยวข้อง

การแสดง JSON 
{
  "targetMultiplier": number
}
ช่อง
targetMultiplier

number

ต้องระบุ ตัวเลขที่มากกว่า 1.0 หมายถึงปัจจัยที่จะเพิ่ม CPA เป้าหมาย นี่เป็นฟิลด์ที่ต้องระบุ

ForecastingSetTargetRoasParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ ROAS เป้าหมายชุดการคาดการณ์

การแสดง JSON 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
ช่อง
targetRoas

number

ROAS เป้าหมายใหม่ (รายได้ต่อหน่วยการใช้จ่าย) เพื่อกําหนดให้กับทรัพยากรของแคมเปญ ค่าโดยรวมอยู่ระหว่าง 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[]

string

ชื่อทรัพยากรของเนื้อหาที่มีอยู่ที่จะแนบไปกับขอบเขต ซึ่งอาจรวมกับ newAssets ในการเรียกเดียวกัน
scope

enum (ApplyScope)

ต้องระบุ ขอบเขตที่จะใช้ชิ้นงาน ชิ้นงานในขอบเขตแคมเปญจะมีผลกับแคมเปญที่เชื่อมโยงกับคําแนะนํา ชิ้นงานที่อยู่ในขอบเขตของลูกค้าจะมีผลกับทั้งบัญชี ชิ้นงานที่อยู่ในขอบเขตแคมเปญจะลบล้างชิ้นงานที่แนบมาที่ขอบเขตของลูกค้า

ApplyScope

ขอบเขตที่จะนำไปใช้กับเนื้อหา

Enum
UNSPECIFIED ไม่ได้ระบุขอบเขตการใช้งาน
UNKNOWN ไม่รู้จัก
CUSTOMER ใช้ในขอบเขตของลูกค้า
CAMPAIGN นำไปใช้ในขอบเขตแคมเปญ

CallAssetParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำชิ้นงานการโทร

การแสดง JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
ช่อง
adAssetApplyParameters

object (AdAssetApplyParameters)

ต้องระบุ ชิ้นงานการโทรที่จะเพิ่ม นี่เป็นฟิลด์ที่ต้องระบุ

SitelinkAssetParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำชิ้นงานไซต์ลิงก์

การแสดง JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
ช่อง
adAssetApplyParameters

object (AdAssetApplyParameters)

ต้องระบุ ชิ้นงานไซต์ลิงก์ที่จะเพิ่ม นี่เป็นฟิลด์ที่ต้องระบุ

RaiseTargetCpaParameters

พารามิเตอร์ที่จะใช้เมื่อใช้การเพิ่มคำแนะนำ CPA เป้าหมาย

การแสดง JSON 
{
  "targetCpaMultiplier": number
}
ช่อง
targetCpaMultiplier

number

ต้องระบุ กำหนดเป้าหมายเพื่อกำหนดตัวคูณ CPA นี่เป็นฟิลด์ที่ต้องระบุ

LowerTargetRoasParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ ROAS เป้าหมายที่ต่ำลง

การแสดง JSON 
{
  "targetRoasMultiplier": number
}
ช่อง
targetRoasMultiplier

number

ต้องระบุ กำหนดเป้าหมายเพื่อกำหนดตัวคูณ ROAS นี่เป็นฟิลด์ที่ต้องระบุ

ForecastingSetTargetCpaParameters

พารามิเตอร์ที่จะใช้เมื่อใช้คำแนะนำ CPA เป้าหมายที่ตั้งไว้

การแสดง JSON 
{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}
ช่อง
targetCpaMicros

string (int64 format)

CPA เฉลี่ยที่จะใช้กับกลยุทธ์การเสนอราคา CPA เป้าหมาย
campaignBudgetAmountMicros

string (int64 format)

จำนวนงบประมาณแคมเปญใหม่ที่จะตั้งค่าสำหรับทรัพยากรแคมเปญ

ApplyRecommendationResult

ผลลัพธ์ของการใช้คำแนะนำ

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

แสดงผลสำหรับการสมัครสำเร็จ