Tài nguyên: MediaItem
Nội dung đại diện cho 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 cho 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. Người dùng sẽ thấy nội dung này trong phần thông tin của mặt hàng trong ứng dụng Google Photos. Phải ngắn 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 ngữ cảnh và giúp người dùng hiểu nội dung nghe nhìn. Đừng dùng các chuỗi được tạo tự động như tên tệp, thẻ và các siêu dữ liệu khác. |
productUrl |
URL trên Google Photos của mục nội dung đa phương tiện. Người dùng chỉ xem được đường liên kết này khi họ đã đăng nhập. Khi truy xuất từ 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 đa phương tiện. Bạn không nên sử dụng thông số này theo nguyên trạng. Các tham số phải được thêm 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 thông số được hỗ trợ. Ví dụ: |
mimeType |
Loại MIME của mục nội dung đa phương tiệ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 việc này chỉ áp dụng khi sử dụng |
filename |
Tên tệp của mục nội dung đa phương tiệ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 trong ứng dụng Google Photos. |
MediaMetadata
Siêu dữ liệu cho một mục nội dung đa phương tiệ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 mục nội dung đa phương tiện được tạo lần đầu tiên (chứ không phải khi mục đó được tải lên Google Photos). Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 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 hợp metadata . Siêu dữ liệu cho mục nội dung đa phương tiện dành riêng cho loại nội dung đa phương tiệ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: |
|
photo |
Siêu dữ liệu cho loại nội dung nghe nhìn dạng ảnh. |
video |
Siêu dữ liệu cho loại nội dung đa phương tiện của video. |
Ảnh
Siêu dữ liệu dành riêng cho một ả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 mà ảnh được chụp. |
cameraModel |
Kiểu máy ảnh dùng để chụp ảnh. |
focalLength |
Tiêu cự của ống kính máy ảnh dùng để chụp ảnh. |
apertureFNumber |
Khẩu độ f Số ống kính máy ảnh được dùng để chụp ảnh. |
isoEquivalent |
ISO của máy ảnh mà ảnh được chụp. |
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 với 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ư khung hình/giây 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 ảnh mà bạn đã dùng để quay video. |
cameraModel |
Kiểu máy ảnh 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 thấy biểu tượng của video này trong ứng dụng Google Photos; tuy nhiên, video chưa thể phát được. |
READY |
Quá trình xử lý video đã hoàn tất và bạn có thể xem video này. Quan trọng: Cố gắng tải xuống video không ở trạng thái READY 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 nội dung nghe nhìn nằm trong 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 cộng tác viên. |
displayName |
Tên hiển thị của người đóng góp. |
Phương thức |
|
---|---|
|
Tạo một hoặc nhiều mục nội dung nghe nhìn trong thư viện Google Photos của người dùng. |
|
Trả về danh sách các mục nội dung đa phương tiện cho giá trị nhận dạng mục nội dung đa phương tiện đã chỉ định. |
|
Trả về mục nội dung đa phương tiện cho giá trị nhận dạng mục nội dung đa phương tiện đã chỉ định. |
|
Liệt kê tất cả các mục nội dung nghe nhìn trong thư viện Google Photos của người dùng. |
|
Cập nhật mục nội dung đa phương tiện bằng id đã chỉ định. |
|
Tìm kiếm các mục nội dung nghe nhìn trong thư viện Google Photos của người dùng. |