REST Resource: mediaItems

แหล่งข้อมูล: PickedMediaItem

การนําเสนอรูปภาพหรือวิดีโอที่ผู้ใช้เลือก

การแสดง JSON 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
ช่อง
id

string

ตัวระบุสำหรับรายการสื่อ

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

string (Timestamp format)

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

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

enum (Type)

ประเภทของรายการสื่อนี้
mediaFile

object (MediaFile)

ไฟล์สื่อที่ประกอบขึ้นเป็นรายการสื่อนี้

ประเภท

ประเภทของรายการสื่อ

Enum
TYPE_UNSPECIFIED ไม่ได้ระบุประเภท
PHOTO รายการสื่อแสดงถึงรูปภาพ
VIDEO รายการสื่อแสดงถึงวิดีโอ

MediaFile

การนำเสนอไฟล์สื่อ

การแสดง JSON 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
ช่อง
baseUrl

string

URL สำหรับดึงข้อมูลไบต์ของไฟล์สื่อ

หากต้องการดาวน์โหลดไฟล์สื่อ ไคลเอ็นต์ API ต้องเพิ่มพารามิเตอร์ ที่ระบุในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ลงใน URL นี้

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

string

ประเภท MIME ของไฟล์สื่อ เช่น image/jpeg
filename

string

ชื่อไฟล์ของไฟล์สื่อ
mediaFileMetadata

object (MediaFileMetadata)

ข้อมูลเมตาที่เกี่ยวข้องกับไฟล์สื่อ เช่น ความสูงและความกว้าง

MediaFileMetadata

ข้อมูลเมตาเกี่ยวกับไฟล์สื่อ

การแสดง JSON 
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
ช่อง
width

integer

ความกว้างเดิม (เป็นพิกเซล) ของไฟล์สื่อ
height

integer

ความสูงเดิม (เป็นพิกเซล) ของไฟล์สื่อ
cameraMake

string

แบรนด์ของกล้องที่บันทึกสื่อ
cameraModel

string

รุ่นของกล้องที่ใช้บันทึกสื่อ
ฟิลด์สหภาพ metadata ข้อมูลเมตาสำหรับไฟล์สื่อที่เจาะจงตามประเภทสื่อ metadata ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
photoMetadata

object (PhotoMetadata)

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

object (VideoMetadata)

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

PhotoMetadata

ข้อมูลเมตาเฉพาะของรูปภาพ เช่น ISO, ระยะโฟกัส และเวลาในการรับแสง

ระบบอาจไม่ได้ตั้งค่าบางช่อง

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

number

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

number

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

integer

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

string (Duration format)

ระยะเวลาการเปิดรับแสงของรูรับแสงของกล้องเมื่อถ่ายภาพ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

VideoMetadata

ข้อมูลเมตาเฉพาะสำหรับวิดีโอ เช่น fps

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

number

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

enum (VideoProcessingStatus)

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

VideoProcessingStatus

สถานะการประมวลผลของวิดีโอที่จัดเก็บไว้ใน Google Photos

Enum
UNSPECIFIED ไม่ได้ระบุสถานะการประมวลผลวิดีโอ
PROCESSING

กำลังประมวลผลวิดีโอ

ผู้ใช้จะเห็นไอคอนของวิดีโอนี้ในแอป Google Photos แต่ยังไม่เล่นได้
READY

การประมวลผลวิดีโอเสร็จสมบูรณ์แล้ว และวิดีโอนี้พร้อมให้รับชมแล้ว

การพยายามดาวน์โหลดวิดีโอที่ไม่ได้อยู่ในสถานะ READY อาจไม่สำเร็จ
FAILED เกิดข้อผิดพลาดและระบบประมวลผลวิดีโอไม่สำเร็จ

เมธอด

list

 แสดงรายการรายการสื่อที่ผู้ใช้เลือกระหว่างเซสชันที่ระบุ