Method: mediaItems.batchCreate

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

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

이 호출은 미디어 항목을 라이브러리에 추가합니다. 앨범 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

NewMediaItem

사용자의 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를 통해 업로드된 새 미디어 항목입니다.

SimpleMediaItem

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

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

string

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

string

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

NewMediaItemResult

새 미디어 항목을 만든 결과

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

string

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

object (Status)

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

object (MediaItem)

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