- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- ลองใช้งาน
สร้างรายการสื่ออย่างน้อย 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 ( |
ช่อง | |
---|---|
albumId |
ตัวระบุของอัลบั้มที่มีการเพิ่มรายการสื่อ และระบบจะเพิ่มรายการสื่อไปยังไลบรารีของผู้ใช้ด้วย ช่องนี้เป็นช่องที่ไม่บังคับ |
newMediaItems[] |
ต้องระบุ รายการสื่อที่จะสร้าง สูงสุด 50 รายการสื่อต่อการโทร 1 ครั้ง |
albumPosition |
ตำแหน่งในอัลบั้มที่มีการเพิ่มรายการสื่อ หากไม่ระบุ ระบบจะเพิ่มรายการสื่อต่อท้ายอัลบั้ม (ตามค่าเริ่มต้นคือ |
เนื้อหาการตอบกลับ
สร้างรายการสื่อแล้ว
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"newMediaItemResults": [
{
object ( |
ช่อง | |
---|---|
newMediaItemResults[] |
เอาต์พุตเท่านั้น สร้างรายการสื่อแล้ว |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต 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 |
ช่อง | |
---|---|
description |
คำอธิบายของรายการสื่อ รายการนี้จะแสดงต่อผู้ใช้ในส่วนข้อมูลของรายการในแอป Google Photos และต้องมีความยาวน้อยกว่า 1,000 อักขระ รวมเฉพาะข้อความที่เขียนโดยผู้ใช้ คำอธิบายควรให้บริบทและช่วยให้ผู้ใช้เข้าใจสื่อ อย่ารวมสตริงที่สร้างขึ้นโดยอัตโนมัติ เช่น ชื่อไฟล์ แท็ก และข้อมูลเมตาอื่นๆ |
ฟิลด์สหภาพ new_media_item_type รายการสื่อใหม่อาจเป็นได้หลายประเภท โดยขึ้นอยู่กับเส้นทางการอัปโหลด การอัปโหลดที่รองรับในปัจจุบันจะใช้เส้นทางรายการสื่อแบบง่ายเท่านั้น new_media_item_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
simpleMediaItem |
รายการสื่อใหม่ที่อัปโหลดผ่าน |
SimpleMediaItem
รายการสื่อง่ายๆ ที่จะสร้างขึ้นใน Google Photos ผ่านโทเค็นการอัปโหลด
การแสดง JSON |
---|
{ "uploadToken": string, "fileName": string } |
ช่อง | |
---|---|
uploadToken |
โทเค็นที่ระบุไบต์ของสื่อที่อัปโหลดไปยัง Google แล้ว |
fileName |
ชื่อไฟล์ที่มีนามสกุลของรายการสื่อ ซึ่งแสดงต่อผู้ใช้ใน Google Photos ระบบจะไม่สนใจชื่อไฟล์ที่ระบุในกระบวนการอัปโหลดไบต์หากมีการตั้งค่าช่องนี้ ชื่อไฟล์รวมถึงนามสกุลไฟล์ควรมีความยาวไม่เกิน 255 อักขระ ช่องนี้เป็นช่องที่ไม่บังคับ |
NewMediaItemResult
ผลของการสร้างรายการสื่อใหม่
การแสดง JSON |
---|
{ "uploadToken": string, "status": { object ( |
ช่อง | |
---|---|
uploadToken |
โทเค็นการอัปโหลดที่ใช้สร้างรายการสื่อใหม่ (แบบง่าย) ระบบจะป้อนข้อมูลเฉพาะในกรณีที่รายการสื่อมีความเรียบง่ายและต้องใช้โทเค็นการอัปโหลดรายการเดียวเท่านั้น |
status |
หากเกิดข้อผิดพลาดระหว่างการสร้างรายการสื่อนี้ ช่องนี้จะมีการเติมข้อมูลที่เกี่ยวข้องกับข้อผิดพลาดนั้น ดูรายละเอียดเกี่ยวกับช่องนี้ได้ที่สถานะ |
mediaItem |
รายการสื่อที่สร้างด้วยโทเค็นการอัปโหลด ระบบจะป้อนข้อมูลให้โดยอัตโนมัติหากไม่มีข้อผิดพลาดเกิดขึ้นและสร้างรายการสื่อสําเร็จ |