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 album. Các mục nội dung đa phương tiện và album phải do nhà phát triển tạo 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 đa phương tiện, các mục đó sẽ được thêm theo thứ tự 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 các album được chia sẻ, album phải thuộc quyền sở hữu của người dùng hoặc người dùng phải tham gia vào 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 đa phương tiệ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 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 thì 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