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