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 đa phương tiện. Để biết thông tin chi tiết về Bước 1, cách tải các byte thô lên Máy chủ Google, hãy xem phần 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 bạn xác định cả album id và vị trí, 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 đa phương tiệ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 dùng chung 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 đó. Việ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 thêm các mục nội dung nghe nhìn. Các mục nội dung nghe nhì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 cho 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 đ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 được tạo tự động nào như tên tệp, thẻ và siêu dữ liệu khác.
Trường hợp hợp nhất new_media_item_type. Mục nội dung nghe nhìn mới có thể thuộc nhiều loại khác nhau, 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 nghe nhì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 thông 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ó phần mở rộng là mục nội dung nghe nhìn. Thông tin này sẽ hiển thị cho người dùng 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 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 dùng để tạo mục nội dung nghe nhìn (đơn giản) mới này. Chỉ được điền sẵn nếu mục nội dung nghe nhìn đơn giản và cần một mã thông báo tải lên.
status

object (Status)

Nếu xảy ra lỗi trong quá trình tạo mục nội dung nghe nhìn này, trường này sẽ được điề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 nghe nhìn được tạo bằng mã thông báo tải lên. Giá trị này được điền nếu không có lỗi nào xảy ra và mục nội dung nghe nhìn đã được tạo thành công.