- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Hãy làm thử!
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.
Đây là bước thứ hai để tạo mục nội dung đa phương tiện. Để biết chi tiết về Bước 1, tải byte thô lên Máy chủ của Google, hãy xem bài viết Tải nội dung nghe nhìn lên.
Lệnh gọi này sẽ thêm mục nội dung nghe nhìn vào thư viện. Nếu album id
được chỉ định, lệnh gọi cũng sẽ thêm mục nội dung đa phương tiện vào album đó. Mỗi album có thể chứa tối đa 20.000 mục nội dung nghe nhìn. Theo mặc định, mục nội dung đa phương tiện sẽ được thêm vào cuối thư viện hoặc album.
Nếu cả id
và vị trí của album đều được xác định, thì mục nội dung đa phương tiện sẽ được thêm vào album ở vị trí đã chỉ định.
Nếu cuộc gọi chứa nhiều mục nội dung nghe nhìn, thì các mục đó sẽ được thêm vào vị trí chỉ định. Nếu đang tạo một mục nội dung nghe nhìn trong một album chia sẻ mà bạn không phải là chủ sở hữu, thì bạn không được phép định vị mục đó. Làm như vậy sẽ dẫn đến lỗi BAD REQUEST
.
Yêu cầu HTTP
POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "albumId": string, "newMediaItems": [ { object ( |
Trường | |
---|---|
albumId |
Giá trị nhận dạng của album đã thêm các mục nội dung đa phương tiện. Các mục nội dung đa phương tiện cũng được thêm vào thư viện của người dùng. Đây là trường không bắt buộc. |
newMediaItems[] |
Bắt buộc. Danh sách các mục nội dung nghe nhìn sẽ được tạo. Tối đa 50 mục nội dung nghe nhìn trong mỗi cuộc gọi. |
albumPosition |
Vị trí trong album mà các mục nội dung nghe nhìn được thêm vào. Nếu không được chỉ định, các mục nội dung đa phương tiện sẽ được thêm vào cuối album (theo giá trị mặc định, tức là |
Nội dung phản hồi
Đã tạo danh sách mục nội dung nghe nhìn.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"newMediaItemResults": [
{
object ( |
Trường | |
---|---|
newMediaItemResults[] |
Chỉ có đầu ra. Đã tạo danh sách mục nội dung nghe nhìn. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing
NewMediaItem
Mục nội dung nghe nhìn mới được tạo trong tài khoản Google Photos của người dùng.
Biểu diễn dưới dạng JSON |
---|
{ "description": string, // Union field |
Trường | |
---|---|
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. |
Trường hợp new_media_item_type . Mục nội dung đa phương tiện mới có thể có nhiều loại và tuỳ thuộc vào đường dẫn tải lên. Các tệp tải lên hiện được hỗ trợ chỉ sử dụng đường dẫn mục nội dung đa phương tiện đơn giản. new_media_item_type chỉ có thể là một trong những trạng thái sau: |
|
simpleMediaItem |
Một mục nội dung đa phương tiện mới đã được tải lên thông qua |
SimpleMediaItem
Một mục nội dung nghe nhìn đơn giản sẽ được tạo trong Google Photos thông qua mã thông báo tải lên.
Biểu diễn dưới dạng JSON |
---|
{ "uploadToken": string, "fileName": string } |
Trường | |
---|---|
uploadToken |
Mã thông báo xác định các byte nội dung đa phương tiện đã được tải lên Google. |
fileName |
Tên tệp có phần mở rộng 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 Google Photos. Tên tệp được chỉ định trong quá trình tải lên byte sẽ bị bỏ qua nếu bạn đặt trường này. Tên tệp (bao gồm cả đuôi tệp) không được dài quá 255 ký tự. Đây là trường không bắt buộc. |
NewMediaItemResult
Kết quả tạo một mục nội dung nghe nhìn mới.
Biểu diễn dưới dạng JSON |
---|
{ "uploadToken": string, "status": { object ( |
Trường | |
---|---|
uploadToken |
Mã thông báo tải lên được dùng để tạo mục nội dung nghe nhìn mới (đơn giản) này. Chỉ được điền nếu mục nội dung đa phương tiện đơn giản và cần có một mã tải lên duy nhất. |
status |
Nếu xảy ra lỗi trong quá trình tạo mục nội dung đa phương tiện này, thì trường này sẽ được điền sẵn thông tin liên quan đến lỗi. Để biết thông tin chi tiết về trường này, hãy xem phần Trạng thái. |
mediaItem |
Mục nội dung đa phương tiện đã được tạo bằng mã tải lên. Trường này được điền sẵn nếu không xảy ra lỗi và mục nội dung đa phương tiện đã được tạo thành công. |