Method: mediaItems.batchCreate

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

นี่เป็นขั้นตอนที่ 2 ในการสร้างรายการสื่อ โปรดดูรายละเอียดเกี่ยวกับขั้นตอนที่ 1 โดยการอัปโหลดไบต์ดิบไปยังเซิร์ฟเวอร์ของ 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

สื่อใหม่

รายการสื่อใหม่ที่สร้างในบัญชี 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 ตัว รวมเฉพาะข้อความที่เขียนโดยผู้ใช้ คําอธิบายควรเพิ่มบริบทและช่วยให้ผู้ใช้เข้าใจสื่อ อย่าใส่สตริงที่สร้างขึ้นโดยอัตโนมัติ เช่น ชื่อไฟล์ แท็ก และข้อมูลเมตาอื่นๆ
ช่อง Union new_media_item_type รายการสื่อใหม่อาจมีหลายประเภท โดยขึ้นอยู่กับเส้นทางการอัปโหลด การอัปโหลดที่รองรับในปัจจุบันจะใช้เส้นทางของรายการสื่อแบบง่ายเท่านั้น new_media_item_type ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
simpleMediaItem

object (SimpleMediaItem)

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

รายการสื่อแบบง่าย

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

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

string

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

string

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

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

การสร้างรายการสื่อใหม่

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

string

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

object (Status)

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

object (MediaItem)

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