Method: mediaItems.batchCreate

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

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

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

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

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

คำขอ 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.appendonly

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 รูปภาพ โดยต้องมีความยาวไม่เกิน 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)

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