Method: customers.adGroupAds.mutate

สร้าง อัปเดต หรือนําโฆษณาออก ระบบจะแสดงสถานะการดำเนินการ

รายการข้อผิดพลาดที่แสดง: AdCustomizerError AdError AdGroupAdError AdSharingError AdxError AssetError AssetLinkError AuthenticationError AuthorizationError CollectionSizeError ContextError DatabaseError DateError DistinctError FeedAttributeReferenceError FieldError FieldMaskError FunctionError FunctionParsingError HeaderError IdError ImageError InternalError ListOperationError MediaBundleError MediaFileError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError PolicyFindingError PolicyValidationParameterError PolicyViolationError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError UrlFieldError

คำขอ HTTP

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

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่กําลังแก้ไขโฆษณา

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

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

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

object (AdGroupAdOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

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

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

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

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

object (Status)

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

object (MutateAdGroupAdResult)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview