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 또는 데이터 참조를 제공해야 합니다.

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

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

sourceUrl

string

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

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

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

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

dataRef

object (MediaItemDataRef)

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

미디어 항목을 만들 때

sourceUrl

또는

dataRef

를 설정해야 합니다.

메서드

get

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

list

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