REST Resource: accounts.locations.media.customers

리소스: MediaItem

단일 미디어 항목입니다.

JSON 표현 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
필드
name

string

이 미디어 항목의 리소스 이름입니다. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

이 미디어 항목의 형식입니다. 미디어 항목이 생성될 때 설정해야 하며, 다른 모든 요청에서 읽기 전용입니다. 이 설정은 업데이트할 수 없습니다.
locationAssociation

object (LocationAssociation)

CreatePhoto를 호출할 때 필요합니다. 이 미디어 항목이 해당 위치에 연결되는 방식을 설명합니다. 카테고리 (예: EXTERIOR) 또는 가격 목록 항목의 ID여야 합니다.

media.create를 사용하여 위치에 새 미디어를 추가할 때 필요합니다. 지역 게시물의 사진과 같은 다른 유형의 미디어에는 표시되지 않습니다.
googleUrl

string

출력 전용. 이 미디어 항목에 대해 Google에서 호스팅하는 URL입니다. 이 URL은 시간이 지남에 따라 변경될 수 있으므로 정적이지 않습니다. 동영상의 경우 오버레이된 재생 아이콘이 있는 미리보기 이미지입니다.
thumbnailUrl

string

출력 전용. 제공되는 경우 이 미디어 항목의 미리보기 이미지 URL입니다.
createTime

string (Timestamp format)

출력 전용. 이 미디어 항목의 생성 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
dimensions

object (Dimensions)

출력 전용. 픽셀 단위의 크기 (너비 및 높이)입니다.
insights

object (MediaInsights)

출력 전용. 이 미디어 항목에 대한 통계입니다.
attribution

object (Attribution)

출력 전용. 고객 미디어 항목의 저작자 표시 정보입니다. 이 저작자 표시를 사용자에게 제공한 대로 표시해야 하며 저작자 표시를 삭제하거나 변경해서는 안 됩니다.
description

string

이 미디어 항목의 설명입니다. 설명은 Google My Business API를 통해 수정할 수 없지만 표지 사진이 아닌 새 미디어 항목을 만들 때 설정할 수 있습니다.

통합 필드 data. 미디어 항목의 데이터 소스입니다. 새 미디어 항목을 만들 때 URL 또는 데이터 참조를 제공해야 합니다.

PROFILE 및 COVER 카테고리를 제외한 모든 사진은 짧은 쪽이 250픽셀 이상, 파일 크기가 10, 240바이트 이상이어야 합니다.

업로드된 모든 사진은 사진 관련 비즈니스 프로필 가이드라인을 준수해야 합니다. data은 다음 중 하나여야 합니다.
sourceUrl

string

미디어 항목을 가져올 수 있는 공개적으로 액세스 가능한 URL입니다.

이 소스 중 하나를 만들거나 dataRef를 설정하여 미디어 항목의 소스를 지정해야 합니다.

미디어 항목을 만들 때 sourceUrl를 사용한 경우 미디어 항목이 검색될 때 이 소스 URL로 채워집니다.

이 필드는 업데이트할 수 없습니다.
dataRef

object (MediaItemDataRef)

입력 전용. media.startUpload 메서드에서 가져온 미디어 항목 바이너리 데이터에 대한 참조입니다.

미디어 항목을 만들 때

sourceUrl

또는

dataRef

를 설정해야 합니다.

방법

get

 요청된 고객 미디어 항목의 메타데이터를 반환합니다.

list

 고객이 제공한 위치와 연결된 미디어 항목의 목록을 반환합니다.