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,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
ช่อง
baseUrl

string

URL ไปยังไบต์ของไฟล์สื่อ

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

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

string

ประเภท MIME ของไฟล์สื่อ เช่น image/jpeg
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,
  "printMetadata": {
    object (PrintMetadata)
  }
}
ช่อง
focalLength

number

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

number

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

integer

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

string (Duration format)

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

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

object (PrintMetadata)

ข้อมูลเมตาที่เกี่ยวข้องกับการพิมพ์รูปภาพ

PrintMetadata

ข้อมูลเมตาที่อธิบายคุณสมบัติที่เกี่ยวข้องกับการพิมพ์ของรูปภาพ เช่น คะแนนคุณภาพการพิมพ์

การแสดง JSON 
{
  "qualityScore": enum (Score)
}
ช่อง
qualityScore

enum (Score)

คะแนนคุณภาพในการพิมพ์ของรูปภาพ ซึ่งจะกำหนดว่ารูปภาพดังกล่าวเหมาะสำหรับการพิมพ์หรือไม่

ไม่ควรใช้คะแนนนี้เพื่อแนะนำผู้ใช้เกี่ยวกับการพิมพ์ ระบบจะตั้งค่าคะแนนเป็น HIGH หากรูปภาพมีคุณภาพสูงและผู้ใช้อาจต้องการพิมพ์รูปภาพดังกล่าว คะแนน NORMAL หมายความว่ารูปภาพอาจมีคุณภาพสูง SCORE_UNSPECIFIED หมายความว่าไม่มีคะแนน

คะแนน

คะแนนที่อธิบายความเหมาะสมในการพิมพ์รูปภาพ

Enum
SCORE_UNSPECIFIED ไม่มีการระบุคะแนนโดยค่าเริ่มต้น
HIGH รูปภาพนี้มีคะแนนสูงสุด
NORMAL รูปภาพมีคะแนนปกติ

VideoMetadata

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

การแสดง JSON 
{
  "fps": number
}
ช่อง
fps

number

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

เมธอด

list

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