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 รูปภาพ

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)

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