REST Resource: accounts.locations

리소스: Location

위치입니다. 이러한 필드에 대한 자세한 설명은 고객센터 도움말을, 유효한 비즈니스 카테고리 목록은 카테고리 엔드포인트를 참고하세요.

JSON 표현 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
필드
name

string

식별자. locations/{locationId} 형식으로 된 이 위치의 Google 식별자입니다.
languageCode

string

변경할 수 없습니다. 위치의 언어입니다. 생성 중에 설정되며 업데이트할 수 없습니다.
storeCode

string

선택사항입니다. 이 위치의 외부 식별자이며 주어진 계정 내에서 고유해야 합니다. 위치를 자신의 레코드와 연결하는 방법입니다.
title

string

필수 항목입니다. 위치 이름은 오프라인 매장, 웹사이트, 회사 서류에서 일관되게 사용되고 고객에게 알려진 비즈니스의 실제 이름을 반영해야 합니다. 관련이 있는 경우 추가 정보는 리소스의 다른 필드 (예: Address, Categories)에 포함할 수 있습니다. 이름에 불필요한 정보를 추가하지 마세요 (예: 'Google Inc. - Mountain View Corporate Headquarters' 대신 'Google' 사용). 마케팅 소개 문구, 상점 코드, 특수문자, 영업시간 또는 영업/휴업 상태, 전화번호, 웹사이트 URL, 서비스/제품 정보, 위치/주소 또는 경로, 포함 정보 (예: 'Duane Reade 내 Chase ATM')를 포함하지 마세요.
phoneNumbers

object (PhoneNumbers)

선택사항입니다. 고객이 비즈니스에 연락할 수 있는 다양한 전화번호입니다.
categories

object (Categories)

선택사항입니다. 비즈니스를 설명하는 다양한 카테고리입니다.
storefrontAddress

object (PostalAddress)

선택사항입니다. 정확한 주소를 사용해 업체 위치를 설명하세요. 원격 위치에 있는 사서함이나 우편함은 사용할 수 없습니다. 현재는 주소에 최대 5개의 addressLines 값을 지정할 수 있습니다. 이 필드는 오프라인 매장이 있는 비즈니스에만 설정해야 합니다. 이 필드는 CUSTOMER_LOCATION_ONLY 유형의 위치에 설정하면 안 되지만, 설정된 경우 제공된 값은 삭제됩니다.
websiteUri

string

선택사항입니다. 이 비즈니스의 URL입니다. 가능하면 모든 위치 또는 브랜드를 나타내는 일반 웹사이트/URL 대신 이 개별 업체 위치를 나타내는 URL을 사용하세요.
regularHours

object (BusinessHours)

선택사항입니다. 비즈니스의 영업시간입니다.
specialHours

object (SpecialHours)

선택사항입니다. 비즈니스의 특별 영업시간입니다. 일반적으로 휴일 영업시간 및 정규 영업시간 외의 기타 영업시간이 포함됩니다. 이 영업시간은 정규 영업시간보다 우선합니다. 이 필드는 정규 영업시간이 없으면 설정할 수 없습니다.
serviceArea

object (ServiceAreaBusiness)

선택사항입니다. 방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다. 방문 서비스 업체인 경우, 이 필드는 업체가 서비스를 제공하는 지역을 설명합니다.
labels[]

string

선택사항입니다. 비즈니스를 태그할 수 있는 자유 형식의 문자열 컬렉션입니다. 이러한 라벨은 사용자에게 표시되지 않으며 나만 볼 수 있습니다. 라벨당 1~255자(영문 기준)여야 합니다.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

선택사항입니다. 애드워즈에 표시되는 추가 정보입니다.
latlng

object (LatLng)

선택사항입니다. 사용자가 제공한 위도 및 경도입니다. 위치를 생성할 때 제공된 주소가 성공적으로 지오코딩되면 이 필드는 무시됩니다. 이 필드는 사용자가 제공한 latlng 값이 생성 중에 허용되거나 Google 비즈니스 프로필 웹사이트를 통해 latlng 값이 업데이트된 경우에만 get 요청 시 반환됩니다. 이 필드는 승인된 클라이언트만 업데이트할 수 있습니다.
openInfo

object (OpenInfo)

선택사항입니다. 업체 위치가 현재 영업 중임을 나타내는 플래그입니다.
metadata

object (Metadata)

출력 전용입니다. 사용자가 수정할 수 없는 추가 정보입니다.
profile

object (Profile)

선택사항입니다. 비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다.

이 입력란은 숙박 카테고리 (예: 호텔, 모텔, 여관)를 제외한 모든 카테고리에 필수입니다.
relationshipData

object (RelationshipData)

선택사항입니다. 이 위치와 관련된 모든 위치 및 체인입니다.
moreHours[]

object (MoreHours)

선택사항입니다. 비즈니스의 여러 부서 또는 특정 고객을 위한 추가 영업시간입니다.
serviceItems[]

object (ServiceItem)

선택사항입니다. 판매자가 지원하는 서비스 목록입니다. 서비스는 이발, 온수기 설치 등이 될 수 있습니다. 중복된 서비스 항목은 자동으로 삭제됩니다.

PhoneNumbers

비즈니스의 전화번호 모음입니다. 업데이트 중에는 두 필드를 모두 설정해야 합니다. 클라이언트는 업데이트 마스크를 사용하여 기본 또는 추가 전화번호만 업데이트할 수 없습니다. 국제 전화번호 형식(예: '+1 415 555 0132')을 사용하는 것이 좋습니다. 자세한 내용은 (https://developers.google.com/style/phone-numbers#international-phone-numbers)를 참고하세요.

JSON 표현 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
필드
primaryPhone

string

필수 항목입니다. 가능한 한 개별 업체 위치로 직접 연결되는 전화번호입니다. 가능하면 중앙의 콜 센터 전화 상담 서비스 번호가 아닌 지역 전화번호를 사용하세요.
additionalPhones[]

string

선택사항입니다. 기본 전화번호 외에 비즈니스에 연락할 수 있는 전화번호 (휴대전화 또는 유선 전화번호)입니다. 최대 2개까지 추가할 수 있으며 팩스 번호는 사용할 수 없습니다.

카테고리

비즈니스를 설명하는 카테고리 모음입니다. 업데이트 중에는 두 필드를 모두 설정해야 합니다. 클라이언트는 업데이트 마스크를 사용하여 기본 또는 추가 카테고리를 개별적으로 업데이트할 수 없습니다.

JSON 표현 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
필드
primaryCategory

object (Category)

필수 항목입니다. 이 위치가 수행하는 핵심 비즈니스를 가장 잘 설명하는 카테고리입니다.
additionalCategories[]

object (Category)

선택사항입니다. 비즈니스를 설명하는 추가 카테고리입니다. 카테고리를 지정해 두면 고객이 관심 있는 서비스를 정확하게 찾을 수 있습니다. 비즈니스 정보를 최신 상태로 정확하게 유지하려면 전체 핵심 비즈니스를 설명하는 카테고리를 가능한 한 적게 사용해야 합니다. 최대한 구체적이면서 주 비즈니스를 대표하는 카테고리를 선택하세요.

카테고리

이 비즈니스의 업무 내용이 아니라 업종을 설명하는 카테고리입니다. 유효한 카테고리 ID 목록과 인간이 읽을 수 있는 이름에 대한 매핑은 categories.list를 참고하세요.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
필드
name

string

필수 항목입니다. 이 카테고리의 안정적인 ID입니다 (Google에서 제공). 카테고리를 수정할 때 (위치를 만들거나 업데이트할 때) 값을 지정해야 합니다.
displayName

string

출력 전용입니다. 사람이 읽을 수 있는 카테고리 이름입니다. 위치를 읽을 때 설정됩니다. 위치를 수정할 때는 category_id를 설정해야 합니다.
serviceTypes[]

object (ServiceType)

출력 전용입니다. 이 비즈니스 카테고리에 사용할 수 있는 모든 서비스 유형의 목록입니다.
moreHoursTypes[]

object (MoreHoursType)

출력 전용입니다. 이 비즈니스 카테고리에 사용할 수 있는 추가 영업시간 유형입니다.

ServiceType

비즈니스에서 제공하는 서비스 유형을 설명하는 메시지입니다.

JSON 표현 
{
  "serviceTypeId": string,
  "displayName": string
}
필드
serviceTypeId

string

출력 전용입니다. 이 서비스 유형의 안정적인 ID입니다 (Google에서 제공).
displayName

string

출력 전용입니다. 서비스 유형의 인간이 읽을 수 있는 표시 이름입니다.

MoreHoursType

비즈니스에서 정규 영업시간 외에 제공할 수 있는 추가 영업시간 유형입니다.

JSON 표현 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
필드
hoursTypeId

string

출력 전용입니다. 이 영업시간 유형에 대해 Google에서 제공하는 안정적인 ID입니다.
displayName

string

출력 전용입니다. 영업시간 유형에 대해 사람이 읽을 수 있는 영어 표시 이름입니다.
localizedDisplayName

string

출력 전용입니다. 영업시간 유형에 대해 인간이 읽을 수 있는 현지화된 표시 이름입니다.

BusinessHours

이 위치의 영업시간을 나타냅니다. [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] 인스턴스의 컬렉션을 보유합니다.

JSON 표현 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
필드
periods[]

object (TimePeriod)

필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

TimePeriod

지정된 개장 날짜/시간에 시작해 지정된 종료 날짜/시간에 종료하는 비즈니스의 영업 기간을 나타냅니다. 영업 종료 시간은 시작 시간 뒤(예를 들어 당일 이후 시간 또는 이후 날짜)에 와야 합니다.

JSON 표현 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
필드
openDay

enum (DayOfWeek)

필수 항목입니다. 이 기간이 시작되는 day of the week를 나타냅니다.
openTime

object (TimeOfDay)

필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. 참고: Proto3 JSON 매핑에서 기본 0 값 (00:00)은 생략되어 openTime에 {}가 생성됩니다.
closeDay

enum (DayOfWeek)

필수 항목입니다. 이 기간이 끝나는 day of the week를 나타냅니다.
closeTime

object (TimeOfDay)

필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. 참고: Proto3 JSON 매핑에서 기본 0 값 (00:00)은 생략되어 closeTime에 {}가 생성됩니다.

SpecialHours

위치의 영업시간이 정상 영업시간과 다른 기간 집합을 나타냅니다.

JSON 표현 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
필드
specialHourPeriods[]

object (SpecialHourPeriod)

필수 항목입니다. 비즈니스의 정규 영업시간에 대한 예외 목록입니다.

SpecialHourPeriod

위치의 영업시간이 정상 영업시간과 다른 경우 단일 기간을 나타냅니다. 특별 영업시간에 표시되는 범위는 24시간 미만이어야 합니다. openTime 및 startDate는 closeTime 및 endDate보다 이전이어야 합니다. closeTime 및 endDate는 지정된 startDate 다음 날 오전 11시 59분까지 연장할 수 있습니다. 예를 들어 다음 입력은 유효합니다.

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

다음 입력은 유효하지 않습니다.

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON 표현 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
필드
startDate

object (Date)

필수 항목입니다. 특별 영업시간 기간이 시작되는 캘린더 날짜입니다.
openTime

object (TimeOfDay)

선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. closed가 false인 경우 지정해야 합니다.
endDate

object (Date)

선택사항입니다. 특별 영업시간 기간이 종료되는 캘린더 날짜입니다. endDate 필드가 설정되지 않으면 startDate에 지정된 날짜가 기본값입니다. 설정하는 경우 startDate와 같거나 최대 1일 후여야 합니다.
closeTime

object (TimeOfDay)

선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. closed가 false인 경우 지정해야 합니다.
closed

boolean

선택사항입니다. true인 경우 endDate, openTime, closeTime는 무시되며, startDate에 지정된 날짜는 위치가 하루 종일 문을 닫은 것으로 처리됩니다.

ServiceAreaBusiness

방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다 (예: 열쇠공 또는 배관공).

JSON 표현 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
필드
businessType

enum (BusinessType)

필수 항목입니다. 방문 서비스 업체의 [유형][google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] 을 나타냅니다.
places

object (Places)

선택사항입니다. 이 비즈니스가 서비스를 제공하는 지역이 장소의 집합을 통해 정의됩니다.
regionCode

string

변경할 수 없습니다. 이 방문 서비스 업체가 위치한 국가/지역의 CLDR 지역 코드입니다. 자세한 내용은 http://cldr.unicode.org/ 및 http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'

이 필드는 CUSTOMER_LOCATION_ONLY 비즈니스에 필요하며, 그 외의 경우에는 무시됩니다.

여기에 지정된 지역은 이 비즈니스가 서비스를 제공하는 지역과 다를 수 있습니다 (예: 본사가 위치한 지역이 아닌 다른 지역에서 서비스를 제공하는 방문 서비스 업체).

이 위치를 만든 후 인증이 필요한 경우 인증을 위해 제공된 주소가 이 지역 내에 있어야 하며, 비즈니스 소유자 또는 공식 대리인이 제공된 인증 주소로 우편물을 받을 수 있어야 합니다.

BusinessType

이 비즈니스가 고객 위치에서 현장 서비스만 제공하는지 (예: 견인 트럭) 주소와 현장 모두에서 서비스를 제공하는지 (예: 고객에게 배달도 하고 식당도 있는 피자 가게) 나타냅니다.

열거형
BUSINESS_TYPE_UNSPECIFIED 출력 전용입니다. 지정되지 않음
CUSTOMER_LOCATION_ONLY 주변 지역 (비즈니스 주소가 아닌)에서만 서비스를 제공합니다. 비즈니스가 CUSTOMER_AND_BUSINESS_LOCATION에서 CUSTOMER_LOCATION_ONLY로 업데이트되는 경우 위치 업데이트에 필드 마스크 storefrontAddress가 포함되어야 하며 필드를 비워 두어야 합니다.
CUSTOMER_AND_BUSINESS_LOCATION 비즈니스 주소 및 주변 지역에서 서비스를 제공합니다.

장소

장소 집합으로 표시되는 지역의 합집합을 정의합니다.

JSON 표현 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
필드
placeInfos[]

object (PlaceInfo)

선택사항입니다. 장소 ID로 표시되는 지역입니다. 최대 20개 장소로 제한됩니다.

PlaceInfo

장소 ID로 표시되는 지역을 정의합니다.

JSON 표현 
{
  "placeName": string,
  "placeId": string
}
필드
placeName

string

필수 항목입니다. 장소의 현지화된 이름입니다. 예를 들면 Scottsdale, AZ입니다.
placeId

string

필수 항목입니다. 장소의 ID입니다. 리전에 상응해야 합니다. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

애드워즈에 표시되는 추가 정보입니다.

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

string

필수 항목입니다. 위치의 기본 전화번호 대신 애드워즈 위치 광고 확장에 표시되는 대체 전화번호입니다.

OpenInfo

비즈니스의 영업 상태와 관련된 정보입니다.

JSON 표현 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
필드
status

enum (OpenForBusiness)

필수 항목입니다. 위치가 현재 영업 중인지 여부를 나타냅니다. 영업 종료 상태로 업데이트되지 않는 한 기본적으로 모든 위치는 영업 상태입니다.
canReopen

boolean

출력 전용입니다. 이 비즈니스를 다시 열 수 있는지 여부를 나타냅니다.
openingDate

object (Date)

선택사항입니다. 위치가 처음 문을 연 날짜입니다. 정확한 날짜를 알 수 없는 경우 월과 연도만 제공될 수 있습니다. 날짜는 과거이거나 미래의 1년 이내여야 합니다.

OpenForBusiness

위치의 상태를 나타냅니다.

열거형
OPEN_FOR_BUSINESS_UNSPECIFIED 지정되지 않음
OPEN 위치가 영업 중임을 나타냅니다.
CLOSED_PERMANENTLY 위치가 폐업 상태임을 나타냅니다.
CLOSED_TEMPORARILY 위치가 임시 휴업 상태임을 나타냅니다.

메타데이터

사용자가 수정할 수 없는 추가 위치 정보입니다.

JSON 표현 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
필드
hasGoogleUpdated

boolean

출력 전용입니다. 이 위치에 연결된 장소 ID에 클라이언트가 업데이트하거나 거부해야 하는 업데이트가 있는지 여부를 나타냅니다. 이 불리언이 설정된 경우 getGoogleUpdated 메서드를 호출하여 확인해야 하는 정보를 조회해야 합니다.
hasPendingEdits

boolean

출력 전용입니다. 이 위치의 속성이 수정 대기 중 상태인지 여부를 나타냅니다.
canDelete

boolean

출력 전용입니다. API를 사용하여 위치를 삭제할 수 있는지 여부를 나타냅니다.
canOperateLocalPost
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 이 필드는 더 이상 채워지지 않으며 향후 버전에서 삭제될 예정입니다.
canModifyServiceList

boolean

출력 전용입니다. 비즈니스 정보에서 서비스 목록을 수정할 수 있는지 여부를 나타냅니다.
canHaveFoodMenus

boolean

출력 전용입니다. 비즈니스 정보가 음식 메뉴를 사용할 수 있는지 여부를 나타냅니다.
canOperateHealthData

boolean

출력 전용입니다. 위치에서 건강 데이터를 사용할 수 있는지 여부를 나타냅니다.
canOperateLodgingData

boolean

출력 전용입니다. 위치에서 숙박 시설 데이터를 사용할 수 있는지 여부를 나타냅니다.
placeId

string

출력 전용입니다. 이 위치가 Google 지도에 표시되는 경우 이 필드는 위치의 장소 ID로 채워집니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다.

이 필드는 Create 호출 중에 설정할 수 있지만 Update 호출 중에는 설정할 수 없습니다.
duplicateLocation

string

출력 전용입니다. 이 위치가 중복되는 위치 리소스입니다.
mapsUri

string

출력 전용입니다. 지도상의 위치에 대한 링크입니다.
newReviewUri

string

출력 전용입니다. 고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지의 링크입니다.
canHaveBusinessCalls

boolean

출력 전용입니다. 비즈니스 정보가 비즈니스 통화에 적합한지 여부를 나타냅니다.
hasVoiceOfMerchant

boolean

출력 전용입니다. 비즈니스 정보에 판매자의 목소리가 있는지 여부를 나타냅니다. 이 불리언이 false인 경우 locations.getVoiceOfMerchantState API를 호출하여 판매자의 목소리가 없는 이유에 관한 세부정보를 확인해야 합니다.
isParticularlyPersonalPlace

boolean

출력 전용입니다. 위치가 매우 사적인 장소로 분류되는지 여부를 나타냅니다. 즉, 위치 기록 기능에 제한이 있습니다. 실수라고 생각되면 고객센터 도움말을 참조하세요.

프로필

위치 프로필과 관련된 모든 정보입니다.

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

string

필수 항목입니다. 내 목소리로 하는 위치 설명으로, 다른 사람이 수정할 수 없습니다.

RelationshipData

이 위치와 관련된 모든 상위 및 하위 위치의 정보입니다.

JSON 표현 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
필드
parentLocation

object (RelevantLocation)

선택사항입니다. 이 위치와 관계가 있는 상위 위치입니다.
childrenLocations[]

object (RelevantLocation)

선택사항입니다. 이 위치와 관계가 있는 하위 위치 목록입니다.
parentChain

string

선택사항입니다. 이 위치가 속한 체인의 리소스 이름입니다. [체인 ID를 찾는 방법] [Locations.SearchChains]

RelevantLocation

현재 위치와 관련된 다른 위치에 관한 정보입니다. 관계는 DEPARTMENT_OF 또는 INDEPENDENT_ESTABLISHMENT_OF 중 하나일 수 있으며, 여기에 지정된 위치는 위치의 어느 쪽 (상위/하위)에나 있을 수 있습니다.

JSON 표현 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
필드
placeId

string

필수 항목입니다. 관계의 다른 쪽에 있는 위치를 placeID로 지정합니다.
relationType

enum (RelationType)

필수 항목입니다. 관계 유형입니다.

RelationType

지정할 유형 관계입니다.

열거형
RELATION_TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
DEPARTMENT_OF 이는 하나의 물리적 영역, 동일한 브랜드/상위 관리/조직을 공유하지만 영업시간이나 전화번호와 같은 주요 속성이 다른 두 위치 간의 관계를 나타냅니다. 예를 들어 Costco Pharmacy는 Costco Wholesale의 부서입니다.
INDEPENDENT_ESTABLISHMENT_IN 이는 두 위치가 동일한 물리적 위치에 있지만 서로 다른 회사 (예: Safeway의 스타벅스, 쇼핑몰의 상점)에 속하는 경우를 나타냅니다.

MoreHours

특정 유형의 비즈니스를 위해 위치가 영업하는 기간입니다.

JSON 표현 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
필드
hoursTypeId

string

필수 항목입니다. 영업시간 유형입니다. 클라이언트는 {#link businessCategories:BatchGet}을 호출하여 위치 카테고리에 지원되는 영업시간 유형을 가져와야 합니다.
periods[]

object (TimePeriod)

필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

ServiceItem

단일 서비스 항목을 설명하는 메시지입니다. 판매자가 제공하는 서비스 유형을 설명하는 데 사용됩니다. 예를 들어 이발은 서비스가 될 수 있습니다.

JSON 표현 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
필드
price

object (Money)

선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 currencyCode 및 단위를 설정하는 것이 좋습니다. 이는 서비스 항목의 고정 가격으로 처리됩니다.
다음 필드 중 하나는 항상 설정해야 합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
structuredServiceItem

object (StructuredServiceItem)

선택사항입니다. 이 필드는 구조화된 서비스 데이터의 경우에 설정됩니다.
freeFormServiceItem

object (FreeFormServiceItem)

선택사항입니다. 이 필드는 자유 형식 서비스 데이터의 경우에 설정됩니다.
상호 배타적인 필드의 끝입니다.

StructuredServiceItem

판매자가 제공하는 구조화된 서비스를 나타냅니다. 예: toilet_installation

JSON 표현 
{
  "serviceTypeId": string,
  "description": string
}
필드
serviceTypeId

string

필수 항목입니다. serviceTypeId 필드는 Google에서 제공하는 고유 ID로, ServiceType에서 확인할 수 있습니다. 이 정보는 BatchGetCategories RPC 서비스에서 제공합니다.
description

string

선택사항입니다. 구조화된 서비스 항목에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.

FreeFormServiceItem

판매자가 제공하는 자유 형식 서비스를 나타냅니다. 이러한 서비스는 구조화된 서비스 데이터의 일부로 노출되지 않습니다. 판매자는 Geomerchant 표시 경로를 사용하여 이러한 서비스의 이름을 수동으로 입력합니다.

JSON 표현 
{
  "category": string,
  "label": {
    object (Label)
  }
}
필드
category

string

필수 항목입니다. 이 필드는 카테고리 이름 (즉, 카테고리의 안정적인 ID)을 나타냅니다. category 및 serviceTypeId는 Category 메시지에 제공된 가능한 조합과 일치해야 합니다.
label

object (Label)

필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하로 작성하는 것이 좋습니다. 이 필드는 입력이 커스텀 서비스 항목인 경우에만 설정해야 합니다. 표준화된 서비스 유형은 serviceTypeId를 사용하여 업데이트해야 합니다.

라벨

가격 목록, 섹션 또는 상품을 표시할 때 사용되는 라벨입니다.

JSON 표현 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
필드
displayName

string

필수 항목입니다. 가격 목록, 섹션 또는 상품의 표시 이름입니다.
description

string

선택사항입니다. 가격 목록, 섹션 또는 상품의 설명입니다.
languageCode

string

선택사항입니다. 이러한 문자열이 적용되는 BCP-47 언어 코드입니다. 언어당 라벨 세트 하나만 설정할 수 있습니다.

메서드

create

 로그인한 사용자가 소유할 새 위치를 만듭니다.

list

 지정된 계정의 위치를 나열합니다.