Method: customers.adGroupAssetSets.mutate

สร้างหรือนําชุดชิ้นงานกลุ่มโฆษณาออก ระบบจะแสดงสถานะการดำเนินการ

คำขอ HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่มีชุดชิ้นงานกลุ่มโฆษณาอยู่ระหว่างการแก้ไข

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

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

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

object (AdGroupAssetSetOperation)

ต้องระบุ รายการการดำเนินการที่จะทำกับชุดชิ้นงานกลุ่มโฆษณาแต่ละชุด
partialFailure

boolean

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

boolean

หากเป็นจริง ระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาดเท่านั้น ไม่มีผลลัพธ์
responseContentType

enum (ResponseContentType)

การตั้งค่าประเภทเนื้อหาของคำตอบ กำหนดว่าควรแสดงทรัพยากรที่เปลี่ยนแปลงได้หรือแค่ชื่อทรัพยากรหลังการดัดแปลง

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

ข้อความตอบกลับสําหรับชุดชิ้นงานกลุ่มโฆษณามีการเปลี่ยนแปลง

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

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

object (MutateAdGroupAssetSetResult)

ผลลัพธ์ทั้งหมดของการเปลี่ยน
partialFailureError

object (Status)

ข้อผิดพลาดที่เกี่ยวข้องกับการดำเนินการที่ไม่สำเร็จในโหมดไม่สำเร็จบางส่วน แสดงผลเมื่อ someFailure = true (จริง) และข้อผิดพลาดทั้งหมดเกิดขึ้นภายในการดำเนินการ หากเกิดข้อผิดพลาดนอกการดำเนินการ (เช่น ข้อผิดพลาดในการให้สิทธิ์) เราจะแสดงข้อผิดพลาดระดับ RPC

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวม OAuth 2.0

AdGroupAssetSetOperation

การดำเนินการเดียว (สร้าง นําออก) ในชุดชิ้นงานกลุ่มโฆษณา

การแสดง JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
ช่อง
ฟิลด์สหภาพ operation การดำเนินการเปลี่ยนแปลง operation ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
create

object (AdGroupAssetSet)

การดำเนินการสร้าง: คาดว่าชุดชิ้นงานกลุ่มโฆษณาใหม่จะไม่มีชื่อทรัพยากร
remove

string

การดำเนินการนําออก: คาดว่าจะมีชื่อทรัพยากรสําหรับชุดชิ้นงานกลุ่มโฆษณาที่นําออกในรูปแบบ customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

ผลลัพธ์ของชุดชิ้นงานกลุ่มโฆษณาจะเปลี่ยนแปลง

การแสดง JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
ช่อง
resourceName

string

แสดงผลเมื่อการดำเนินการสำเร็จ
adGroupAssetSet

object (AdGroupAssetSet)

ชิ้นงานกลุ่มโฆษณาที่ผ่านการกลายพันธุ์ซึ่งมีเฉพาะช่องที่เปลี่ยนแปลงได้หลังจากการกลายพันธุ์ ระบบจะแสดงฟิลด์ก็ต่อเมื่อตั้งค่า responseContentType เป็น "MUTABLE_RESOURCE"