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