Method: albums.batchAddMediaItems

เพิ่มรายการสื่ออย่างน้อย 1 รายการในห้องสมุด Google Photos ของผู้ใช้ลงในอัลบั้ม นักพัฒนาแอปต้องสร้างรายการสื่อและอัลบั้มผ่าน API

ระบบจะเพิ่มรายการสื่อไว้ที่ท้ายอัลบั้ม หากมีรายการสื่อหลายรายการ ระบบจะเพิ่มรายการสื่อตามลำดับที่ระบุในการเรียกใช้นี้

แต่ละอัลบั้มมีรายการสื่อได้สูงสุด 20,000 รายการ

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

ระบบไม่รองรับการดำเนินการที่สำเร็จเพียงบางส่วน คำขอทั้งหมดจะดำเนินการไม่สำเร็จหากระบุรายการสื่อหรืออัลบั้มที่ไม่ถูกต้อง

คำขอ HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

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

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

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

string

ต้องระบุ ตัวระบุของ Album ที่เพิ่มรายการสื่อ

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

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

การแสดง JSON 
{
  "mediaItemIds": [
    string
  ]
}
ช่อง
mediaItemIds[]

string

ต้องระบุ ตัวระบุของ MediaItem ที่จะเพิ่ม จำนวนรายการสื่อสูงสุดที่เพิ่มได้ในคอลเดียวคือ 50 รายการ

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

หากดำเนินการสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า

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

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

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata