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à album 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 các mục nội dung nghe nhìn có trong thư viện của người dùng vào một đĩa nhạc. Đố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 là cộng tác viên trong album.

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

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

Tham 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