REST Resource: 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)

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

방법

delete

 위치를 삭제합니다.

get

 지정된 위치를 반환합니다.

getAttributes

 지정된 위치에 설정된 모든 속성을 조회합니다.

getGoogleUpdated

 지정된 위치의 Google 업데이트 버전을 가져옵니다.

patch

 지정된 위치를 업데이트합니다.

updateAttributes

 지정된 위치의 속성을 업데이트합니다.