REST Resource: mediaItems

Tài nguyên: PickedMediaItem

Nội dung đại diện cho một bức ảnh hoặc video do một người dùng chọn.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Trường
id

string

Giá trị nhận dạng của mục nội dung đa phương tiện.

Đây là giá trị nhận dạng cố định có thể dùng giữa các phiên để xác định mục nội dung đa phương tiện này.
createTime

string (Timestamp format)

Thời điểm tạo mục nội dung nghe nhìn (không phải thời điểm tải mục đó lên Google Photos).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
type

enum (Type)

Loại của mục nội dung đa phương tiện này.
mediaFile

object (MediaFile)

Tệp nội dung nghe nhìn cấu thành mục nội dung nghe nhìn này.

Loại

Loại mục nội dung nghe nhìn.

Enum
TYPE_UNSPECIFIED Loại này không được chỉ định theo mặc định.
PHOTO Mục nội dung đa phương tiện đại diện cho một hình ảnh tĩnh.
VIDEO Mục nội dung đa phương tiện đại diện cho một video.

MediaFile

Giá trị đại diện của một tệp riêng lẻ gồm các byte nội dung đa phương tiện.

Biểu diễn dưới dạng JSON 
{
  "baseUrl": string,
  "mimeType": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Trường
baseUrl

string

URL tới byte của tệp đa phương tiện.

Để tải một tệp đa phương tiện xuống, ứng dụng API phải thêm các tham số được chỉ định trong tài liệu dành cho nhà phát triển vào URL này.

Ví dụ: '=w2048-h1024' sẽ đặt kích thước của mục nội dung đa phương tiện thuộc loại ảnh thành chiều rộng là 2048 px và chiều cao là 1024 px.
mimeType

string

Loại MIME của tệp nội dung nghe nhìn. Ví dụ: image/jpeg.
mediaFileMetadata

object (MediaFileMetadata)

Siêu dữ liệu liên quan đến tệp đa phương tiện, chẳng hạn như chiều cao, chiều rộng hoặc thời gian tạo.

MediaFileMetadata

Siêu dữ liệu về một tệp đa phương tiện.

Biểu diễn dưới dạng 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.
}
Trường
width

integer

Chiều rộng ban đầu (tính bằng pixel) của tệp đa phương tiện.
height

integer

Chiều cao ban đầu (tính bằng pixel) của tệp đa phương tiện.
cameraMake

string

Thương hiệu của máy ảnh được dùng để chụp ảnh.
cameraModel

string

Mẫu máy ảnh mà bạn dùng để chụp ảnh.
Trường kết hợp metadata. Siêu dữ liệu về tệp đa phương tiện dành riêng cho loại phương tiện cơ bản mà nó đại diện. metadata chỉ có thể là một trong những trạng thái sau đây:
photoMetadata

object (PhotoMetadata)

Siêu dữ liệu dành cho một loại nội dung nghe nhìn là ảnh.
videoMetadata

object (VideoMetadata)

Siêu dữ liệu dành cho một loại nội dung nghe nhìn video.

PhotoMetadata

Siêu dữ liệu dành riêng cho một bức ảnh, chẳng hạn như ISO, tiêu cự và thời gian phơi sáng. Một số trường trong số này có thể rỗng hoặc không được đưa vào.

Biểu diễn dưới dạng JSON 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
Trường
focalLength

number

Tiêu cự của ống kính máy ảnh dùng để chụp ảnh.
apertureFNumber

number

Số khẩu độ f của ống kính máy ảnh được chụp ảnh.
isoEquivalent

integer

ISO của máy ảnh mà bạn dùng để chụp ảnh.
exposureTime

string (Duration format)

Thời gian phơi sáng của khẩu độ máy ảnh khi chụp ảnh.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".
printMetadata

object (PrintMetadata)

Siêu dữ liệu liên quan đến việc in ảnh.

PrintMetadata

Siêu dữ liệu mô tả các đặc điểm liên quan đến việc in ảnh, ví dụ như điểm chất lượng in.

Biểu diễn dưới dạng JSON 
{
  "qualityScore": enum (Score)
}
Trường
qualityScore

enum (Score)

Điểm chất lượng in của ảnh. Điểm số này xác định xem ảnh đó có phù hợp để in hay không.

Bạn không nên dùng điểm số này để cảnh báo người dùng không in nữa. Điểm số sẽ được đặt thành HIGH nếu ảnh có chất lượng cao và người dùng có thể muốn in ảnh đó. Điểm NORMAL cho biết rằng ảnh có thể không có chất lượng cao. SCORE_UNSPECIFIED cho biết không có điểm số nào.

Điểm số

Điểm số mô tả mức độ phù hợp để in một bức ảnh.

Enum
SCORE_UNSPECIFIED Điểm số không được chỉ định theo mặc định.
HIGH Ảnh này đạt điểm cao.
NORMAL Ảnh này có điểm số bình thường.

VideoMetadata

Siêu dữ liệu dành riêng cho một video, ví dụ: fps.

Biểu diễn dưới dạng JSON 
{
  "fps": number
}
Trường
fps

number

Tốc độ khung hình của video.

Phương thức

list

 Trả về danh sách các mục nội dung đa phương tiện do người dùng chọn trong phiên được chỉ định.