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

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

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

integer

PostalAddress의 스키마 버전입니다. 최신 버전인 0으로 설정해야 합니다.

모든 새 버전은 이전 버전과 하위 호환되어야 합니다.
regionCode

string

필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이 값은 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'
languageCode

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 이는 입력 양식의 UI 언어인 경우가 많으며, 주소의 국가/지역에서 사용되는 언어 중 하나 또는 이에 상응하는 음역과 일치할 것으로 예상됩니다. 이는 특정 국가의 형식에 영향을 미칠 수 있지만 데이터의 정확성에는 중요하지 않으며 유효성 검사나 기타 형식과 관련 없는 작업에는 영향을 미치지 않습니다.

이 값을 알 수 없는 경우 잘못된 기본값을 지정하는 대신 생략해야 합니다.

예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.
postalCode

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 요구하는 것은 아니지만, 우편번호를 사용하는 경우 주소의 다른 부분 (예: 미국의 주 또는 우편번호 유효성 검사)과 함께 추가 유효성 검사가 트리거될 수 있습니다.
sortingCode

string

선택사항입니다. 국가별 추가 분류 코드입니다. 대부분의 지역에서는 사용되지 않습니다. 사용되는 경우 값은 'CEDEX'와 같은 문자열이며, 뒤에 숫자 (예: 'CEDEX 7')가 오거나 숫자만으로 '부문 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (코트디부아르)를 나타냅니다.
administrativeArea

string

선택사항입니다. 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 지방, 주(oblast) 또는 현이 될 수 있습니다. 스페인의 경우 자치구가 아닌 주입니다 (예: '카탈루냐'가 아닌 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 항목을 입력하지 않은 상태로 두어야 합니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, 이탈리아 코무네, 영국 우편 도시 지역이 명확하게 정의되지 않거나 이 구조에 잘 맞지 않는 지역에서는 locality를 비워 두고 addressLines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구 또는 구역일 수 있습니다.
addressLines[]

string

주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

addressLines의 값에는 유형 정보가 없으며 단일 필드에 여러 값 (예: 'Austin, TX')이 포함될 수 있으므로 줄 순서가 명확해야 합니다. 주소 입력란의 순서는 주소의 국가 또는 지역에 대한 '봉투 순서'여야 합니다. 이 순서가 달라질 수 있는 지역 (예: 일본)에서는 address_language를 사용하여 명시적으로 지정합니다 (예: 큰 단위에서 작은 단위 순서의 경우 'ja', 작은 단위에서 큰 단위 순서의 경우 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 줄을 선택할 수 있습니다.

허용되는 최소한의 구조적 주소 표현은 regionCode로 구성되며 나머지 모든 정보는 addressLines에 배치됩니다. 지오코딩 없이 이러한 주소의 형식을 대략적으로 지정할 수는 있지만, 주소가 최소한 부분적으로라도 확인되기 전에는 주소 구성요소에 대한 의미론적 추론을 할 수 없습니다.

regionCode 및 addressLines만 포함하는 주소를 만든 다음 지오코딩하는 것이 완전히 구조화되지 않은 주소를 처리하는 데 권장되는 방법입니다 (주소의 어느 부분이 지역 또는 행정 구역인지 추측하는 것과 반대).
recipients[]

string

선택사항입니다. 주소의 수신자입니다. 이 필드에는 특정 상황에서 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '수취인' 정보가 포함될 수 있습니다.
organization

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에 {}가 생성됩니다.

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

integer

24시간 형식의 시간입니다. 0 이상이어야 하며 일반적으로 23 이하여야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes

integer

특정 시간의 분입니다. 0 이상 59 이하여야 합니다.
seconds

integer

1분 기준의 초입니다. 0 이상이어야 하며 일반적으로 59 이하여야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

integer

나노초 단위의 초수입니다. 0 이상, 999,999,999 이하여야 합니다.

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에 지정된 날짜는 위치가 하루 종일 문을 닫은 것으로 처리됩니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

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

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

LatLng

위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

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에서 확인할 수 있습니다. 이 정보는 categories.batchGet 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 언어 코드입니다. 언어당 라벨 세트 하나만 설정할 수 있습니다.

Money

금액과 통화 유형을 나타냅니다.

JSON 표현 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
필드
currencyCode

string

ISO 4217에 정의된 3자리 통화 코드입니다.
units

string (int64 format)

이 금액의 온전한 단위입니다. 예를 들어 currencyCode가 "USD"이면 1단위는 미화 1달러입니다.
nanos

integer

이 금액의 나노 (10^-9) 단위 숫자입니다. 이 값은 -999,999,999~+999,999,999(끝값 포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos는 양수, 0 또는 음수일 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1 및 nanos=-750,000,000으로 나타냅니다.

메서드

create

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

list

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