REST Resource: mediaItems

Tài nguyên: MediaItem

Hình ảnh đại diện cho một mục nội dung nghe nhìn (chẳng hạn như ảnh hoặc video) trong Google Photos.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Trường
id

string

Giá trị nhận dạng cho mục nội dung nghe nhìn. Đây là giá trị nhận dạng cố định có thể được dùng giữa các phiên để xác định mục nội dung nghe nhìn này.
description

string

Nội dung mô tả về mục nội dung nghe nhìn. Thông tin này sẽ hiển thị cho người dùng trong phần thông tin của mục trong ứng dụng Google Photos. Phải có ít hơn 1.000 ký tự. Chỉ bao gồm văn bản do người dùng viết. Nội dung mô tả phải cung cấp bối cảnh và giúp người dùng hiểu nội dung nghe nhìn. Không đưa bất kỳ chuỗi nào được tạo tự động vào, chẳng hạn như tên tệp, thẻ và siêu dữ liệu khác.
productUrl

string

URL của Google Photos cho mục nội dung nghe nhìn. Người dùng chỉ có thể truy cập vào đường liên kết này nếu họ đã đăng nhập. Khi được truy xuất từ một lượt tìm kiếm album, URL sẽ trỏ đến mục bên trong album.
baseUrl

string

URL đến các byte của mục nội dung nghe nhìn. Bạn không nên sử dụng URL này nguyên trạng. Bạn nên thêm các tham số vào URL này trước khi sử dụng. Hãy xem tài liệu dành cho nhà phát triển để biết danh sách đầy đủ các tham số được hỗ trợ. 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 mục nội dung nghe nhìn. Ví dụ: image/jpeg.
mediaMetadata

object (MediaMetadata)

Siêu dữ liệu liên quan đến mục nội dung nghe nhìn, chẳng hạn như chiều cao, chiều rộng hoặc thời gian tạo.
contributorInfo

object (ContributorInfo)

Thông tin về người dùng đã thêm mục nội dung nghe nhìn này. Xin lưu ý rằng thông tin này chỉ được đưa vào khi bạn sử dụng mediaItems.search với mã nhận dạng của một album được chia sẻ. Ứng dụng của bạn phải tạo album và bạn phải có phạm vi chia sẻ.
filename

string

Tên tệp của mục nội dung nghe nhìn. Thông tin này sẽ hiển thị cho người dùng trong phần thông tin của mục trong ứng dụng Google Photos.

MediaMetadata

Siêu dữ liệu cho một mục nội dung nghe nhìn.

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

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời 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".
width

string (int64 format)

Chiều rộng ban đầu (tính bằng pixel) của mục nội dung nghe nhìn.
height

string (int64 format)

Chiều cao ban đầu (tính bằng pixel) của mục nội dung nghe nhìn.
Trường hợp hợp nhất metadata. Siêu dữ liệu cho mục nội dung nghe nhìn dành riêng cho loại nội dung nghe nhìn cơ bản mà mục đó đại diện. metadata chỉ có thể là một trong những loại sau:
photo

object (Photo)

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

object (Video)

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

Ảnh

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ể có giá trị rỗng hoặc không được đưa vào.

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

string

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

string

Mẫu máy ảnh dùng để chụp ảnh.
focalLength

number

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

number

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

integer

ISO của máy ảnh 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, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

Video

Siêu dữ liệu dành riêng cho một video, chẳng hạn như tốc độ khung hình và trạng thái xử lý. Một số trường trong số này có thể có giá trị rỗng hoặc không được đưa vào.

Biểu diễn dưới dạng JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Trường
cameraMake

string

Thương hiệu của máy ảnh dùng để quay video.
cameraModel

string

Mẫu máy ảnh dùng để quay video.
fps

number

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

enum (VideoProcessingStatus)

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

VideoProcessingStatus

Trạng thái xử lý của một video đang được tải lên Google Photos.

Enum
UNSPECIFIED Không xác định được 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, họ chưa thể phát video.
READY Video đã được xử lý xong và bạn có thể xem. Quan trọng: Bạn có thể không tải được video không ở trạng thái SẴN.
FAILED Đã xảy ra lỗi nên không thể xử lý video.

ContributorInfo

Thông tin về người dùng đã thêm mục nội dung nghe nhìn. Xin lưu ý rằng thông tin này chỉ được đưa vào nếu mục nội dung nghe nhìn nằm trong một album chia sẻ do ứng dụng của bạn tạo và bạn có phạm vi chia sẻ.

Biểu diễn dưới dạng JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Trường
profilePictureBaseUrl

string

URL đến ảnh hồ sơ của người đóng góp.
displayName

string

Tên hiển thị của cộng tác viên.

Phương thức

batchCreate

batchGet

get

list

patch

 Cập nhật mục nội dung đa phương tiện bằng id đã chỉ định.