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