Method: customers.accountBudgetProposals.mutate

สร้าง อัปเดต หรือนำข้อเสนองบประมาณของบัญชีออก ระบบจะแสดงผลสถานะการดำเนินการ

<br class-Error-Error="1- เมื่ออ่าน <br/0 <br> AccountBudgetProposalError AuthenticationErrorAuthorizationErrorDatabaseErrorDateErrorFieldErrorFieldMaskErrorHeaderErrorInternalErrorMutateErrorQuotaErrorRequestErrorStringLengthError

คำขอ HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate

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

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

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

string

ต้องระบุ รหัสของลูกค้า

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

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

การแสดง JSON
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
ช่อง
operation

object (AccountBudgetProposalOperation)

ต้องระบุ การดําเนินการในข้อเสนองบประมาณระดับบัญชีแต่ละรายการ

validateOnly

boolean

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

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

ข้อความตอบกลับสำหรับการดำเนินการเปลี่ยนแปลงงบประมาณระดับบัญชี

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

การแสดง JSON
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
ช่อง
result

object (MutateAccountBudgetProposalResult)

ผลลัพธ์ของการเปลี่ยนแปลง

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

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

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

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

AccountBudgetProposalOperation

การดำเนินการแบบเดียวที่เสนอการสร้างงบประมาณระดับบัญชีใหม่ หรือแก้ไข/สิ้นสุด/นำงบประมาณที่มีอยู่ออก

การแสดง JSON
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
ช่อง
updateMask

string (FieldMask format)

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

ข้อเสนอที่แก้ไขงบประมาณจะมีประเภทข้อเสนอเป็น "อัปเดต" การระบุมาสก์สำหรับข้อเสนอประเภทอื่นๆ จะถือว่าเป็นข้อผิดพลาด

ซึ่งเป็นรายการชื่อฟิลด์ที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

ฟิลด์การรวม operation การดำเนินการเปลี่ยนแปลง operation ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
create

object (AccountBudgetProposal)

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

remove

string

นำการดำเนินการออก: ควรมีชื่อทรัพยากรสำหรับข้อเสนอที่ถูกนำออกในรูปแบบต่อไปนี้

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} คำขออาจถูกยกเลิกหากอยู่ระหว่างรอดำเนินการ

MutateAccountBudgetProposalResult

ผลลัพธ์สำหรับข้อเสนองบประมาณบัญชีมีการเปลี่ยนแปลง

การแสดง JSON
{
  "resourceName": string
}
ช่อง
resourceName

string

แสดงผลสำหรับการดำเนินการที่ประสบความสำเร็จ