Method: customers.assets.mutate

สร้างเนื้อหา สถานะการดำเนินการแสดงขึ้น

รายการข้อผิดพลาด: AssetError AuthenticationError AuthorizationError CollectionSizeError CurrencyCodeError DatabaseError DateError DistinctErrorHeaderErrorIdErrorInternalErrorListOperationErrorMediaUploadErrorMutateErrorNotAllowlistedErrorNotEmptyErrorOperatorErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorYoutubeVideoRegistrationError

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (AssetOperation)

ต้องระบุ รายการการดำเนินการที่จะดำเนินการกับเนื้อหาแต่ละรายการ

partialFailure

boolean

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

responseContentType

enum (ResponseContentType)

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

validateOnly

boolean

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

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

ข้อความตอบกลับสำหรับการเปลี่ยนรูปแบบเนื้อหา

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

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

object (Status)

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

results[]

object (MutateAssetResult)

ผลลัพธ์ทั้งหมดสำหรับการเปลี่ยนแปลง

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0