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 Overview