Method: mediaItems.batchCreate

สร้างรายการสื่ออย่างน้อย 1 รายการในคลังภาพ Google Photos ของผู้ใช้

ซึ่งเป็นขั้นตอนที่ 2 สำหรับการสร้างรายการสื่อ โปรดดูรายละเอียดเกี่ยวกับขั้นตอนที่ 1 ของการอัปโหลดไบต์ข้อมูล RAW ไปยังเซิร์ฟเวอร์ของ Google ที่การอัปโหลดสื่อ

การเรียกใช้นี้จะเพิ่มรายการสื่อลงในคลัง หากระบุอัลบั้ม id การเรียกใช้นี้จะเพิ่มรายการสื่อลงในอัลบั้มด้วย แต่ละอัลบั้มมีรายการสื่อได้สูงสุด 20,000 รายการ โดยค่าเริ่มต้น รายการสื่อจะถูกเพิ่มลงในท้ายไลบรารีหรืออัลบั้ม

หากมีการระบุทั้งอัลบั้ม id และตำแหน่ง ระบบจะเพิ่มรายการสื่อลงในอัลบั้มตามตำแหน่งที่ระบุ

หากในการเรียกมีรายการสื่อหลายรายการ ระบบจะเพิ่มรายการสื่อเหล่านั้นในตำแหน่งที่ระบุ หากคุณกำลังสร้างรายการสื่อในอัลบั้มที่แชร์ซึ่งคุณไม่ใช่เจ้าของ คุณจะไม่สามารถกำหนดตำแหน่งรายการสื่อได้ การดำเนินการดังกล่าวจะทำให้เกิดข้อผิดพลาด BAD REQUEST

คำขอ HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

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

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

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

การแสดง JSON 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
ช่อง
albumId

string

ตัวระบุของอัลบั้มที่เพิ่มรายการสื่อ ระบบจะเพิ่มรายการสื่อลงในคลังภาพของผู้ใช้ด้วย ฟิลด์นี้เป็นฟิลด์ที่ไม่บังคับ
newMediaItems[]

object (NewMediaItem)

ต้องระบุ รายการรายการสื่อที่จะสร้าง รายการสื่อสูงสุด 50 รายการต่อสาย
albumPosition

object (AlbumPosition)

ตำแหน่งในอัลบั้มที่มีการเพิ่มรายการสื่อ หากไม่ได้ระบุ ระบบจะเพิ่มรายการสื่อไปที่ตอนท้ายของอัลบั้ม (ตามค่าเริ่มต้น ซึ่งก็คือ LAST_IN_ALBUM) คำขอจะล้มเหลวหากตั้งค่าช่องนี้และไม่ได้ระบุ albumId นอกจากนี้ คำขอจะดำเนินการไม่สำเร็จหากคุณตั้งค่าช่องและไม่ใช่เจ้าของอัลบั้มที่แชร์

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

สร้างรายการสื่อแล้ว

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

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

object (NewMediaItemResult)

เอาต์พุตเท่านั้น สร้างรายการสื่อแล้ว

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

NewMediaItem

รายการสื่อใหม่ที่สร้างขึ้นในบัญชี Google Photos ของผู้ใช้

การแสดง JSON 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
ช่อง
description

string

คำอธิบายรายการสื่อ ซึ่งจะแสดงต่อผู้ใช้ในส่วนข้อมูลของรายการในแอป Google Photos ต้องมีความยาวน้อยกว่า 1,000 อักขระ ใส่เฉพาะข้อความที่ผู้ใช้เขียน คำอธิบายควรเพิ่มบริบทและช่วยให้ผู้ใช้เข้าใจสื่อ อย่าใส่สตริงที่สร้างโดยอัตโนมัติ เช่น ชื่อไฟล์ แท็ก และข้อมูลเมตาอื่นๆ
ช่องการรวม new_media_item_type รายการสื่อใหม่อาจเป็นประเภทต่างๆ ซึ่งขึ้นอยู่กับเส้นทางการอัปโหลด การอัปโหลดที่รองรับในปัจจุบันจะใช้เส้นทางรายการสื่อแบบง่ายเท่านั้น new_media_item_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
simpleMediaItem

object (SimpleMediaItem)

รายการสื่อใหม่ซึ่งอัปโหลดผ่าน uploadToken ที่รวมอยู่

SimpleMediaItem

รายการสื่อง่ายๆ ที่จะสร้างใน Google Photos ผ่านโทเค็นการอัปโหลด

การแสดง JSON 
{
  "uploadToken": string,
  "fileName": string
}
ช่อง
uploadToken

string

โทเค็นที่ระบุไบต์ของสื่อที่อัปโหลดไปยัง Google
fileName

string

ชื่อไฟล์พร้อมนามสกุลของรายการสื่อ ซึ่งจะแสดงต่อผู้ใช้ใน Google Photos ระบบจะไม่สนใจชื่อไฟล์ที่ระบุในกระบวนการอัปโหลดแบบไบต์ หากตั้งค่าช่องนี้ ชื่อไฟล์และนามสกุลไฟล์ไม่ควรยาวเกิน 255 อักขระ ฟิลด์นี้เป็นฟิลด์ที่ไม่บังคับ

NewMediaItemResult

ผลลัพธ์ของการสร้างรายการสื่อใหม่

การแสดง JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
ช่อง
uploadToken

string

โทเค็นการอัปโหลดที่ใช้สร้างรายการสื่อใหม่ (แบบง่าย) นี้ จะมีการป้อนข้อมูลก็ต่อเมื่อรายการสื่อนั้นเรียบง่ายและต้องใช้โทเค็นการอัปโหลดรายการเดียว
status

object (Status)

หากเกิดข้อผิดพลาดระหว่างการสร้างรายการสื่อนี้ ระบบจะป้อนข้อมูลที่เกี่ยวข้องกับข้อผิดพลาดดังกล่าวในช่องนี้ โปรดดูรายละเอียดเกี่ยวกับช่องนี้ที่หัวข้อสถานะ
mediaItem

object (MediaItem)

รายการสื่อที่สร้างด้วยโทเค็นการอัปโหลด ระบบจะป้อนข้อมูลหากไม่เกิดข้อผิดพลาดและสร้างรายการสื่อเรียบร้อยแล้ว