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