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 본사'보다 '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 값이 생성 중에 허용되었거나 latlng 값이 Google 비즈니스 프로필 웹사이트를 통해 업데이트된 경우에만 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

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

locality

string

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

sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 지구가 여기에 해당합니다.

addressLines[]

string

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

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

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

(주소의 어떤 부분이 지역인지 또는 행정 구역이어야 하는지 추측하는 대신) 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은 지정된 일 필드 끝의 자정을 나타냅니다.

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.Dategoogle.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시간 미만이어야 합니다. openTimestartDatecloseTimeendDate보다 이전이어야 합니다. closeTimeendDate는 지정된 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년입니다 (예: 기념일).
  • 1년은 자체적으로, 월은 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 비즈니스 주소 및 주변 지역에서 서비스를 제공합니다.

Places

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

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를 호출하여 판매자 목소리가 없는 이유에 대한 세부정보를 가져와야 합니다.

프로필

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

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 이는 하나의 물리적 영역, 동일한 브랜드/상위 관리/조직을 공유하지만 영업시간 또는 전화번호와 같은 다른 주요 속성을 가진 두 위치 간의 관계를 나타냅니다. 예를 들어 코스트코 약국은 코스트코 도매 부문입니다.
INDEPENDENT_ESTABLISHMENT_IN 이는 2개의 위치가 동일한 물리적 위치에 동시에 위치하지만 다른 회사의 경우 (예: 스타벅스는 안전웨이의 스타벅스, 쇼핑몰에 있는 상점)를 나타냅니다.

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)

선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 currencyCode 및 단위를 설정하는 것이 좋습니다. 이 가격은 서비스 항목의 고정 가격으로 처리됩니다.

통합 필드 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 구조 서비스 데이터의 일부로 노출되지 않는 서비스입니다. 판매자는 지오판매자 표시 경로를 통해 이러한 서비스의 이름을 직접 입력합니다.

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

string

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

label

object (Label)

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

라벨

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

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

string

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

description

string

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

languageCode

string

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

통화

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

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

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