리소스: MediaItem
Google 포토의 미디어 항목 (예: 사진 또는 동영상)을 나타냅니다.
JSON 표현 |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
필드 | |
---|---|
id |
미디어 항목의 식별자입니다. 세션 간에 이 미디어 항목을 식별하는 데 사용할 수 있는 영구 식별자입니다. |
description |
미디어 항목에 대한 설명입니다. Google 포토 앱의 항목 정보 섹션에서 사용자에게 표시됩니다. 1,000자(영문 기준) 미만이어야 합니다. 사용자가 작성한 텍스트만 포함합니다. 설명은 맥락을 더하고 사용자가 미디어를 이해하는 데 도움이 되어야 합니다. 파일 이름, 태그 및 기타 메타데이터와 같이 자동 생성된 문자열을 포함하지 마세요. |
productUrl |
미디어 항목의 Google 포토 URL입니다. 이 링크는 로그인한 경우에만 사용자에게 제공됩니다. 앨범 검색에서 검색할 때 URL은 앨범 내부 항목을 가리킵니다. |
baseUrl |
미디어 항목의 바이트 URL입니다. 있는 그대로 사용해서는 안 됩니다. 매개변수를 이 URL에 추가하여 사용해야 합니다. 지원되는 매개변수의 전체 목록은 개발자 문서를 참고하세요. 예를 들어 |
mimeType |
미디어 항목의 MIME 유형입니다. 예를 들면 |
mediaMetadata |
높이, 너비, 생성 시간 등 미디어 항목과 관련된 메타데이터입니다. |
contributorInfo |
이 미디어 항목을 추가한 사용자에 대한 정보입니다. 공유 앨범 ID와 함께 |
filename |
미디어 항목의 파일 이름입니다. Google 포토 앱의 항목 정보 섹션에서 사용자에게 표시됩니다. |
MediaMetadata
미디어 항목의 메타데이터입니다.
JSON 표현 |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
필드 | |
---|---|
creationTime |
미디어 항목이 Google 포토에 업로드된 시점이 아닌 미디어 항목이 처음 만들어진 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
width |
미디어 항목의 원래 너비 (픽셀)입니다. |
height |
미디어 항목의 원래 높이 (픽셀)입니다. |
통합 필드 metadata 는 나타내는 기본 미디어 유형과 관련된 미디어 항목의 메타데이터입니다. metadata 은 다음 중 하나여야 합니다. |
|
photo |
사진 미디어 유형의 메타데이터입니다. |
video |
동영상 미디어 유형의 메타데이터입니다. |
사진
ISO, 초점 거리, 노출 시간 등 사진 관련 메타데이터입니다. 이러한 필드 중 일부는 null이거나 포함되어 있지 않을 수 있습니다.
JSON 표현 |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
필드 | |
---|---|
cameraMake |
사진을 찍은 카메라의 브랜드입니다. |
cameraModel |
사진을 찍은 카메라의 모델입니다. |
focalLength |
사진이 촬영된 카메라 렌즈의 초점 시간입니다. |
apertureFNumber |
사진이 촬영된 카메라 렌즈의 조리개 f 번호입니다. |
isoEquivalent |
사진을 찍은 카메라의 ISO입니다. |
exposureTime |
사진이 촬영된 카메라 조리개의 노출 시간입니다. 초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
동영상
동영상과 관련된 메타데이터(예: FPS 및 처리 상태) 이러한 필드 중 일부는 null이거나 포함되어 있지 않을 수 있습니다.
JSON 표현 |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
필드 | |
---|---|
cameraMake |
동영상을 촬영한 카메라의 브랜드입니다. |
cameraModel |
동영상이 촬영된 카메라의 모델입니다. |
fps |
동영상의 프레임 속도입니다. |
status |
동영상의 처리 상태입니다. |
동영상 처리 상태
Google 포토에 업로드 중인 동영상의 처리 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
동영상 처리 상태를 알 수 없습니다. |
PROCESSING |
동영상을 처리하는 중입니다. 사용자가 Google 포토 앱에서 이 동영상의 아이콘을 볼 수 있지만 아직 재생할 수 없습니다. |
READY |
동영상 처리가 완료되어 이제 동영상을 볼 수 있습니다. 중요: 준비 상태가 아닌 동영상을 다운로드하려는 시도가 실패할 수 있습니다. |
FAILED |
문제가 발생하여 동영상을 처리하지 못했습니다. |
참여자 정보
미디어 항목을 추가한 사용자에 관한 정보입니다. 이 정보는 미디어 항목이 앱에서 만든 공유 앨범에 포함되어 있으며 공유 범위가 있는 경우에만 포함됩니다.
JSON 표현 |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
필드 | |
---|---|
profilePictureBaseUrl |
도움을 주신 분들의 프로필 사진 URL입니다. |
displayName |
도움을 주신 분의 표시 이름입니다. |
방법 |
|
---|---|
|
사용자의 Google 포토 라이브러리에 하나 이상의 미디어 항목을 만듭니다. |
|
지정된 미디어 항목 식별자의 미디어 항목 목록을 반환합니다. |
|
지정된 미디어 항목 식별자의 미디어 항목을 반환합니다. |
|
사용자의 Google 포토 라이브러리에 있는 모든 미디어 항목을 나열합니다. |
|
지정된 id 로 미디어 항목을 업데이트합니다. |
|
사용자의 Google 포토 라이브러리에서 미디어 항목을 검색합니다. |