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. 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 đượ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 album. Đối với 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 cộng tác viên.

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 đa phương tiện hoặc album 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 đ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 sẽ được thêm vào. Bạn có thể thêm tối đa 50 mục nội dung nghe nhìn trong một cuộc 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 đây:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing