Method: albums.batchAddMediaItems

เพิ่มรายการสื่ออย่างน้อย 1 รายการในคลังภาพ Google Photos ของผู้ใช้ลงในอัลบั้ม รายการสื่อและอัลบั้มต้องสร้างขึ้นโดยนักพัฒนาซอฟต์แวร์ผ่าน API

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

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

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

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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