- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- AdGroupAssetSetOperation
- MutateAdGroupAssetSetResult
- ลองใช้งาน
สร้างหรือนำชุดชิ้นงานของกลุ่มโฆษณาออก สถานะการดำเนินการจะแสดงขึ้น
คำขอ HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
customerId |
ต้องระบุ รหัสของลูกค้าที่กำลังแก้ไขชุดชิ้นงานกลุ่มโฆษณา |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "operations": [ { object ( |
ช่อง | |
---|---|
operations[] |
ต้องระบุ รายการการดำเนินการที่จะทำกับชุดชิ้นงานของกลุ่มโฆษณาแต่ละชุด |
partialFailure |
หากเป็นจริง ระบบจะดำเนินการที่สำเร็จ และการดำเนินการที่ไม่ถูกต้องจะแสดงข้อผิดพลาด หากเป็น "เท็จ" การดำเนินการทั้งหมดจะดำเนินการในธุรกรรมเดียวหากเป็นไปตามเงื่อนไขทั้งหมดเท่านั้น ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้ที่ false |
validateOnly |
หากเป็น "จริง" ระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ ผลลัพธ์จะแสดงเพียงข้อผิดพลาดเท่านั้น |
responseContentType |
การตั้งค่าประเภทเนื้อหาการตอบกลับ กำหนดว่าควรแสดงผลทรัพยากรที่เปลี่ยนแปลงได้หรือเฉพาะชื่อทรัพยากรหลังการเปลี่ยนแปลง |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับการเปลี่ยนแปลงชุดชิ้นงานของกลุ่มโฆษณา
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "results": [ { object ( |
ช่อง | |
---|---|
results[] |
ผลลัพธ์ทั้งหมดสำหรับการเปลี่ยนแปลง |
partialFailureError |
ข้อผิดพลาดที่เกี่ยวข้องกับการดำเนินการที่ล้มเหลวในโหมดความล้มเหลวบางส่วน แสดงผลเมื่อ someFailure = true (จริง) และข้อผิดพลาดทั้งหมดเกิดขึ้นภายในการดำเนินการ หากมีข้อผิดพลาดเกิดขึ้นนอกการดำเนินการ (เช่น ข้อผิดพลาดในการตรวจสอบสิทธิ์) เราจะแสดงข้อผิดพลาดระดับ RPC |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/adwords
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
AdGroupAssetSetOperation
การดำเนินการเพียงครั้งเดียว (สร้างและนำออก) ในชุดชิ้นงานของกลุ่มโฆษณา
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม operation การดำเนินการเปลี่ยนแปลง operation ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
create |
การดำเนินการสร้าง: คาดว่าชุดชิ้นงานกลุ่มโฆษณาใหม่จะไม่มีชื่อทรัพยากร |
remove |
การดำเนินการนำออก: ควรมีชื่อทรัพยากรสำหรับชุดชิ้นงานของกลุ่มโฆษณาที่นำออกแล้วในรูปแบบ |
MutateAdGroupAssetSetResult
ผลลัพธ์สำหรับชุดชิ้นงานของกลุ่มโฆษณามีการเปลี่ยนแปลง
การแสดง JSON |
---|
{
"resourceName": string,
"adGroupAssetSet": {
object ( |
ช่อง | |
---|---|
resourceName |
ส่งกลับสำหรับการดำเนินการที่ประสบความสำเร็จ |
adGroupAssetSet |
ชุดชิ้นงานของกลุ่มโฆษณาที่มีการเปลี่ยนแปลงซึ่งมีเฉพาะช่องที่เปลี่ยนแปลงได้หลังจากการเปลี่ยนแปลง ระบบจะแสดงผลช่องนี้เฉพาะเมื่อมีการตั้งค่า responseContentType เป็น "MUTABLE_RESOURCE" เท่านั้น |