REST Resource: mediaItems

ทรัพยากร: MediaItem

การนําเสนอรายการสื่อ (เช่น รูปภาพหรือวิดีโอ) ใน Google Photos

การแสดง JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
ช่อง
id

string

ตัวระบุสําหรับรายการสื่อ นี่คือตัวระบุถาวรที่ใช้ระหว่างเซสชันเพื่อระบุรายการสื่อนี้ได้
description

string

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

string

URL ของ Google Photos สําหรับรายการสื่อ ลิงก์นี้มีให้บริการแก่ผู้ใช้ที่ลงชื่อเข้าใช้เท่านั้น เมื่อดึงข้อมูลจากการค้นหาอัลบั้ม URL จะชี้ไปยังรายการภายในอัลบั้มนั้น
baseUrl

string

URL ไปยังไบต์ของสื่อ ไม่ควรใช้คําสั่งนี้อย่างที่เป็นอยู่ ควรเพิ่มพารามิเตอร์ต่อท้าย URL นี้ก่อนใช้ ดูรายการพารามิเตอร์ทั้งหมดที่รองรับได้ในเอกสารประกอบสําหรับนักพัฒนาซอฟต์แวร์ เช่น '=w2048-h1024' จะตั้งค่าขนาดรายการสื่อประเภทรูปภาพให้มีความกว้าง 2048 พิกเซลและสูง 1024 พิกเซล
mimeType

string

ประเภท MIME ของรายการสื่อ เช่น image/jpeg
mediaMetadata

object (MediaMetadata)

ข้อมูลเมตาที่เกี่ยวข้องกับรายการสื่อ เช่น ความสูง ความกว้าง หรือเวลาสร้าง
contributorInfo

object (ContributorInfo)

ข้อมูลเกี่ยวกับผู้ใช้ที่เพิ่มสื่อนี้ โปรดทราบว่าวิธีนี้จะรวมอยู่ในการใช้ mediaItems.search ด้วยรหัสของอัลบั้มที่แชร์เท่านั้น แอปต้องสร้างอัลบั้ม และต้องมีขอบเขตการแชร์
filename

string

ชื่อไฟล์ของรายการสื่อ ข้อมูลนี้จะแสดงแก่ผู้ใช้ในส่วนข้อมูลของรายการในแอป Google Photos

ข้อมูลเมตาของสื่อ

ข้อมูลเมตาสําหรับรายการสื่อ

การแสดง JSON 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
ช่อง
creationTime

string (Timestamp format)

เวลาที่สร้างรายการสื่อครั้งแรก (ไม่ใช่เมื่ออัปโหลดไปยัง Google Photos)

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
width

string (int64 format)

ความกว้างเดิม (พิกเซล) ของรายการสื่อ
height

string (int64 format)

ความสูงเดิม (พิกเซล) ของรายการสื่อ
ช่อง Union metadata ข้อมูลเมตาสําหรับรายการสื่อที่ระบุถึงประเภทสื่อที่ระบุไว้โดยเฉพาะ metadata ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
photo

object (Photo)

ข้อมูลเมตาสําหรับประเภทสื่อรูปภาพ
video

object (Video)

ข้อมูลเมตาสําหรับประเภทสื่อวิดีโอ

รูปภาพ

ข้อมูลเมตาที่เกี่ยวข้องกับรูปภาพโดยเฉพาะ เช่น ISO ความยาวโฟกัส และเวลารับแสง โดยบางช่องเหล่านี้อาจเป็นค่าว่างหรือไม่ได้ระบุ

การแสดง JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
ช่อง
cameraMake

string

แบรนด์กล้องที่ถ่าย
cameraModel

string

รุ่นของกล้องที่ถ่าย
focalLength

number

ความยาวโฟกัสของเลนส์กล้องที่ใช้ถ่ายภาพ
apertureFNumber

number

รูรับแสงของเลนส์กล้องที่ใช้ถ่ายภาพ
isoEquivalent

integer

ISO ของกล้องที่ถ่ายภาพ
exposureTime

string (Duration format)

เวลารับแสงของรูรับแสงของกล้องขณะถ่ายภาพ

ระยะเวลาเป็นวินาทีที่มีตัวเลขไม่เกิน 9 หลักที่สิ้นสุดโดย 's' ตัวอย่าง: "3.5s"

วิดีโอ

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

การแสดง JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
ช่อง
cameraMake

string

แบรนด์กล้องที่ใช้ถ่ายวิดีโอ
cameraModel

string

รุ่นของกล้องที่ถ่ายวิดีโอ
fps

number

อัตราเฟรมของวิดีโอ
status

enum (VideoProcessingStatus)

สถานะการประมวลผลของวิดีโอ

สถานะการประมวลผลวิดีโอ

สถานะการประมวลผลของวิดีโอที่อัปโหลดไปยัง Google Photos

Enum
UNSPECIFIED ไม่ทราบสถานะการประมวลผลวิดีโอ
PROCESSING กําลังประมวลผลวิดีโอ ผู้ใช้จะเห็นไอคอนวิดีโอนี้ในแอป Google Photos อย่างไรก็ตาม วิดีโอจะยังเล่นไม่ได้
READY การประมวลผลวิดีโอเสร็จสมบูรณ์และพร้อมให้รับชมแล้ว สําคัญ: การพยายามดาวน์โหลดวิดีโอที่อยู่ในสถานะไม่พร้อมให้บริการอาจล้มเหลว
FAILED เกิดข้อผิดพลาดและระบบประมวลผลวิดีโอไม่สําเร็จ

ข้อมูลผู้ให้ข้อมูลร่วมกัน

ข้อมูลเกี่ยวกับผู้ใช้ที่เพิ่มรายการสื่อ โปรดทราบว่าข้อมูลนี้จะรวมอยู่เฉพาะในกรณีที่รายการสื่ออยู่ในอัลบั้มที่แชร์ที่สร้างโดยแอปของคุณ และคุณมีขอบเขตการแชร์

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

string

URL ไปยังรูปโปรไฟล์ของผู้เขียน
displayName

string

ชื่อที่แสดงของผู้เขียน

เมธอด

batchCreate

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

batchGet

 แสดงผลรายการสื่อสําหรับตัวระบุรายการสื่อที่ระบุ

get

 แสดงผลรายการสื่อสําหรับตัวระบุรายการสื่อที่ระบุ

list

 แสดงรายการสื่อทั้งหมดจากคลังภาพ Google Photos ของผู้ใช้

patch

 อัปเดตรายการสื่อด้วย id ที่ระบุ
ค้นหารายการสื่อในคลังภาพ Google Photos ของผู้ใช้