Method: albums.batchRemoveMediaItems

지정된 앨범에서 하나 이상의 미디어 항목을 삭제합니다. 미디어 항목과 앨범은 개발자가 API를 통해 만들었어야 합니다.

공유된 앨범의 경우 이 사용자가 앨범에 추가한 미디어 항목에만 이 작업이 지원되며, 이 사용자가 앨범을 만든 경우에는 모든 미디어 항목에 지원됩니다.

부분 성공은 지원되지 않습니다. 잘못된 미디어 항목이나 앨범이 지정된 경우 전체 요청이 실패하고 앨범에 대해 아무런 작업도 수행되지 않습니다.

HTTP 요청

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

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.edit.appcreateddata