Method: photos.batchUpdate

อัปเดตข้อมูลเมตาของ Photos เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ ฯลฯ ไม่รองรับการเปลี่ยนพิกเซลของรูปภาพ

โปรดทราบว่าหาก photos.batchUpdate ล้มเหลว ช่องที่สำคัญหายไปหนึ่งช่องหรือเกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ แม้จะใช้ photos.batchUpdate สำเร็จแล้ว แต่รูปภาพแต่ละรูปในแบตช์ก็อาจไม่สำเร็จ ความล้มเหลวเหล่านี้จะระบุอยู่ใน PhotoResponse.status แต่ละรายการใน BatchUpdatePhotosResponse.results ดู photo.update สำหรับความล้มเหลวที่เจาะจงที่อาจเกิดขึ้นต่อรูปภาพ

ใช้เฉพาะช่องที่ระบุในช่อง updateMask หากไม่มี updateMask การอัปเดตจะมีผลกับทุกช่อง

จำนวนข้อความ UpdatePhotoRequest ใน BatchUpdatePhotosRequest ต้องไม่เกิน 20

หมายเหตุ: หากต้องการอัปเดต Pose.altitude คุณต้องกรอก Pose.latLngPair ด้วย มิฉะนั้น คำขอจะดำเนินการไม่สำเร็จ

คำขอ HTTP

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

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

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

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

object

ต้องระบุ รายชื่อ UpdatePhotoRequests
updatePhotoRequests[].photo

object (Photo)

ต้องระบุ ออบเจ็กต์ Photo ที่มีข้อมูลเมตาใหม่
updatePhotoRequests[].updateMask

string (FieldMask format)

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

ช่องต่อไปนี้ถูกต้อง

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

หมายเหตุ: เมื่อ updateMask มีช่องที่ซ้ำ ระบบจะแทนที่ชุดค่าที่ซ้ำกันด้วยเนื้อหาใหม่ ตัวอย่างเช่น หาก updateMask มี connections และ UpdatePhotoRequest.photo.connections ว่างเปล่า ระบบจะนำการเชื่อมต่อทั้งหมดออก

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

การตอบสนองต่อการอัปเดตข้อมูลเมตาเป็นกลุ่มของ Photos อย่างน้อย 1 รายการ

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

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

object (PhotoResponse)

รายการผลลัพธ์ของ Photo แต่ละรายการที่อัปเดตในลำดับเดียวกับคำขอ

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

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

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

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