Method: customers.recommendations.apply

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

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

คำขอ HTTP

POST https://googleads.googleapis.com/v14/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)
  }
  // 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 เป้าหมายที่ต่ำลง

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 นี่เป็นฟิลด์ที่ต้องระบุ

ApplyRecommendationResult

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

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

string

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