이제 Business Profile Performance API가 출시되었습니다. 마이그레이션 작업이 필요합니다.
지원 중단 일정 및 이전 지원 중단된 v4 API에서 새 v1 API로 마이그레이션하는 방법을 검토하세요.
설문조사를 통해 음식 메뉴 환경을 개선할 수 있도록 지원하는 판매자와 관련해 제공할 수 있는 장소, 메뉴, 음식 속성을 알려주세요.

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 Headquarters'보다는 'Google'을 선호). 마케팅 태그라인, 판매점 코드, 특수문자, 영업시간 또는 영업 종료/영업 중, 전화번호, 웹사이트 URL, 서비스/제품 정보, 위치/주소 또는 경로, 봉쇄 정보 (예: Duane Reade의 Chase 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)

Google Ads에 표시되는 추가 정보입니다.

latlng

object (LatLng)

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

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)

비즈니스의 다른 부서 또는 특정 고객에게 더 많은 영업시간을 제공합니다.

영업시간

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

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

object (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은 지정된 날짜 필드의 자정을 나타냅니다.

요일

요일을 나타냅니다.

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

특별 영업시간

위치의 영업시간이 정상 영업시간과 다른 기간을 나타냅니다.

JSON 표현
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
필드
specialHourPeriods[]

object (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": 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에 지정된 날짜가 종일 영업하지 않는 위치로 처리됩니다.

서비스 지역 비즈니스

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

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)

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

비즈니스 유형

이 비즈니스가 고객 위치에서 현장 서비스 (예: 견인차)를 제공할지 주소 및 현장 (예: 식사 공간이 있는 피자 가게에서 고객에게도 배달)을 제공하는지 여부를 나타냅니다.

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

포인트 반경

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

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곳으로 제한됩니다.

장소 정보

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

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

string

장소의 현지화된 이름입니다. 예를 들면 Scottsdale, AZ입니다.

placeId

string

장소의 ID입니다. 리전에 대응해야 합니다.

위치 키

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

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

string

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

placeId

string

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

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

이 필드는 호출 생성 중에 설정할 수 있지만 업데이트에서는 설정할 수 없습니다.

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

explicitNoPlaceId

boolean

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

requestId

string

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

애드워즈 추가 위치 정보

Google Ads에 표시되는 추가 정보입니다.

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

string

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

정보 열기

비즈니스의 개점 상태와 관련된 정보입니다.

JSON 표현
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
필드
status

enum (OpenForBusiness)

위치가 현재 영업 중인지 여부를 나타냅니다. 폐업하도록 업데이트되지 않는 한 기본적으로 모든 위치가 열려 있습니다.

canReopen

boolean

출력 전용. 이 비즈니스가 다시 영업 가능한지 여부를 나타냅니다.

openingDate

object (Date)

위치가 처음 열린 날짜입니다. 정확한 날짜를 알 수 없는 경우 월과 연도만 입력할 수 있습니다. 과거의 날짜이거나 향후 1년 이내의 날짜여야 합니다.

개방형 비즈니스

위치의 상태를 나타냅니다.

열거형
OPEN_FOR_BUSINESS_UNSPECIFIED 지정되지 않음
OPEN 위치가 영업 중임을 나타냅니다.
CLOSED_PERMANENTLY 위치가 폐업했음을 나타냅니다.
CLOSED_TEMPORARILY 위치가 임시 휴업 상태임을 나타냅니다. 이 값은 게시된 위치에만 적용될 수 있습니다 (즉, locationState.is_published = true). 상태 필드를 이 값으로 업데이트할 때 클라이언트에서 updateMask를 명시적으로 openInfo.status로 설정해야 합니다. 이 업데이트 호출 중에는 다른 업데이트 마스크를 설정할 수 없습니다. 이는 일시적인 제한이며 곧 완화될 예정입니다.

위치 상태

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.localPost이 사용 중지되어 있는지 나타냅니다.

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인 경우 이 속성에 해당 속성의 값이 포함되며 다른 값 입력란은 비어 있어야 합니다.

반복 EnumAttributeValue

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

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

string

설정된 Enum 값입니다.

unsetValues[]

string

설정되지 않은 enum 값.

URL 속성 값

URL이 valueType인 속성의 값입니다.

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

string

URL입니다.

메타데이터

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

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

object (Duplicate)

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

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 사용자는 중복 위치에 액세스할 수 없습니다.

가격 목록

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

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 언어 코드입니다. 언어당 한 개의 라벨만 설정할 수 있습니다.

섹션

가격 목록의 섹션으로, 1개 이상의 상품이 포함됩니다.

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

string

필수 항목입니다. 섹션의 ID입니다. 이 위치 내에서 가격 목록, 섹션 및 상품 ID를 복제할 수 없습니다.

labels[]

object (Label)

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

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자(영문 기준) 이하여야 합니다. 라벨 조합이 하나 이상 필요합니다.

price

object (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으로 나타냅니다.

프로필

위치 프로필과 관련된 모든 정보

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

string

자신의 목소리로 위치에 대한 설명으로, 다른 사람이 수정할 수 없습니다.

관계 데이터

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

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

string

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

영업시간 더보기

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

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

string

필수 항목입니다. 영업시간 유형입니다. 고객이 거주 위치의 카테고리에 대해 지원되는 시간 유형을 얻으려면 {#linkbusinessCategory: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

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