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, dynamicRouting และ dynamicRoute (รวมถึง origin, destination และ intermediates)

ตัวอย่าง: "displayName,routeAttributes,dynamicRouting,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, dynamicRouting และ dynamicRoute (รวมถึง origin, destination และ intermediates)

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

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

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