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 รูปภาพ โดยต้องมีความยาวไม่เกิน 1,000 อักขระ ใส่เฉพาะข้อความที่ผู้ใช้เขียน คำอธิบายควรเพิ่มบริบทและช่วยให้ผู้ใช้เข้าใจสื่อ อย่าใส่สตริงที่สร้างโดยอัตโนมัติ เช่น ชื่อไฟล์ แท็ก และข้อมูลเมตาอื่นๆ
productUrl

string

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

string

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

string

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

object (MediaMetadata)

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

object (ContributorInfo)

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

string

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

MediaMetadata

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

การแสดง 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)

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

object (Photo)

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

object (Video)

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

รูปภาพ

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

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

string

แบรนด์ของกล้องที่ใช้ถ่ายภาพ
cameraModel

string

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

number

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

number

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

integer

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

string (Duration format)

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

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

วิดีโอ

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

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

string

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

string

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

number

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

enum (VideoProcessingStatus)

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

VideoProcessingStatus

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

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

ContributorInfo

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

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

string

URL ไปยังรูปโปรไฟล์ของผู้มีส่วนร่วม
displayName

string

ชื่อที่แสดงของผู้ร่วมให้ข้อมูล

เมธอด

batchCreate

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

batchGet

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

get

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

list

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

patch

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