Method: albums.batchAddMediaItems

사용자의 Google 포토 라이브러리에 있는 미디어 항목을 하나 이상 앨범에 추가합니다. 미디어 항목과 앨범은 개발자가 API를 통해 생성해야 합니다.

미디어 항목이 앨범 끝에 추가됩니다. 미디어 항목이 여러 개 주어지면 이 호출에 지정된 순서대로 추가됩니다.

각 앨범에는 최대 20,000개의 미디어 항목을 포함할 수 있습니다.

사용자의 보관함에 있는 미디어 항목만 앨범에 추가할 수 있습니다. 공유된 앨범의 경우 사용자가 앨범을 소유하고 있거나 공동작업자로 앨범에 참여한 상태여야 합니다.

부분 성공은 지원되지 않습니다. 잘못된 미디어 항목이나 앨범을 지정하면 전체 요청이 실패합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
albumId

string

필수 항목입니다. 미디어 항목이 추가되는 Album의 식별자입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "mediaItemIds": [
    string
  ]
}
필드
mediaItemIds[]

string

필수 항목입니다. 추가할 MediaItem의 식별자입니다. 한 번의 호출로 추가할 수 있는 최대 미디어 항목 수는 50개입니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

승인 범위

다음 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