REST Resource: accounts.locations.media

리소스: 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

를 설정해야 합니다.

MediaItemDataRef

Google My Business API를 통해 업로드된 MediaItem의 사진 바이너리 데이터에 대한 참조입니다.

media.startUpload를 사용하여 데이터 참조를 만들고 바이트를 [media.upload] 에 업로드하고 이후에 media.create를 호출할 때 이 참조를 사용합니다.

JSON 표현
{
  "resourceName": string
}
필드
resourceName

string

이 미디어 항목의 바이너리 데이터에 대한 고유 ID입니다. [media.upload] 로 사진 데이터를 업로드하고 media.create로 이러한 바이트에서 새 미디어 항목을 만들 때 사용됩니다.

바이트 업로드 예시: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

media.create 호출의 경우 이를 MediaItem dataRef로 설정합니다.

MediaFormat

미디어 형식의 열거형입니다.

열거형
MEDIA_FORMAT_UNSPECIFIED 형식이 지정되지 않았습니다.
PHOTO 미디어 항목이 사진입니다. 이 버전에서는 사진만 지원됩니다.
VIDEO 미디어 항목이 동영상입니다.

LocationAssociation

미디어 항목이 해당 위치와 연결되는 방식입니다.

JSON 표현
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
필드
통합 필드 location_attachment_type. 위치 미디어에는 카테고리 또는 연결된 가격 목록 항목의 ID가 있어야 합니다. 비위치 미디어 (예: 지역 게시물 사진)에는 둘 다 없어야 합니다. location_attachment_type은 다음 중 하나여야 합니다.
category

enum (Category)

이 위치 사진이 속한 카테고리입니다.

priceListItemId

string

이 위치 사진과 연결된 가격 목록 항목의 ID입니다.

카테고리

미디어 항목 카테고리의 열거형입니다.

열거형
CATEGORY_UNSPECIFIED 카테고리가 지정되지 않았습니다.
COVER 표지 사진 위치에는 표지 사진이 하나만 있습니다.
PROFILE 프로필 사진입니다. 위치에는 프로필 사진이 하나만 있습니다.
EXTERIOR 외부 미디어.
INTERIOR 내부 미디어.
PRODUCT 제품 미디어입니다.
AT_WORK '직장' 있습니다.
FOOD_AND_DRINK 식음료 미디어
MENU 메뉴 미디어입니다.
COMMON_AREA 공용 공간 미디어입니다.
ROOMS 방 미디어입니다.
TEAMS 팀 미디어.
ADDITIONAL 카테고리가 없는 추가 미디어입니다.

크기

미디어 항목의 크기입니다.

JSON 표현
{
  "widthPixels": integer,
  "heightPixels": integer
}
필드
widthPixels

integer

미디어 항목의 너비(픽셀)입니다.

heightPixels

integer

미디어 항목의 높이(픽셀)입니다.

MediaInsights

미디어 항목에 대한 통계입니다.

JSON 표현
{
  "viewCount": string
}
필드
viewCount

string (int64 format)

출력 전용입니다. 미디어 항목이 조회된 횟수입니다.

기여 분석

도움을 주신 분의 이름 및 프로필 사진과 같은 고객 미디어 항목의 저작자 표시 정보입니다.

JSON 표현
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
필드
profileName

string

미디어 항목의 기여자인 사용자 이름입니다.

profilePhotoUrl

string

기여 사용자의 프로필 사진 미리보기 이미지 URL입니다.

takedownUrl

string

미디어 항목이 부적절한 경우 신고할 수 있는 게시 중단 페이지의 URL입니다.

profileUrl

string

기여 사용자의 Google 지도 프로필 페이지 URL입니다.

메서드

create

위치의 새 미디어 항목을 만듭니다.

delete

지정된 미디어 항목을 삭제합니다.

get

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

list

위치와 연결된 미디어 항목의 목록을 반환합니다.

patch

지정된 미디어 항목의 메타데이터를 업데이트합니다.

startUpload

미디어 항목 업로드를 위한 MediaItemDataRef를 생성합니다.