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