Method: selection.v1.projects.selectedRoutes.batchUpdate

อัปเดตทรัพยากร SelectedRoute หลายรายการตามที่ระบุโดยชื่อ

คำขอ HTTP

POST https://roads.googleapis.com/selection/v1/{parent=projects/*}/selectedRoutes:batchUpdate

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

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

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

string

ต้องระบุ ทรัพยากรโปรเจ็กต์ที่เส้นทางที่เลือกทั้งหมดในชุดแชร์ จำเป็นเนื่องจากคำขอแบบกลุ่มรองรับ parent รายการเดียวเท่านั้น รูปแบบ: projects/{project}

เนื้อหาคำขอ

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

การแสดง JSON 
{
  "requests": [
    {
      object (UpdateSelectedRouteRequest)
    }
  ],
  "updateMask": string
}
ช่อง
requests[]

object (UpdateSelectedRouteRequest)

ต้องระบุ ข้อความคำขอที่ระบุเส้นทางที่เลือกที่จะอัปเดต อัปเดตเส้นทางที่เลือกได้สูงสุด 1,000 รายการในชุด ทรัพยากรระดับบนสุดของคำขอแต่ละรายการต้องว่างเปล่าหรือตรงกับ parent ระดับบนสุด
updateMask

string (FieldMask format)

ไม่บังคับ รายการช่องที่จะอัปเดตซึ่งคำขอระดับล่างทั้งหมดในชุดแชร์

เส้นทางของช่องจะสัมพันธ์กับ SelectedRoute คุณควรจะอัปเดตเฉพาะ displayName, routeAttributes และ dynamicRoute (รวมถึง origin, destination และ intermediates)

ตัวอย่าง: "displayName,routeAttributes,dynamicRoute"

หากตั้งค่าไว้ updateMask นี้จะมีผลกับคำขอระดับล่างที่ไม่ได้ระบุ updateMask ของตนเอง หากระบุ * ระบบจะแทนที่ช่องที่อัปเดตได้ทั้งหมด หากตั้งค่าทั้งช่อง updateMask ระดับคำขอแบบกลุ่มและระดับคำขอระดับล่าง ค่าดังกล่าวต้องตรงกัน

หากละเว้น ระบบจะใช้ updateMask ของคำขอระดับล่าง หากละเว้น updateMask ของคำขอระดับล่างด้วย ระบบจะถือว่าช่องที่อัปเดตได้ทั้งหมดซึ่งป้อนข้อมูลใน selectedRoute ของคำขอระดับล่างได้รับการอัปเดต

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

การตอบกลับจากการอัปเดต SelectedRoute หลายรายการ

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

การแสดง JSON 
{
  "selectedRoutes": [
    {
      object (SelectedRoute)
    }
  ]
}
ช่อง
selectedRoutes[]

object (SelectedRoute)

ทรัพยากร SelectedRoute ที่อัปเดต

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

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

  • https://www.googleapis.com/auth/cloud-platform

สิทธิ์ IAM

ต้องมีสิทธิ์ IAM ต่อไปนี้ในทรัพยากร parent

  • roads.selectedRoutes.batchUpdate

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบ IAM

UpdateSelectedRouteRequest

คำขออัปเดต SelectedRoute

การแสดง JSON 
{
  "selectedRoute": {
    object (SelectedRoute)
  },
  "updateMask": string
}
ช่อง
selectedRoute

object (SelectedRoute)

ต้องระบุ SelectedRoute ที่จะอัปเดต ระบบจะใช้ช่อง name ของเส้นทางเพื่อระบุเส้นทางที่จะอัปเดต รูปแบบ: projects/{project}/selectedRoutes/{selectedRoute}
updateMask

string (FieldMask format)

ไม่บังคับ รายการช่องที่จะอัปเดต

เส้นทางของช่องจะสัมพันธ์กับ SelectedRoute คุณควรจะอัปเดตเฉพาะ displayName, routeAttributes หรือ dynamicRoute (รวมถึง origin, destination และ intermediates)

ตัวอย่าง: "displayName,routeAttributes,dynamicRoute"

หากระบุ * ระบบจะแทนที่ช่องที่อัปเดตได้ทั้งหมด

หากละเว้น updateMask ระบบจะถือว่าช่องที่อัปเดตได้ทั้งหมดซึ่งป้อนข้อมูลใน selectedRoute ได้รับการอัปเดต