Tài nguyên: MediaItem
Nội dung minh hoạ một mục nội dung đa phương tiệ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 ( |
Trường | |
---|---|
id |
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. |
description |
Nội dung mô tả về mục nội dung đa phương tiệ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 bổ sung bối cảnh và giúp người dùng hiểu được nội dung nghe nhìn. Không bao gồm bất kỳ chuỗi nào được tạo tự động như tên tệp, thẻ và siêu dữ liệu khác. |
productUrl |
URL của Google Photos cho mục nội dung nghe nhìn. Người dùng chỉ truy cập được đường liên kết này khi đã đăng nhập. Khi được truy xuất từ kết quả tìm kiếm album, URL sẽ trỏ đến mục trong album. |
baseUrl |
URL đến các byte của mục nội dung nghe nhìn. Bạn không nên sử dụng nguyên trạng này. Bạn phải nối thông 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ụ: |
mimeType |
Loại MIME của mục nội dung nghe nhìn. Ví dụ: |
mediaMetadata |
Siêu dữ liệu liên quan đến mục nội dung đa phương tiện, chẳng hạn như chiều cao, chiều rộng hoặc thời gian tạo. |
contributorInfo |
Thông tin về người dùng đã thêm mục nội dung đa phương tiện này. Xin lưu ý rằng thông tin này chỉ được đưa vào khi bạn sử dụng |
filename |
Tên tệp của mục nội dung nghe nhìn. Người dùng sẽ thấy thông tin này trong phần thông tin của mặt hàng trên ứ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 |
Trường | |
---|---|
creationTime |
Thời điểm tạo mục nội dung nghe nhìn lần đầu (không phải thời điểm mục đó được tải 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ụ: |
width |
Chiều rộng ban đầu (tính bằng pixel) của mục nội dung đa phương tiện. |
height |
Chiều cao ban đầu (tính bằng pixel) của mục nội dung đa phương tiện. |
Trường kết hợp metadata . Siêu dữ liệu về mục nội dung đa phương tiệ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 trạng thái sau đây: |
|
photo |
Siêu dữ liệu cho loại nội dung nghe nhìn là ảnh. |
video |
Siêu dữ liệu dành cho một loại nội dung nghe nhìn 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ể 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 |
Thương hiệu của máy ảnh dùng để chụp ảnh. |
cameraModel |
Mẫu máy ảnh mà bạn dùng để chụp ảnh. |
focalLength |
Tiêu cự của ống kính camera mà bạn dùng để chụp ảnh. |
apertureFNumber |
Số khẩu độ f của ống kính máy ảnh được chụp ảnh. |
isoEquivalent |
ISO của máy ảnh mà bạn dùng để chụp ảnh. |
exposureTime |
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 " |
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ể 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 ( |
Trường | |
---|---|
cameraMake |
Thương hiệu của máy quay dùng để quay video. |
cameraModel |
Mẫu máy quay dùng để quay video. |
fps |
Tốc độ khung hình của video. |
status |
Trạng thái xử lý của video. |
VideoProcessingStatus
Trạng thái xử lý của video đang được tải lên Google Photos.
Enum | |
---|---|
UNSPECIFIED |
Trạng thái xử lý video không xác định. |
PROCESSING |
Video đang được xử lý. Người dùng sẽ thấy một biểu tượng của video này trong ứng dụng Google Photos; tuy nhiên, bạn chưa thể phát video này. |
READY |
Quá trình xử lý video đã hoàn tất và video hiện có thể xem được. Quan trọng: việc cố gắng tải video không ở trạng thái SẴN SÀNG có thể không thành công. |
FAILED |
Đã xảy ra lỗi nên không xử lý được video. |
ContributorInfo
Thông tin về người dùng đã thêm mục nội dung đa phương tiệ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 |
URL đến ảnh hồ sơ của người đóng góp. |
displayName |
Tên hiển thị của người đóng góp. |
Phương thức |
|
---|---|
|
|
|
|
|
|
|
|
|
Cập nhật mục nội dung đa phương tiện bằng id được chỉ định. |
|