사용자의 Google 포토 라이브러리에 있는 미디어 항목을 하나 이상 앨범에 추가합니다. 미디어 항목과 앨범은 개발자가 API를 통해 생성해야 합니다.
미디어 항목이 앨범 끝에 추가됩니다. 미디어 항목이 여러 개 주어지면 이 호출에 지정된 순서대로 추가됩니다.
각 앨범에는 최대 20,000개의 미디어 항목을 포함할 수 있습니다.
사용자의 보관함에 있는 미디어 항목만 앨범에 추가할 수 있습니다. 앨범을 공유하는 경우, 앨범은 사용자가 소유하거나 공동작업자로 앨범에 참여해야 합니다.
부분 성공은 지원되지 않습니다. 잘못된 미디어 항목이나 앨범을 지정하면 전체 요청이 실패합니다.
HTTP 요청
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
albumId |
필수 항목입니다. 미디어 항목이 추가되는 |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "mediaItemIds": [ string ] } |
필드 | |
---|---|
mediaItemIds[] |
필수 항목입니다. 추가할 |
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
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