- 리소스: Location
- JSON 표현
- PhoneNumbers
- 카테고리
- 카테고리
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- 날짜
- ServiceAreaBusiness
- BusinessType
- 장소
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- 메타데이터
- 프로필
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem을 사용합니다.
- 라벨
- 금액
- 메서드
리소스: Location
위치 이러한 입력란에 대한 자세한 설명은 고객센터 도움말을 참고하고 유효한 비즈니스 카테고리 목록은 카테고리 엔드포인트를 참고하세요.
JSON 표현 |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
필드 | |
---|---|
name |
이 위치의 Google 식별자로, |
languageCode |
변경할 수 없습니다. 위치의 언어입니다. 생성 중에 설정되며 업데이트할 수 없습니다. |
storeCode |
선택사항입니다. 이 위치의 외부 식별자로, 지정된 계정 내에서 고유해야 합니다. 위치를 자신의 레코드와 연결하는 방법입니다. |
title |
필수 항목입니다. 위치 이름은 오프라인 매장, 웹사이트, 회사 서간지에서 일관되게 사용되고 고객에게 알려져 있는 비즈니스의 실제 이름을 반영해야 합니다. 추가 정보는 해당하는 경우 리소스의 다른 필드 (예: |
phoneNumbers |
선택사항입니다. 고객이 비즈니스에 연락하는 데 사용할 수 있는 다양한 전화번호입니다. |
categories |
선택사항입니다. 비즈니스를 설명하는 다양한 카테고리입니다. |
storefrontAddress |
선택사항입니다. 정확한 주소를 사용해 업체 위치를 설명하세요. 원격 위치에 있는 사서함이나 우편함은 사용할 수 없습니다. 현재는 주소에 최대 5개의 |
websiteUri |
선택사항입니다. 이 비즈니스의 URL입니다. 가능하면 모든 위치 또는 브랜드를 나타내는 일반 웹사이트/URL 대신 이 개별 업체 위치를 나타내는 URL을 사용하세요. |
regularHours |
선택사항입니다. 비즈니스의 영업시간입니다. |
specialHours |
선택사항입니다. 비즈니스의 특별 영업시간입니다. 일반적으로 휴일 영업시간과 정규 영업시간 외의 기타 시간도 포함됩니다. 이 영업시간은 정규 영업시간보다 우선합니다. 정규 영업시간 없이는 이 필드를 설정할 수 없습니다. |
serviceArea |
선택사항입니다. 방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다. 방문 서비스 업체인 경우, 이 필드는 업체가 서비스를 제공하는 지역을 설명합니다. |
labels[] |
선택사항입니다. 비즈니스에 태그를 지정할 수 있는 자유형 문자열 컬렉션입니다. 이러한 라벨은 사용자에게 표시되지 않으며 나만 볼 수 있습니다. 라벨당 1~255자(영문 기준)여야 합니다. |
adWordsLocationExtensions |
선택사항입니다. 애드워즈에 표시되는 추가 정보입니다. |
latlng |
선택사항입니다. 사용자가 제공한 위도 및 경도입니다. 위치를 생성할 때 제공된 주소가 성공적으로 지오코딩되면 이 필드는 무시됩니다. 이 필드는 사용자가 제공한 |
openInfo |
선택사항입니다. 위치가 현재 영업 중인지 여부를 나타내는 플래그. |
metadata |
출력 전용. 사용자가 수정할 수 없는 추가 정보입니다. |
profile |
선택사항입니다. 비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다. 이 입력란은 숙박 시설 카테고리 (예: 호텔, 모텔, 여관)를 제외한 모든 카테고리에서 필수입니다. |
relationshipData |
선택사항입니다. 이 매장과 관련된 모든 매장 및 체인입니다. |
moreHours[] |
선택사항입니다. 비즈니스의 여러 부서 또는 특정 고객에 대한 추가 영업시간입니다. |
serviceItems[] |
선택사항입니다. 판매자가 지원하는 서비스 목록입니다. 이발, 온수기 설치 등의 서비스가 제공될 수 있습니다. 중복된 서비스 항목은 자동으로 삭제됩니다. |
PhoneNumbers
비즈니스의 전화번호 모음입니다. 업데이트 중에는 두 필드를 모두 설정해야 합니다. 클라이언트는 업데이트 마스크를 사용하여 기본 전화번호 또는 추가 전화번호만 업데이트할 수 없습니다. '+1 415 555 0132'와 같은 국제 전화 형식을 사용하는 것이 좋습니다. (https://developers.google.com/style/phone-numbers#international-phone-numbers)에서 자세한 내용을 확인하세요.
JSON 표현 |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
필드 | |
---|---|
primaryPhone |
필수 항목입니다. 가능한 한 개별 업체 위치로 직접 연결되는 전화번호입니다. 가능하면 중앙의 콜센터 전화번호가 아닌 지역 전화번호를 사용하세요. |
additionalPhones[] |
선택사항입니다. 기본 전화번호 외에 비즈니스에 연락할 수 있는 전화번호 (휴대전화 또는 유선 전화번호)입니다. 최대 2개까지 추가할 수 있으며 팩스 번호는 사용할 수 없습니다. |
카테고리
비즈니스를 설명하는 카테고리 모음입니다. 업데이트 중에는 두 필드를 모두 설정해야 합니다. 클라이언트가 업데이트 마스크를 사용하여 기본 카테고리 또는 추가 카테고리를 개별적으로 업데이트할 수 없습니다.
JSON 표현 |
---|
{ "primaryCategory": { object ( |
필드 | |
---|---|
primaryCategory |
필수 항목입니다. 이 위치가 수행하는 핵심 비즈니스를 가장 잘 설명하는 카테고리입니다. |
additionalCategories[] |
선택사항입니다. 비즈니스를 설명하는 추가 카테고리입니다. 카테고리를 지정해 두면 고객이 관심 있는 서비스를 정확하게 찾을 수 있습니다. 비즈니스 정보를 최신 상태로 정확하게 유지하려면 전체 핵심 비즈니스를 설명하는 카테고리를 가능한 한 적게 사용해야 합니다. 최대한 구체적이면서 주 비즈니스를 대표하는 카테고리를 선택하세요. |
카테고리
이 비즈니스의 업무 내용이 아니라 업종을 설명하는 카테고리입니다. 유효한 카테고리 ID 목록과 사람이 읽을 수 있는 이름에 대한 매핑은 categories.list
를 참고하세요.
JSON 표현 |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
필드 | |
---|---|
name |
필수 항목입니다. 이 카테고리의 안정적인 ID입니다 (Google에서 제공). 카테고리를 수정할 때 (위치를 만들거나 업데이트할 때) 값을 지정해야 합니다. |
displayName |
출력 전용. 사람이 읽을 수 있는 카테고리 이름입니다. 위치를 읽을 때 설정됩니다. 위치를 수정할 때는 |
serviceTypes[] |
출력 전용. 이 비즈니스 카테고리에 사용할 수 있는 모든 서비스 유형의 목록입니다. |
moreHoursTypes[] |
출력 전용. 이 비즈니스 카테고리에 사용할 수 있는 기타 영업시간 유형입니다. |
ServiceType
비즈니스에서 제공하는 서비스 유형을 설명하는 메시지입니다.
JSON 표현 |
---|
{ "serviceTypeId": string, "displayName": string } |
필드 | |
---|---|
serviceTypeId |
출력 전용. 이 서비스 유형의 안정적인 ID입니다 (Google에서 제공). |
displayName |
출력 전용. 사람이 읽을 수 있는 서비스 유형의 표시 이름입니다. |
MoreHoursType
정상 영업시간 외에 비즈니스에서 제공할 수 있는 추가 영업시간 유형입니다.
JSON 표현 |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
필드 | |
---|---|
hoursTypeId |
출력 전용. Google에서 이 영업시간 유형에 제공하는 안정적인 ID입니다. |
displayName |
출력 전용. 사람이 읽을 수 있는 시간 유형의 영어 표시 이름입니다. |
localizedDisplayName |
출력 전용. 사람이 읽을 수 있는 시간 유형의 현지화된 표시 이름입니다. |
PostalAddress
우편 배달 또는 수취인 주소와 같은 우편 주소를 나타냅니다. 우편 주소가 있으면 우편 서비스가 사업장, 사서함 또는 이와 유사한 주소로 물건을 배송할 수 있습니다. 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것은 아닙니다.
일반적인 용도에서는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터를 가져와 주소가 생성됩니다.
주소 입력 / 수정 관련 조언: - 국제화가 가능한 주소 위젯(예: https://github.com/google/libaddressinput) 사용 - 해당 입력란이 사용되는 국가 이외의 지역에서 입력란을 입력하거나 수정할 수 있는 UI 요소가 사용자에게 제공되어서는 안 됩니다.
이 스키마를 사용하는 방법에 대한 자세한 안내는 https://support.google.com/business/answer/6397478을 참조하세요.
JSON 표현 |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
필드 | |
---|---|
revision |
모든 새 버전은 이전 버전과 반드시 호환되어야 합니다. |
regionCode |
필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이는 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'. |
languageCode |
선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 주로 입력 양식의 UI 언어이거나 주소의 국가/지역에서 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 이는 특정 국가에서 형식에 영향을 줄 수 있지만 데이터의 정확성에는 중요하지 않으며 유효성 검사 또는 기타 형식 지정과 관련 없는 작업에는 영향을 미치지 않습니다. 이 값을 알 수 없는 경우 잘못되었을 수 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다. 예: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postalCode |
선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호를 필수로 사용해야 하는 것은 아니지만, 우편번호가 사용되는 경우 주소의 다른 부분에서 추가 확인 (예: 미국의 주/우편번호 확인)이 트리거될 수 있습니다. |
sortingCode |
선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용되는 경우 값은 선택적으로 뒤에 숫자가 오는 'CEDEX'와 같은 문자열 (예: 'CEDEX 7')이거나 '섹터 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (예: 코트디부아르)를 나타내는 숫자만 있습니다. |
administrativeArea |
선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 시/도, 주 또는 현이 될 수 있습니다. 특히 스페인의 경우 자치 공동체가 아닌 주입니다 (예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다. |
locality |
선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮌, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다. |
sublocality |
선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 지구가 여기에 해당합니다. |
addressLines[] |
주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. addressLines의 값에는 유형 정보가 없고 경우에 따라 단일 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역의 '봉투 순서'여야 합니다. 다양한 지역 (예: 일본)에서는 address_language를 사용하여 명시적으로 만듭니다 (예: 큰 대 작은 순서의 경우 'ja', 크고 작은 순서의 경우 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 입력란을 선택할 수 있습니다. 주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 이러한 주소의 형식은 지오코딩 없이 매우 대략적으로만 가능하지만, 최소한 부분적으로 해결될 때까지는 어떤 주소 구성 요소도 의미적 추론을 할 수 없습니다. (주소의 어떤 부분이 지역인지 또는 행정 구역이어야 하는지 추측하는 대신) regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩하는 것이 완전히 구조화되지 않은 주소를 처리하는 권장 방법입니다. |
recipients[] |
선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에는 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '돌봄' 정보가 포함될 수 있습니다. |
organization |
선택사항입니다. 주소에 있는 조직의 이름입니다. |
BusinessHours
이 위치의 영업시간을 나타냅니다. [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] 인스턴스 컬렉션을 보유합니다.
JSON 표현 |
---|
{
"periods": [
{
object ( |
필드 | |
---|---|
periods[] |
필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다. |
TimePeriod
지정된 개장 날짜/시간에 시작해 지정된 종료 날짜/시간에 종료하는 비즈니스의 영업 기간을 나타냅니다. 영업 종료 시간은 시작 시간 뒤(예: 같은 날 이후 시간 또는 이후 날짜)에 와야 합니다.
JSON 표현 |
---|
{ "openDay": enum ( |
필드 | |
---|---|
openDay |
필수 항목입니다. 이 기간이 시작되는 |
openTime |
필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. |
closeDay |
필수 항목입니다. 이 기간이 끝나는 |
closeTime |
필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. |
DayOfWeek
요일을 나타냅니다.
열거형 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
요일이 지정되지 않습니다. |
MONDAY |
월요일 |
TUESDAY |
화요일 |
WEDNESDAY |
수요일 |
THURSDAY |
목요일 |
FRIDAY |
금요일 |
SATURDAY |
토요일 |
SUNDAY |
일요일 |
TimeOfDay
하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date
및 google.protobuf.Timestamp
입니다.
JSON 표현 |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
필드 | |
---|---|
hours |
24시간 형식의 시간입니다. 0~23 사이의 값이어야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다. |
minutes |
특정 시간의 분입니다. 0~59 사이의 값이어야 합니다. |
seconds |
특정 분의 초입니다. 일반적으로 0~59 사이의 값이어야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다. |
nanos |
나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 합니다. |
SpecialHours
위치의 영업시간이 정상 영업시간과 다른 기간 집합을 나타냅니다.
JSON 표현 |
---|
{
"specialHourPeriods": [
{
object ( |
필드 | |
---|---|
specialHourPeriods[] |
필수 항목입니다. 비즈니스의 정규 영업시간에 대한 예외 목록입니다. |
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 ( |
필드 | |
---|---|
startDate |
필수 항목입니다. 특별 영업시간 기간이 시작되는 캘린더 날짜입니다. |
openTime |
선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. |
endDate |
선택사항입니다. 특별 영업시간 기간이 종료되는 캘린더 날짜입니다. |
closeTime |
선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. |
closed |
선택사항입니다. true인 경우 |
날짜
생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0년입니다 (예: 기념일).
- 1년은 자체적으로, 월은 0이고 나머지는 0일입니다.
- 연도와 월을 0일로 표시 (예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
필드 | |
---|---|
year |
날짜의 연도입니다. 1~9999 사이의 값이어야 합니다. 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
월입니다. 1~12 사이의 값이어야 합니다. 월과 일 없이 연도를 지정하려면 0과 같아야 합니다. |
day |
날짜입니다. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다. |
ServiceAreaBusiness
방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다 (예: 열쇠공 또는 배관공).
JSON 표현 |
---|
{ "businessType": enum ( |
필드 | |
---|---|
businessType |
필수 항목입니다. 방문 서비스 업체의 [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] 을 나타냅니다. |
places |
이 비즈니스가 서비스를 제공하는 지역이 장소의 집합을 통해 정의됩니다. |
regionCode |
변경할 수 없습니다. 이 서비스 지역 비즈니스가 위치한 국가/지역의 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 |
비즈니스 주소 및 주변 지역에서 서비스를 제공합니다. |
Places
장소 집합으로 표시되는 지역의 합집합을 정의합니다.
JSON 표현 |
---|
{
"placeInfos": [
{
object ( |
필드 | |
---|---|
placeInfos[] |
장소 ID로 표시되는 지역입니다. 최대 20개 장소로 제한됩니다. |
PlaceInfo
장소 ID로 표시되는 지역을 정의합니다.
JSON 표현 |
---|
{ "placeName": string, "placeId": string } |
필드 | |
---|---|
placeName |
필수 항목입니다. 장소의 현지화된 이름입니다. |
placeId |
필수 항목입니다. 장소의 ID입니다. 리전과 일치해야 합니다. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
애드워즈에 표시되는 추가 정보입니다.
JSON 표현 |
---|
{ "adPhone": string } |
필드 | |
---|---|
adPhone |
필수 항목입니다. 위치의 기본 전화번호 대신 애드워즈 위치 광고 확장에 표시되는 대체 전화번호입니다. |
LatLng
위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
JSON 표현 |
---|
{ "latitude": number, "longitude": number } |
필드 | |
---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-180.0, +180.0]여야 합니다. |
OpenInfo
비즈니스의 영업 상태와 관련된 정보입니다.
JSON 표현 |
---|
{ "status": enum ( |
필드 | |
---|---|
status |
필수 항목입니다. 위치가 현재 영업 중인지 여부를 나타냅니다. 영업 종료 상태로 업데이트되지 않는 한 기본적으로 모든 위치는 영업 상태입니다. |
canReopen |
출력 전용. 비즈니스를 재개점할 수 있는지 여부를 나타냅니다. |
openingDate |
선택사항입니다. 위치가 처음 문을 연 날짜입니다. 정확한 날짜를 알 수 없는 경우 월과 연도만 제공될 수 있습니다. 날짜는 과거이거나 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 } |
필드 | |
---|---|
hasGoogleUpdated |
출력 전용. 이 위치와 연결된 장소 ID에 클라이언트가 업데이트하거나 거부해야 하는 업데이트가 있는지 여부를 나타냅니다. 이 불리언이 설정되면 |
hasPendingEdits |
출력 전용. 이 위치의 속성이 수정 대기 중 상태에 있는지 여부를 나타냅니다. |
canDelete |
출력 전용. API를 사용하여 위치를 삭제할 수 있는지 여부를 나타냅니다. |
canOperateLocalPost |
출력 전용. 비즈니스 정보가 지역 게시물을 관리할 수 있는지를 나타냅니다. |
canModifyServiceList |
출력 전용. 비즈니스 정보가 서비스 목록을 수정할 수 있는지를 나타냅니다. |
canHaveFoodMenus |
출력 전용. 등록정보가 음식 메뉴에 적합한지 여부를 나타냅니다. |
canOperateHealthData |
출력 전용. 위치가 건강 데이터를 활용할 수 있는지를 나타냅니다. |
canOperateLodgingData |
출력 전용. 위치가 숙박 시설 데이터에서 운영할 수 있는지 여부를 나타냅니다. |
placeId |
출력 전용. 이 위치가 Google 지도에 표시되면 이 필드는 위치의 장소 ID로 채워집니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다. 이 필드는 Create 호출 중에 설정할 수 있지만 Update 호출 중에는 설정할 수 없습니다. |
duplicateLocation |
출력 전용. 이 위치가 복제하는 위치 리소스입니다. |
mapsUri |
출력 전용. 지도상의 위치에 대한 링크입니다. |
newReviewUri |
출력 전용. 고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지의 링크입니다. |
canHaveBusinessCalls |
출력 전용. 비즈니스 정보에 비즈니스 전화를 걸 수 있는지 여부를 나타냅니다. |
hasVoiceOfMerchant |
출력 전용. 등록정보에 판매자 음성이 포함되어 있는지 나타냅니다. 이 부울이 false인 경우 locations.getVoiceOfMerchantState API를 호출하여 판매자 목소리가 없는 이유에 대한 세부정보를 가져와야 합니다. |
프로필
위치 프로필과 관련된 모든 정보입니다.
JSON 표현 |
---|
{ "description": string } |
필드 | |
---|---|
description |
필수 항목입니다. 본인의 목소리로 위치를 설명하는 것으로, 다른 사람이 수정할 수 없습니다. |
RelationshipData
이 위치와 관련된 모든 상위 및 하위 위치의 정보입니다.
JSON 표현 |
---|
{ "parentLocation": { object ( |
필드 | |
---|---|
parentLocation |
이 위치와 관계가 있는 상위 위치입니다. |
childrenLocations[] |
이 위치와 관계가 있는 하위 위치의 목록입니다. |
parentChain |
이 위치가 속한 체인의 리소스 이름입니다. [체인 ID를 찾는 방법] [Locations.SearchChains] |
RelevantLocation
현재 위치와 관련된 다른 위치에 관한 정보입니다. 관계는 DEPARTMENT_OF 또는 INDEPENDENT_ESTABLISHMENT_OF 중 하나일 수 있으며, 여기에 지정된 위치는 위치의 어느 쪽 (상위/하위)에 있을 수 있습니다.
JSON 표현 |
---|
{
"placeId": string,
"relationType": enum ( |
필드 | |
---|---|
placeId |
필수 항목입니다. 관계의 다른 쪽에 있는 위치를 placeID로 지정합니다. |
relationType |
필수 항목입니다. 관계 유형입니다. |
RelationType
지정할 유형 관계입니다.
열거형 | |
---|---|
RELATION_TYPE_UNSPECIFIED |
유형이 지정되지 않습니다. |
DEPARTMENT_OF |
이는 하나의 물리적 영역, 동일한 브랜드/상위 관리/조직을 공유하지만 영업시간 또는 전화번호와 같은 다른 주요 속성을 가진 두 위치 간의 관계를 나타냅니다. 예를 들어 코스트코 약국은 코스트코 도매 부문입니다. |
INDEPENDENT_ESTABLISHMENT_IN |
이는 2개의 위치가 동일한 물리적 위치에 동시에 위치하지만 다른 회사의 경우 (예: 스타벅스는 안전웨이의 스타벅스, 쇼핑몰에 있는 상점)를 나타냅니다. |
MoreHours
특정 유형의 비즈니스에 위치가 영업하는 기간입니다.
JSON 표현 |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
필드 | |
---|---|
hoursTypeId |
필수 항목입니다. 시간 유형입니다. 고객은 {#link businessCategories:BatchGet}을(를) 호출하여 위치 카테고리에 대해 지원되는 시간 유형을 가져와야 합니다. |
periods[] |
필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다. |
ServiceItem
단일 서비스 항목을 설명하는 메시지입니다. 판매자가 제공하는 서비스 유형을 설명하는 데 사용됩니다. 예를 들어 이발은 서비스가 될 수 있습니다.
JSON 표현 |
---|
{ "price": { object ( |
필드 | |
---|---|
price |
선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 currencyCode 및 단위를 설정하는 것이 좋습니다. 이 가격은 서비스 항목의 고정 가격으로 처리됩니다. |
통합 필드 service_item_info . 다음 필드 중 하나를 항상 설정해야 합니다. service_item_info 은 다음 중 하나여야 합니다. |
|
structuredServiceItem |
선택사항입니다. 이 필드는 구조화된 서비스 데이터의 케이스로 설정됩니다. |
freeFormServiceItem |
선택사항입니다. 이 필드는 자유 형식 서비스 데이터의 경우로 설정됩니다. |
StructuredServiceItem
판매자가 제공하는 구조화된 서비스를 나타냅니다. 예: toilet_installation
JSON 표현 |
---|
{ "serviceTypeId": string, "description": string } |
필드 | |
---|---|
serviceTypeId |
필수 항목입니다. |
description |
선택사항입니다. 구조화된 서비스 항목에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다. |
FreeFormServiceItem
판매자가 제공하는 자유 형식의 서비스를 나타냅니다. Google 구조 서비스 데이터의 일부로 노출되지 않는 서비스입니다. 판매자는 지오판매자 표시 경로를 통해 이러한 서비스의 이름을 직접 입력합니다.
JSON 표현 |
---|
{
"category": string,
"label": {
object ( |
필드 | |
---|---|
category |
필수 항목입니다. 이 필드는 카테고리 이름 (카테고리의 안정적인 ID)을 나타냅니다. |
label |
필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 이 필드는 입력이 맞춤 서비스 항목인 경우에만 설정해야 합니다. 표준화된 서비스 유형은 serviceTypeId를 통해 업데이트해야 합니다. |
라벨
가격 목록, 섹션 또는 상품을 표시할 때 사용되는 라벨입니다.
JSON 표현 |
---|
{ "displayName": string, "description": string, "languageCode": string } |
필드 | |
---|---|
displayName |
필수 항목입니다. 가격 목록, 섹션 또는 상품의 표시 이름입니다. |
description |
선택사항입니다. 가격 목록, 섹션 또는 상품의 설명입니다. |
languageCode |
선택사항입니다. 이러한 문자열이 적용되는 BCP-47 언어 코드입니다. 언어당 하나의 라벨 집합만 설정할 수 있습니다. |
통화
통화 유형의 금액을 나타냅니다.
JSON 표현 |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
필드 | |
---|---|
currencyCode |
ISO 4217에 정의된 3자리 통화 코드입니다. |
units |
금액의 전체 단위입니다. 예를 들어 |
nanos |
금액의 나노 (10^-9) 단위 수입니다. 이 값은 -999,999,999 ~ +999,999,999(포함) 사이여야 합니다. |
방법 |
|
---|---|
|
로그인한 사용자가 소유할 새 위치를 만듭니다. |
|
지정된 계정의 위치를 나열합니다. |