REST Resource: mediaItems

ทรัพยากร: PickedMediaItem

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

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

string

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

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

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
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

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

object (PhotoMetadata)

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

object (VideoMetadata)

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

PhotoMetadata

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

ระบบอาจไม่ได้ตั้งค่าบางช่องเหล่านี้

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

number

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

number

หมายเลขรูรับแสงของเลนส์กล้องที่ใช้ถ่ายรูป
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

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