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 รายการสื่อต่อการโทร 1 ครั้ง
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)

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