Method: albums.batchAddMediaItems

Thêm 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 vào một album. Nhà phát triển phải tạo các mục nội dung nghe nhìn và đĩa nhạc thông qua API.

Các mục nội dung nghe nhìn sẽ được thêm vào cuối album. Nếu bạn cung cấp nhiều mục nội dung nghe nhìn, thì các mục đó sẽ được thêm theo thứ tự được chỉ định trong lệnh gọi này.

Mỗi album có thể chứa tối đa 20.000 mục nội dung nghe nhìn.

Bạn chỉ có thể thêm những mục nội dung nghe nhìn có trong thư viện của người dùng vào album. Đối với những album được chia sẻ, người dùng phải là chủ sở hữu của album hoặc phải tham gia album với tư cách là cộng tác viên.

Chúng tôi không hỗ trợ nếu thành công một phần. Toàn bộ yêu cầu sẽ không thành công nếu một mục nội dung nghe nhìn hoặc album không hợp lệ được chỉ định.

Yêu cầu HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
albumId

string

Bắt buộc. Giá trị nhận dạng của Album mà các mục nội dung nghe nhìn được thêm vào.

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 
{
  "mediaItemIds": [
    string
  ]
}
Trường
mediaItemIds[]

string

Bắt buộc. Giá trị nhận dạng của các MediaItem cần thêm. Bạn có thể thêm tối đa 50 mục nội dung nghe nhìn trong một lệnh gọi.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

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
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata