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

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

string

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

string

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

string

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

우편 주소를 나타냅니다. 예: 우편번호를 입력하세요. 우편 주소가 주어지면 우편 서비스는 사업장(P.O. Box 또는 이와 유사한 제품 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것이 아닙니다.

일반적으로 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터 가져오기를 통해 만들어집니다.

주소 입력 / 수정에 관한 조언: - 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

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

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮤, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다.
sublocality

string

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

string

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

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

주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 지오코딩을 사용하지 않고도 이러한 주소의 형식을 대략적으로 지정할 수는 있지만, 최소한 부분적으로만 해결될 때까지는 주소 구성 요소에 대해 의미론적 추론을 할 수 없습니다.

지역 또는 행정 구역에 해당하는 부분을 추측하는 대신, regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩을 사용하여 완전히 구조화되지 않은 주소를 처리하는 것이 좋습니다.
recipients[]

string

선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 'care of'라는 단어와 확인할 수 있습니다
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은 지정된 일 필드 끝의 자정을 나타냅니다.
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

필수 항목입니다. 유효한 값은 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

integer

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

integer

특정 시간의 분입니다. 0~59 사이의 값이어야 합니다.
seconds

integer

특정 분의 초입니다. 일반적으로 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)

필수 항목입니다. [type]을 나타냅니다. 방문 서비스 업체의 [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
}
필드
hasGoogleUpdated

boolean

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

boolean

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

boolean

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

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를 호출하여 Voice of Merchant가 없는 이유에 대한 세부정보를 가져와야 합니다.

프로필

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

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)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
필드
price

object (Money)

선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 통화 코드 및 단위를 설정하는 것이 좋습니다. 이 금액은 서비스 항목의 고정 가격으로 처리됩니다.
통합 필드 service_item_info. 다음 필드 중 하나를 항상 설정해야 합니다. service_item_info은 다음 중 하나여야 합니다.
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

판매자가 제공하는 자유 형식 서비스를 나타냅니다. 이러한 서비스는 Google의 구조 서비스 데이터의 일부로 노출되지 않는 서비스입니다. 판매자는 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달러(USD)입니다.
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

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