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ột mục nội dung nghe nhìn. Để biết thông tin chi tiết về Bước 1, hãy tải các byte thô lên Máy chủ 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, cuộc gọi cũng sẽ thêm mục nội dung nghe nhì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 nghe nhìn sẽ được thêm vào cuối thư viện hoặc album.

Nếu cả album id và vị trí đều được xác định, thì mục nội dung nghe nhìn sẽ được thêm vào album ở vị trí đã chỉ định.

Nếu lệnh 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 bạn đ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 nội dung nghe nhìn đó. Thao tác nà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 nơi các mục nội dung nghe nhìn được thêm vào. 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 cần tạo. Tối đa 50 mục nội dung nghe nhìn mỗi lệnh gọi.
albumPosition

object (AlbumPosition)

Vị trí trong album nơi các mục nội dung nghe nhìn được thêm. Nếu bạn không chỉ định, các mục nội dung nghe nhì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 các 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 các 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:

  • 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 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. 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 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 được tạo tự động nào như tên tệp, thẻ và siêu dữ liệu khác.
Trường kết hợp new_media_item_type. Mục nội dung đa phương tiện mới có thể thuộc nhiều loại – điều này phụ 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 giá trị sau:
simpleMediaItem

object (SimpleMediaItem)

Một mục nội dung nghe nhìn mới đã được tải lên qua uploadToken đi kèm.

SimpleMediaItem

Bạn có thể tạo một mục nội dung nghe nhìn đơn giản trong Google Photos bằng mã 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 nghe nhìn đã được tải lên Google.
fileName

string

Tên tệp có đuôi của mục nội dung nghe nhìn. Người dùng sẽ nhìn 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ả của việc tạo một mục nội dung đa phương tiệ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 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 là đơn giản và yêu cầu một mã thông báo 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ì hệ thống sẽ điền thông tin liên quan đến lỗi vào trường này. Để 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)

Đã tạo mục nội dung đa phương tiện bằng mã thông báo tải lên. Hệ thống sẽ điền giá trị này nếu không có lỗi nào xảy ra và mục nội dung đa phương tiện được tạo thành công.