REST Resource: accounts.locations

리소스: Location

위치 이러한 입력란에 대한 자세한 설명은 고객센터 도움말을 참고하고 유효한 비즈니스 카테고리 목록은 카테고리 엔드포인트를 참고하세요.

JSON 표현 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
필드
name

string

이 위치의 Google 식별자(형식: accounts/{accountId}/locations/{locationId})

일치 컨텍스트에서는 이 필드가 채워지지 않습니다.
languageCode

string

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

string

이 위치의 외부 식별자로, 지정된 계정 내에서 고유해야 합니다. 위치를 자신의 레코드와 연결하는 방법입니다.
locationName

string

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

string

가능한 한 개별 업체 위치로 직접 연결되는 전화번호입니다. 가능하면 중앙의 콜센터 전화번호가 아닌 지역 전화번호를 사용하세요.
additionalPhones[]

string

기본 전화번호 외에 비즈니스에 연락할 수 있는 전화번호 (휴대전화 또는 유선 전화번호)입니다. 최대 2개까지 추가할 수 있으며 팩스 번호는 사용할 수 없습니다.
address

object (PostalAddress)

정확한 주소를 사용해 업체 위치를 설명하세요. 원격 위치에 있는 사서함이나 우편함은 사용할 수 없습니다. 현재는 주소에 최대 5개의 addressLines 값을 지정할 수 있습니다.
primaryCategory

object (Category)

이 위치가 수행하는 핵심 비즈니스를 가장 잘 설명하는 카테고리입니다.
additionalCategories[]

object (Category)

비즈니스를 설명하는 추가 카테고리입니다. 카테고리를 지정해 두면 고객이 관심 있는 서비스를 정확하게 찾을 수 있습니다. 비즈니스 정보를 최신 상태로 정확하게 유지하려면 전체 핵심 비즈니스를 설명하는 카테고리를 가능한 한 적게 사용해야 합니다. 최대한 구체적이면서 주 비즈니스를 대표하는 카테고리를 선택하세요.
websiteUrl

string

이 비즈니스의 URL입니다. 가능하면 모든 위치 또는 브랜드를 나타내는 일반 웹사이트/URL 대신 이 개별 업체 위치를 나타내는 URL을 사용하세요.
regularHours

object (BusinessHours)

비즈니스의 영업시간입니다.
specialHours

object (SpecialHours)

비즈니스의 특별 영업시간입니다. 일반적으로 휴일 영업시간과 정규 영업시간 외의 기타 시간도 포함됩니다. 이 영업시간은 정규 영업시간보다 우선합니다.
serviceArea

object (ServiceAreaBusiness)

방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다. 방문 서비스 업체인 경우, 이 필드는 업체가 서비스를 제공하는 지역을 설명합니다.
locationKey

object (LocationKey)

이 비즈니스를 Google+ 페이지, Google 지도 장소 등 다른 Google 서비스에 연결하는 키 컬렉션입니다.
labels[]

string

비즈니스에 태그를 지정할 수 있는 자유형 문자열 컬렉션입니다. 이러한 라벨은 사용자에게 표시되지 않으며 나만 볼 수 있습니다. 255자(영문 기준)로 제한됩니다(라벨당).
adWordsLocationExtensions

object (AdWordsLocationExtensions)

애드워즈에 표시되는 추가 정보입니다.
latlng

object (LatLng)

사용자가 제공한 위도 및 경도입니다. 위치를 생성할 때 제공된 주소가 성공적으로 지오코딩되면 이 필드는 무시됩니다. 이 필드는 사용자가 제공한 latlng 값이 생성 중에 허용되었거나 latlng 값이 비즈니스 프로필 웹사이트를 통해 업데이트된 경우에만 get 요청 시 반환됩니다. 이 필드는 업데이트할 수 없습니다.
openInfo

object (OpenInfo)

위치가 현재 영업 중인지 여부를 나타내는 플래그.
locationState

object (LocationState)

출력 전용. 위치의 상태를 반영하는 부울 집합입니다.
attributes[]

object (Attribute)

이 위치의 속성입니다.
metadata

object (Metadata)

출력 전용. 사용자가 수정할 수 없는 추가 정보입니다.
priceLists[]
(deprecated)

object (PriceList)

지원 중단됨: 이 위치의 가격 목록 정보입니다.
profile

object (Profile)

비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다.
relationshipData

object (RelationshipData)

이 매장과 관련된 모든 매장 및 체인입니다.
moreHours[]

object (MoreHours)

비즈니스의 여러 부서 또는 특정 고객에 대한 추가 영업시간입니다.

BusinessHours

이 위치의 영업시간을 나타냅니다. TimePeriod 인스턴스 컬렉션을 보유합니다.

JSON 표현 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
필드
periods[]

object (TimePeriod)

이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

TimePeriod

지정된 개장 날짜/시간에 시작해 지정된 종료 날짜/시간에 종료하는 비즈니스의 영업 기간을 나타냅니다. 영업 종료 시간은 시작 시간 뒤(예: 같은 날 이후 시간 또는 이후 날짜)에 와야 합니다.

JSON 표현 
{
  "openDay": enum (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
필드
openDay

enum (DayOfWeek)

이 기간이 시작되는 day of the week를 나타냅니다.
openTime

string

24시간 ISO 8601 확장 형식 (hh:mm) 시간입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.
closeDay

enum (DayOfWeek)

이 기간이 끝나는 day of the week를 나타냅니다.
closeTime

string

24시간 ISO 8601 확장 형식 (hh:mm) 시간입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

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": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
필드
startDate

object (Date)

특별 영업시간 기간이 시작되는 캘린더 날짜입니다.
openTime

string

위치가 개장하는 startDate의 실제 경과 시간으로, 24시간 ISO 8601 확장 형식으로 표시됩니다. (hh:mm) 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. isClosed이 false인 경우 지정해야 합니다.
endDate

object (Date)

특별 영업시간 기간이 종료되는 캘린더 날짜입니다. endDate 필드가 설정되지 않으면 startDate에 지정된 날짜가 기본값입니다. 설정하는 경우 이 필드는 startDate 이후 1일 이하여야 합니다.
closeTime

string

위치가 폐업할 때 endDate의 실제 경과 시간으로, 24시간 ISO 8601 확장 형식으로 표시됩니다. (hh:mm) 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. isClosed이 false인 경우 지정해야 합니다.
isClosed

boolean

true인 경우 endDate, openTime, closeTime는 무시되며 startDate에 지정된 날짜는 위치가 하루 종일 휴업한 것으로 처리됩니다.

ServiceAreaBusiness

방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다 (예: 열쇠공 또는 배관공).

JSON 표현 
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
필드
businessType

enum (BusinessType)

방문 서비스 업체의 type을 나타냅니다.
통합 필드 coverageArea. 비즈니스가 서비스를 제공하는 범위를 나타냅니다. coverageArea은 다음 중 하나여야 합니다.
radius

object (PointRadius)

출력 전용. 이 비즈니스가 서비스를 제공하는 지역이 특정 지점을 중심으로 합니다.
places

object (Places)

이 비즈니스가 서비스를 제공하는 지역이 장소의 집합을 통해 정의됩니다.

BusinessType

이 비즈니스가 고객 위치에서 현장 서비스만 제공하는지 (예: 견인 트럭) 주소와 현장 모두에서 서비스를 제공하는지 (예: 고객에게 배달도 하고 식사 공간이 있는 피자 가게)를 나타냅니다.

열거형
BUSINESS_TYPE_UNSPECIFIED 출력 전용. 지정되지 않음
CUSTOMER_LOCATION_ONLY 주변 지역 (비즈니스 주소가 아닌)에서만 서비스를 제공합니다.
CUSTOMER_AND_BUSINESS_LOCATION 비즈니스 주소 및 주변 지역에서 서비스를 제공합니다.

PointRadius

특정 지점 (위도/경도) 주변의 반경입니다.

JSON 표현 
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
필드
latlng

object (LatLng)

반경으로 정의된 지역의 중심을 지정하는 위도/경도입니다.
radiusKm

number

지점 주변 지역의 거리입니다(킬로미터 단위).

LatLng

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

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

number

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

number

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

Places

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

JSON 표현 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
필드
placeInfos[]

object (PlaceInfo)

장소 ID로 표시되는 지역입니다. 최대 20개 장소로 제한됩니다.

PlaceInfo

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

JSON 표현 
{
  "name": string,
  "placeId": string
}
필드
name

string

장소의 현지화된 이름입니다. Scottsdale, AZ을 예로 들 수 있습니다.
placeId

string

장소의 ID입니다. 리전과 일치해야 합니다.

LocationKey

위치의 대체/서로게이트 키 참조입니다.

JSON 표현 
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
필드
plusPageId

string

출력 전용. 위치에 연결된 Google+ 페이지가 있는 경우 이 위치의 Google+ 페이지 ID로 채워집니다.
placeId

string

이 위치가 인증되어 Google 지도에 연결/표시되는 경우 이 필드는 위치의 장소 ID로 채워집니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다.

위치가 인증되지 않은 경우, 이 필드는 위치가 Google 지도에 표시되는 장소와 연결된 경우 채워집니다.

이 필드는 Create 호출 중에 설정할 수 있지만 Update 호출 중에는 설정할 수 없습니다.

추가 explicitNoPlaceId 부울은 설정되지 않은 장소 ID가 의도적인지 여부를 한정합니다.
explicitNoPlaceId

boolean

출력 전용. true 값은 설정되지 않은 장소 ID가 의도적임을 나타내며, 아직 연결되지 않은 것과는 다릅니다.
requestId

string

출력 전용. 이 위치를 만드는 데 사용된 requestId입니다. 이 위치가 Google My Business API 또는 비즈니스 프로필 위치 외부에서 생성된 경우 비어 있을 수 있습니다.

AdWordsLocationExtensions

애드워즈에 표시되는 추가 정보입니다.

JSON 표현 
{
  "adPhone": string
}
필드
adPhone

string

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

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 위치가 임시 휴업 상태임을 나타냅니다. 이 값은 게시된 위치에만 적용될 수 있습니다 (예: locationState.is_published = true). 상태 필드를 이 값으로 업데이트할 때 클라이언트는 updateMask를 명시적으로 openInfo.status로 설정해야 합니다. 이 업데이트 호출 중에는 다른 업데이트 마스크를 설정할 수 없습니다. 이는 일시적인 제한 조치로 곧 완화됩니다.

LocationState

Location의 상태를 반영하는 부울 집합이 포함됩니다.

JSON 표현 
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
필드
isGoogleUpdated

boolean

출력 전용. 이 위치에 연결된 장소 ID에 업데이트가 있는지 여부를 나타냅니다.
isDuplicate

boolean

출력 전용. 위치가 다른 위치와 중복되는지 여부를 나타냅니다.
isSuspended

boolean

출력 전용. 위치가 정지되었는지 여부를 나타냅니다. 일시중지된 위치는 Google 제품의 최종 사용자에게 표시되지 않습니다. 실수라고 생각되면 고객센터 도움말을 참조하세요.
canUpdate

boolean

출력 전용. 위치를 업데이트할 수 있는지 여부를 나타냅니다.
canDelete

boolean

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

boolean

출력 전용. 위치가 인증되었는지 여부를 나타냅니다.
needsReverification

boolean

출력 전용. 위치에 재인증이 필요한지 여부를 나타냅니다.
isPendingReview

boolean

출력 전용. 위치 검토가 대기 중인지 여부를 나타냅니다.
isDisabled

boolean

출력 전용. 위치가 사용 중지되었는지 여부를 나타냅니다.
isPublished

boolean

출력 전용. 위치의 게시 여부를 나타냅니다.
isDisconnected

boolean

출력 전용. 위치가 Google 지도의 장소와 연결 해제되었는지 여부를 나타냅니다.
isLocalPostApiDisabled

boolean

출력 전용. 이 위치에 accounts.locations.localPosts가 사용 중지되었는지 여부를 나타냅니다.
canModifyServiceList

boolean

출력 전용. 등록정보에서 ServiceList를 수정할 수 있는지 여부를 나타냅니다.
canHaveFoodMenus

boolean

출력 전용. 등록정보가 음식 메뉴에 적합한지 여부를 나타냅니다.
hasPendingEdits

boolean

출력 전용. 이 위치의 속성이 수정 대기 중 상태에 있는지 여부를 나타냅니다.
hasPendingVerification

boolean

출력 전용. 위치에 대기 중인 인증 요청이 있는지 여부를 나타냅니다.
canOperateHealthData

boolean

출력 전용. 위치가 건강 데이터를 활용할 수 있는지를 나타냅니다.
canOperateLodgingData

boolean

출력 전용. 위치가 숙박 시설 데이터에서 운영할 수 있는지 여부를 나타냅니다.

속성

위치 속성입니다. 속성은 위치에 대한 추가 정보를 제공합니다. 위치에 설정할 수 있는 속성은 해당 위치의 속성 (예: 카테고리)에 따라 다를 수 있습니다. 사용 가능한 속성은 Google에서 결정하며 API 변경 없이 추가 및 삭제될 수 있습니다.

JSON 표현 
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
필드
attributeId

string

속성의 ID입니다. 속성 ID는 Google에서 제공합니다.
valueType

enum (AttributeValueType)

출력 전용. 이 속성에 포함된 값의 유형입니다. 값을 해석하는 방법을 결정하는 데 사용해야 합니다.
values[]

value (Value format)

이 속성의 값입니다. 제공된 값의 유형은 해당 속성에 예상되는 유형과 일치해야 합니다. AttributeValueType을 참고하세요. 여러 속성 값을 제공할 수 있는 반복되는 입력란입니다. 속성 유형은 하나의 값만 지원합니다.
repeatedEnumValue

object (RepeatedEnumAttributeValue)

속성 값 유형이 REPEATED_ENUM인 경우 이 속성에 속성 값이 포함되고 다른 값 필드는 비어 있어야 합니다.
urlValues[]

object (UrlAttributeValue)

속성 값 유형이 URL인 경우 이 입력란에는 이 속성의 값이 포함되며 다른 값 입력란은 비어 있어야 합니다.

RepeatedEnumAttributeValue

valueType이 REPEATED_ENUM인 속성의 값입니다. 이는 두 가지 값 ID 목록, 즉 설정된 (true) 목록과 설정되지 않은 (false) 목록으로 구성됩니다. 누락된 값은 알 수 없는 것으로 간주됩니다. 값을 1개 이상 지정해야 합니다.

JSON 표현 
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
필드
setValues[]

string

설정된 열거형 값.
unsetValues[]

string

설정되지 않은 열거형 값.

UrlAttributeValue

URL이 valueType인 속성 값입니다.

JSON 표현 
{
  "url": string
}
필드
url

string

URL입니다.

메타데이터

사용자가 수정할 수 없는 추가 위치 정보입니다.

JSON 표현 
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
필드
duplicate
(deprecated)

object (Duplicate)

이 위치가 중복된 위치에 대한 정보입니다. locationState.is_duplicate가 true인 경우에만 존재합니다. 지원 중단됨: Google에서는 중복 항목에 관한 자세한 정보를 더 이상 지원하지 않습니다.
mapsUrl

string

지도상의 위치에 대한 링크입니다.
newReviewUrl

string

고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지의 링크입니다.

복사

이 위치가 중복된 위치에 대한 정보입니다.

JSON 표현 
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
필드
locationName

string

중복된 위치의 리소스 이름입니다. 인증된 사용자에게 해당 위치에 대한 액세스 권한이 있고 해당 위치가 삭제되지 않은 경우에만 채워집니다.
placeId

string

중복된 위치의 장소 ID입니다.
access

enum (Access)

중복된 위치에 사용자가 액세스할 수 있는지 여부를 나타냅니다.

액세스

중복된 위치에 대한 사용자의 액세스 수준입니다. 이 소유권은 소유권을 대체하며 대신 사용해야 합니다.

열거형
ACCESS_UNSPECIFIED 지정되지 않음
ACCESS_UNKNOWN 사용자가 중복된 위치에 액세스할 수 있는지 확인할 수 없습니다.
ALLOWED 사용자가 동일한 위치에 액세스할 수 있습니다.
INSUFFICIENT 사용자에게 중복된 위치에 액세스할 수 있는 권한이 없습니다.

PriceList

지원 중단됨: 상품 가격 정보 목록입니다. 가격 목록은 1개 이상의 가격 목록으로 구성되며, 각 목록에는 하나 이상의 항목이 포함된 섹션이 하나 이상 포함됩니다. 예를 들어 식품 가격 목록은 버거/스테이크/수산물 섹션이 포함된 아침/점심/저녁 메뉴를 나타낼 수 있습니다.

JSON 표현 
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
필드
priceListId

string

필수 항목입니다. 가격 목록의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다.
labels[]

object (Label)

필수 항목입니다. 언어 태그가 지정된 가격 목록 라벨입니다.
sourceUrl

string

가격 목록을 가져온 소스 URL(선택사항)입니다. 예를 들어 메뉴 정보를 채우기 위해 자동으로 스크랩한 페이지의 URL일 수 있습니다.
sections[]

object (Section)

필수 항목입니다. 이 가격 목록의 섹션입니다. 각 가격 목록에는 하나 이상의 섹션이 포함되어야 합니다.

라벨

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

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

string

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

string

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

string

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

섹션

하나 이상의 항목을 포함하는 가격 목록 섹션입니다.

JSON 표현 
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
필드
sectionId

string

필수 항목입니다. 섹션의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다.
labels[]

object (Label)

필수 항목입니다. 언어 태그가 지정된 섹션 라벨입니다. 섹션 이름과 설명은 140자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.
sectionType

enum (SectionType)

선택사항입니다. 현재 가격 목록 섹션의 유형입니다. 기본값은 FOOD입니다.
items[]

object (Item)

가격 목록의 이 섹션에 포함된 항목입니다.

SectionType

섹션의 유형입니다.

열거형
SECTION_TYPE_UNSPECIFIED 지정되지 않음
FOOD 섹션에 음식을 나타내는 항목이 포함됩니다.
SERVICES 섹션에는 서비스를 나타내는 항목이 포함됩니다.

항목

단일 목록 항목. 가격 목록에 있는 상품의 각 변형에는 자체 가격 데이터가 있는 자체 상품이 있어야 합니다.

JSON 표현 
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
필드
itemId

string

필수 항목입니다. 상품의 ID입니다. 가격 목록, 섹션 및 상품 ID는 이 위치 내에서 중복될 수 없습니다.
labels[]

object (Label)

필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 라벨 집합이 1개 이상 필요합니다.
price

object (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으로 표현됩니다.

프로필

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

JSON 표현 
{
  "description": string
}
필드
description

string

본인의 목소리로 위치를 설명하는 것으로, 다른 사람이 수정할 수 없습니다.

RelationshipData

이 위치와 관련된 모든 상위 및 하위 위치의 정보입니다.

JSON 표현 
{
  "parentChain": string
}
필드
parentChain

string

이 위치가 속한 체인의 리소스 이름입니다. How to find Chain ID

MoreHours

특정 유형의 비즈니스에 위치가 영업하는 기간입니다.

JSON 표현 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
필드
hoursTypeId

string

필수 항목입니다. 시간 유형입니다. 고객은 {#link businessCategories:BatchGet}을(를) 호출하여 위치 카테고리에 대해 지원되는 시간 유형을 가져와야 합니다.
periods[]

object (TimePeriod)

필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

방법

associate

 위치를 장소 ID에 연결합니다.

batchGet

 지정된 계정에서 지정된 모든 위치를 가져옵니다.

batchGetReviews

 지정된 모든 위치의 페이지로 나눈 리뷰 목록을 반환합니다.

clearAssociation

 위치와 장소 ID 간의 연결을 삭제합니다.

create

 지정된 계정이 소유한 새 location를 만들어 반환합니다.

delete

 위치를 삭제합니다.

fetchVerificationOptions

 특정 언어로 된 위치에 대해 요건을 충족하는 모든 인증 옵션을 보고합니다.

findMatches

 지정된 위치와 일치하는 가능한 모든 위치를 찾습니다.

get

 지정된 위치를 가져옵니다.

getFoodMenus

 특정 위치의 음식 메뉴를 반환합니다.

getGoogleUpdated

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

getHealthProviderAttributes

 특정 위치의 의료인 속성을 반환합니다.

getServiceList

 위치의 지정된 서비스 목록을 가져옵니다.

list

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

patch

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

reportInsights

 위치별 측정항목 하나 이상의 통계가 포함된 보고서를 반환합니다.

transfer
(deprecated)

 사용자가 소유한 계정에서 동일한 사용자가 관리하는 다른 계정으로 위치를 이동합니다.

updateFoodMenus

 특정 위치의 음식 메뉴를 업데이트합니다.

updateHealthProviderAttributes

 특정 위치의 의료인 속성을 업데이트합니다.

updateServiceList

 위치의 지정된 서비스 목록을 업데이트합니다.

verify

 위치 인증 절차를 시작합니다.