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 Photos ต้องมีความยาวน้อยกว่า 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 และสถานะการประมวลผล ฟิลด์บางฟิลด์อาจเป็นค่าว่างหรือไม่รวมอยู่ในฟิลด์

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

batchGet

get

list

patch

 อัปเดตรายการสื่อด้วย id ที่ระบุ