Method: mediaItems.batchCreate

사용자의 Google 포토 라이브러리에 하나 이상의 미디어 항목을 만듭니다.

이는 미디어 항목을 만드는 두 번째 단계입니다. Google 서버에 원시 바이트를 업로드하는 1단계와 관련된 자세한 내용은 미디어 업로드를 참고하세요.

이 호출을 통해 미디어 항목이 라이브러리에 추가됩니다. 앨범 id이 지정되면 호출 시 미디어 항목도 앨범에 추가됩니다. 각 앨범에는 최대 20,000개의 미디어 항목이 포함될 수 있습니다. 기본적으로 미디어 항목은 라이브러리 또는 앨범의 끝부분에 추가됩니다.

앨범 id 및 위치가 모두 정의된 경우 미디어 항목이 앨범에 지정된 위치에 추가됩니다.

호출에 여러 미디어 항목이 포함된 경우 지정된 위치에 추가됩니다. 소유자가 아닌 공유 앨범에 미디어 항목을 만드는 경우 해당 미디어 항목을 배치할 수 없습니다. 그렇게 하면 BAD REQUEST 오류가 발생합니다.

HTTP 요청

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
필드
albumId

string

미디어 항목이 추가된 앨범의 식별자입니다. 미디어 항목은 사용자의 라이브러리에도 추가됩니다. 이 필드는 선택 사항입니다.

newMediaItems[]

object (NewMediaItem)

필수 항목입니다. 만들 미디어 항목의 목록입니다. 호출당 최대 50개의 미디어 항목

albumPosition

object (AlbumPosition)

미디어 항목이 추가된 앨범 내 위치입니다. 지정하지 않으면 미디어 항목이 기본값 (LAST_IN_ALBUM)에 따라 앨범 끝에 추가됩니다. 이 필드가 설정되고 albumId이 지정되지 않으면 요청이 실패합니다. 필드를 설정했으며 공유 앨범의 소유자가 아닌 경우에도 요청이 실패합니다.

응답 본문

생성된 미디어 항목 목록입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
필드
newMediaItemResults[]

object (NewMediaItemResult)

출력 전용. 생성된 미디어 항목 목록입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

새 미디어 항목

사용자의 Google 포토 계정에서 생성된 새 미디어 항목

JSON 표현
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
필드
description

string

미디어 항목의 설명입니다. Google 포토 앱의 항목 정보 섹션에서 사용자에게 표시됩니다. 1,000자(영문 기준) 미만이어야 합니다. 사용자가 작성한 텍스트만 포함합니다. 설명은 맥락을 추가하고 사용자가 미디어를 이해하는 데 도움이 되어야 합니다. 파일 이름, 태그, 기타 메타데이터 등 자동 생성된 문자열을 포함하면 안 됩니다.

통합 필드 new_media_item_type. 새 미디어 항목은 다양한 유형일 수 있으며 업로드 경로에 따라 다릅니다. 현재 지원되는 업로드에서는 단순 미디어 항목 경로만 사용합니다. new_media_item_type은 다음 중 하나여야 합니다.
simpleMediaItem

object (SimpleMediaItem)

포함된 uploadToken를 통해 업로드된 새 미디어 항목입니다.

단순 미디어 항목

업로드 토큰을 통해 Google 포토에서 생성될 간단한 미디어 항목입니다.

JSON 표현
{
  "uploadToken": string,
  "fileName": string
}
필드
uploadToken

string

Google에 업로드된 미디어 바이트를 식별하는 토큰입니다.

fileName

string

미디어 항목의 확장자가 포함된 파일 이름입니다. Google 포토에서 사용자에게 표시됩니다. 이 필드가 설정되면 바이트 업로드 프로세스 중에 지정된 파일 이름은 무시됩니다. 파일 확장자를 포함한 파일 이름은 255자(영문 기준) 이하여야 합니다. 이 필드는 선택 사항입니다.

새 미디어 항목 결과

새 미디어 항목 생성 결과입니다.

JSON 표현
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
필드
uploadToken

string

이 새 (단순) 미디어 항목을 만드는 데 사용되는 업로드 토큰입니다. 미디어 항목이 단순하고 단일 업로드 토큰이 필요한 경우에만 채워집니다.

status

object (Status)

이 미디어 항목을 만드는 동안 오류가 발생하면 오류와 관련된 정보가 이 필드에 채워집니다. 이 필드에 대한 자세한 내용은 상태를 참조하세요.

mediaItem

object (MediaItem)

업로드 토큰으로 만든 미디어 항목입니다. 오류가 발생하지 않고 미디어 항목이 성공적으로 생성되면 채워집니다.