REST Resource: mediaItems

Tài nguyên: PickedMediaItem

Ảnh hoặc video do 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 nghe nhì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 nghe nhìn này.
createTime

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
type

enum (Type)

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

object (MediaFile)

Tệp nội dung nghe nhìn tạo nên 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 Bạn chưa chỉ định loại.
PHOTO Mục nội dung nghe nhìn này đại diện cho một bức ảnh.
VIDEO Mục nội dung nghe nhìn này đại diện cho một video.

MediaFile

Biểu thị một tệp nội dung nghe nhìn.

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

string

URL để tìm nạp các byte của tệp nội dung nghe nhì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ột mục nội dung nghe nhìn thuộc loại ảnh có 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.
filename

string

Tên tệp của tệp nội dung nghe nhìn.
mediaFileMetadata

object (MediaFileMetadata)

Siêu dữ liệu liên quan đến tệp nội dung nghe nhìn, chẳng hạn như chiều cao và chiều rộng.

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 camera dùng để quay/chụp nội dung nghe nhìn.
cameraModel

string

Mẫu máy ảnh dùng để quay/chụp nội dung nghe nhìn.
Trường nhóm metadata. Siêu dữ liệu cho tệp nội dung nghe nhìn, cụ thể là loại nội dung nghe nhìn của tệp. metadata chỉ có thể là một trong những trạng thái sau:
photoMetadata

object (PhotoMetadata)

Siêu dữ liệu cho loại phương tiện ảnh.
videoMetadata

object (VideoMetadata)

Siêu dữ liệu cho 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.

Bạn có thể không đặt một số trường trong số này.

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

number

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

number

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

integer

ISO của camera dùng để chụp ảnh.
exposureTime

string (Duration format)

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

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

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,
  "processingStatus": enum (VideoProcessingStatus)
}
Trường
fps

number

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

enum (VideoProcessingStatus)

Trạng thái xử lý của video.

VideoProcessingStatus

Trạng thái xử lý của một video được lưu trữ trong Google Photos.

Enum
UNSPECIFIED Bạn chưa chỉ định trạng thái xử lý video.
PROCESSING

Video đang được xử lý.

Người dùng sẽ thấy biểu tượng của video này trong ứng dụng Google Photos; tuy nhiên, video này chưa phát được.
READY

Video đã được xử lý xong và giờ bạn có thể xem video này.

Bạn có thể không tải được video xuống nếu video đó không ở trạng thái READY.
FAILED Đã xảy ra lỗi nên video không xử lý được.

Phương thức

list

 Trả về danh sách các mục nội dung nghe nhìn mà người dùng đã chọn trong phiên được chỉ định.