ทรัพยากร: MediaItem
การนำเสนอรายการสื่อ (เช่น รูปภาพหรือวิดีโอ) ใน Google Photos
การแสดง JSON |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
ช่อง | |
---|---|
id |
ตัวระบุสำหรับรายการสื่อ นี่คือตัวระบุถาวรที่ใช้ระหว่างเซสชันเพื่อระบุรายการสื่อนี้ได้ |
description |
คำอธิบายของรายการสื่อ รายการนี้จะแสดงต่อผู้ใช้ในส่วนข้อมูลของรายการในแอป Google Photos และต้องมีความยาวน้อยกว่า 1,000 อักขระ รวมเฉพาะข้อความที่เขียนโดยผู้ใช้ คำอธิบายควรให้บริบทและช่วยให้ผู้ใช้เข้าใจสื่อ อย่ารวมสตริงที่สร้างขึ้นโดยอัตโนมัติ เช่น ชื่อไฟล์ แท็ก และข้อมูลเมตาอื่นๆ |
productUrl |
URL ของ Google Photos สำหรับรายการสื่อ ลิงก์นี้จะพร้อมใช้งานสำหรับผู้ใช้เมื่อลงชื่อเข้าใช้เท่านั้น เมื่อดึงข้อมูลจากการค้นหาอัลบั้ม URL จะชี้ไปยังรายการภายในอัลบั้ม |
baseUrl |
URL ไปยังไบต์ของรายการสื่อ ไม่ควรใช้ตามที่เป็นอยู่ ควรใส่พารามิเตอร์ต่อท้าย URL นี้ก่อนใช้งาน ดูรายการพารามิเตอร์ทั้งหมดที่รองรับได้ในเอกสารสำหรับนักพัฒนาซอฟต์แวร์ เช่น |
mimeType |
ประเภท MIME ของรายการสื่อ เช่น |
mediaMetadata |
ข้อมูลเมตาที่เกี่ยวข้องกับรายการสื่อ เช่น ความสูง ความกว้าง หรือเวลาที่สร้าง |
contributorInfo |
ข้อมูลเกี่ยวกับผู้ใช้ที่เพิ่มรายการสื่อนี้ โปรดทราบว่าข้อมูลนี้จะรวมอยู่ในเมื่อใช้ |
filename |
ชื่อไฟล์ของรายการสื่อ ตัวเลือกนี้จะแสดงต่อผู้ใช้ในส่วนข้อมูลของรายการในแอป Google Photos |
MediaMetadata
ข้อมูลเมตาสำหรับรายการสื่อ
การแสดง JSON |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
ช่อง | |
---|---|
creationTime |
เวลาที่สร้างรายการสื่อครั้งแรก (ไม่ใช่เวลาที่อัปโหลดไฟล์ไปยัง Google Photos) การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
width |
ความกว้างเดิม (เป็นพิกเซล) ของรายการสื่อ |
height |
ความสูงเดิม (เป็นพิกเซล) ของรายการสื่อ |
ฟิลด์สหภาพ metadata ข้อมูลเมตาสำหรับรายการสื่อเฉพาะสำหรับประเภทสื่อที่สื่อดังกล่าวเป็นตัวแทน metadata ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
photo |
ข้อมูลเมตาสำหรับประเภทสื่อรูปภาพ |
video |
ข้อมูลเมตาสำหรับประเภทสื่อวิดีโอ |
รูปภาพ
ข้อมูลเมตาที่ใช้กับรูปภาพโดยเฉพาะ เช่น ISO, ความยาวโฟกัส และเวลาเปิดรับแสง บางช่องอาจเป็น Null หรือไม่รวม
การแสดง JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
ช่อง | |
---|---|
cameraMake |
แบรนด์ของกล้องที่ใช้ถ่ายภาพ |
cameraModel |
รุ่นของกล้องที่ใช้ถ่ายภาพ |
focalLength |
ความยาวโฟกัสของเลนส์กล้องที่ใช้ถ่ายภาพ |
apertureFNumber |
หมายเลขรูรับแสง f ของเลนส์กล้องที่ใช้ถ่ายภาพ |
isoEquivalent |
ISO ของกล้องที่ใช้ถ่ายภาพนั้น |
exposureTime |
เวลาเปิดรับแสงของรูรับแสงกล้องเมื่อถ่ายภาพ ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
วิดีโอ
ข้อมูลเมตาที่เฉพาะเจาะจงสำหรับวิดีโอ เช่น FPS และสถานะการประมวลผล บางช่องอาจเป็น Null หรือไม่รวม
การแสดง JSON |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
ช่อง | |
---|---|
cameraMake |
แบรนด์ของกล้องที่ใช้ถ่ายวิดีโอ |
cameraModel |
รุ่นของกล้องที่ใช้ถ่ายวิดีโอ |
fps |
อัตราเฟรมของวิดีโอ |
status |
สถานะการประมวลผลของวิดีโอ |
VideoProcessingStatus
สถานะการประมวลผลของวิดีโอกําลังอัปโหลดไปยัง Google Photos
Enum | |
---|---|
UNSPECIFIED |
ไม่ทราบสถานะการประมวลผลวิดีโอ |
PROCESSING |
กำลังประมวลผลวิดีโอ ผู้ใช้เห็นไอคอนสำหรับวิดีโอนี้ในแอป Google Photos แต่ยังไม่สามารถเล่นได้ |
READY |
การประมวลผลวิดีโอเสร็จสมบูรณ์และพร้อมให้รับชมแล้ว สำคัญ: การพยายามดาวน์โหลดวิดีโอที่ไม่อยู่ในสถานะ "พร้อม" อาจล้มเหลว |
FAILED |
เกิดข้อผิดพลาดและประมวลผลวิดีโอไม่สำเร็จ |
ContributorInfo
ข้อมูลเกี่ยวกับผู้ใช้ที่เพิ่มรายการสื่อ โปรดทราบว่าข้อมูลนี้จะรวมไว้ก็ต่อเมื่อรายการสื่ออยู่ในอัลบั้มที่แชร์ที่แอปของคุณสร้างขึ้นและคุณมีขอบเขตการแชร์
การแสดง JSON |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
ช่อง | |
---|---|
profilePictureBaseUrl |
URL ไปยังรูปโปรไฟล์ของผู้มีส่วนร่วม |
displayName |
ชื่อที่แสดงของผู้ร่วมให้ข้อมูล |
วิธีการ |
|
---|---|
|
สร้างรายการสื่ออย่างน้อย 1 รายการในคลังภาพ Google Photos ของผู้ใช้ |
|
แสดงรายการสื่อสำหรับตัวระบุรายการสื่อที่ระบุ |
|
แสดงรายการสื่อสำหรับตัวระบุรายการสื่อที่ระบุ |
|
แสดงรายการสื่อทั้งหมดจากคลังภาพ Google Photos ของผู้ใช้ |
|
อัปเดตรายการสื่อด้วย id ที่ระบุ |
|
ค้นหารายการสื่อในคลังภาพ Google Photos ของผู้ใช้ |