Method: customers.googleAds.mutate

สร้าง อัปเดต หรือนำทรัพยากรออก เมธอดนี้รองรับการทำธุรกรรมแบบอะตอมมิกด้วยทรัพยากรหลายประเภท ตัวอย่างเช่น คุณอาจสร้างแคมเปญและกำหนดงบประมาณแคมเปญแบบอะตอมๆ หรือจะดำเนินการเปลี่ยนแปลงหลายพันรายการแบบอะตอม

เมธอดนี้โดยพื้นฐานแล้วก็คือ Wrapper ของเมธอดกลายพันธุ์ต่างๆ คุณลักษณะเพียงอย่างเดียวที่สามารถนำเสนอแทนการเรียกเมธอดนั้นโดยตรง ได้แก่

  • ธุรกรรมแบบอะตอม
  • ชื่อทรัพยากรชั่วคราว (อธิบายไว้ด้านล่าง)
  • เวลาในการตอบสนองค่อนข้างลดลงเมื่อเรียกใช้หลายๆ การเปลี่ยนแปลง

หมายเหตุ: ระบบจะรวมเฉพาะทรัพยากรที่สนับสนุนธุรกรรมแบบอะตอม ดังนั้นวิธีนี้จึงไม่สามารถแทนที่การเรียกไปยังบริการแต่ละรายการได้ทั้งหมด

สิทธิประโยชน์จากธุรกรรมแบบปรมาณู

Atomicity ทำให้การจัดการข้อผิดพลาดง่ายขึ้นมาก หากคุณทำการเปลี่ยนแปลงหลายรายการแต่หนึ่งล้มเหลว อาจทำให้บัญชีของคุณอยู่ในสถานะที่ไม่สอดคล้องกันได้ ด้วยแอตทริบิวต์ Atomicity คุณอาจไปถึงสถานะที่เลือกโดยตรง หรือดำเนินการตามคำขอไม่สำเร็จและลองใหม่ได้

ชื่อทรัพยากรอุณหภูมิ

ชื่อทรัพยากรชั่วคราวคือชื่อทรัพยากรประเภทพิเศษที่ใช้สร้างทรัพยากรและอ้างอิงทรัพยากรนั้นในคำขอเดียวกัน เช่น หากสร้างงบประมาณแคมเปญโดยมี resourceName เท่ากับ customers/123/campaignBudgets/-1 คุณจะใช้ชื่อทรัพยากรดังกล่าวซ้ำได้ในช่อง Campaign.budget ในคำขอเดียวกัน ด้วยวิธีนี้ ทรัพยากรทั้งสองจะถูกสร้างขึ้นและเชื่อมโยงกันแบบอะตอม

ในการสร้างชื่อทรัพยากรชั่วคราว ให้ใส่ตัวเลขลบในส่วนของชื่อที่เซิร์ฟเวอร์จะจัดสรรตามปกติ

หมายเหตุ

  • ต้องสร้างทรัพยากรโดยใช้ชื่อชั่วคราวก่อนจึงจะนำชื่อนั้นมาใช้ใหม่ได้ เช่น ตัวอย่าง CampaignBudget+Campaign ก่อนหน้านี้จะล้มเหลวหากมีการกลับคำสั่งซื้อการเปลี่ยนแปลง
  • ระบบจะไม่จำชื่อชั่วคราวในคำขอต่างๆ
  • ไม่มีการจำกัดจำนวนชื่อชั่วคราวในคำขอ
  • ชื่อชั่วคราวแต่ละชื่อต้องใช้จำนวนลบที่ไม่ซ้ำกัน แม้ว่าประเภททรัพยากรจะแตกต่างกัน

เวลาในการตอบสนอง

สิ่งสำคัญคือต้องจัดกลุ่มการเปลี่ยนรูปแบบตามประเภททรัพยากร ไม่เช่นนั้นคําขออาจหมดเวลาและล้มเหลว เวลาในการตอบสนองนั้นใกล้เคียงกับชุดของการเรียกใช้วิธีการเปลี่ยนแปลงแต่ละวิธี โดยที่การเปลี่ยนแปลงแต่ละประเภทในทรัพยากรจะเป็นการเรียกใช้ใหม่ เช่น เมื่อเปลี่ยนแปลงแคมเปญ 10 รายการ กลุ่มโฆษณา 10 กลุ่มจะเหมือนกับการโทร 2 ครั้ง ขณะที่เปลี่ยนแปลงแคมเปญ 1 รายการ กลุ่มโฆษณา 1 กลุ่ม แคมเปญ 1 แคมเปญ กลุ่มโฆษณา 1 กลุ่มเท่ากับการโทร 4 ครั้ง

{ {}}AdCustomizerErrorAdErrorAdGroupAdErrorAdGroupCriterionErrorAdGroupErrorAssetErrorAuthenticationErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError

คำขอ HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/googleAds:mutate

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

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

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

string

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

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

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

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

object (MutateOperation)

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

boolean

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

boolean

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

enum (ResponseContentType)

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

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

ข้อความตอบกลับสำหรับ GoogleAdsService.Mutate

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

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

object (Status)

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

object (MutateOperationResponse)

คำตอบทั้งหมดสำหรับการเปลี่ยนแปลง

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

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

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

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