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