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.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata