Method: mediaItems.batchCreate

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 (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Trường
albumId

string

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[]

object (NewMediaItem)

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

object (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à LAST_IN_ALBUM). Yêu cầu sẽ không thành công nếu bạn đặt trường này và không chỉ định albumId. Yêu cầu cũng sẽ không thành công nếu bạn đặt trường này và không phải là chủ sở hữu của album chia sẻ.

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 (NewMediaItemResult)
    }
  ]
}
Trường
newMediaItemResults[]

object (NewMediaItemResult)

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 new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Trường
description

string

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

object (SimpleMediaItem)

Một mục nội dung đa phương tiện mới đã được tải lên thông qua uploadToken đi kèm.

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

string

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

string

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 (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Trường
uploadToken

string

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

object (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

object (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.