REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

string

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

string

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

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

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

object (Category)

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

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

string

필수 항목입니다. 이 카테고리의 안정적인 ID입니다 (Google에서 제공). 카테고리를 수정할 때 (위치를 만들거나 업데이트할 때) 이 값을 지정해야 합니다.

string

출력 전용입니다. 사람이 읽을 수 있는 카테고리 이름입니다. 위치를 읽을 때 설정됩니다. 위치를 수정할 때 category_id를 설정해야 합니다.

object (ServiceType)

출력 전용입니다. 이 비즈니스 카테고리에 사용할 수 있는 모든 서비스 유형의 목록입니다.

object (MoreHoursType)

출력 전용입니다. 이 비즈니스 카테고리에 사용할 수 있는 추가 영업시간 유형입니다.

{
  "serviceTypeId": string,
  "displayName": string
}

string

출력 전용입니다. 이 서비스 유형의 안정적인 ID (Google에서 제공)입니다.

string

출력 전용입니다. 사람이 읽을 수 있는 서비스 유형의 표시 이름입니다.

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

출력 전용입니다. 이 시간 유형에 대해 Google에서 제공하는 안정적인 ID입니다.

string

출력 전용입니다. 시간 유형의 사람이 읽을 수 있는 영어 표시 이름입니다.

string

출력 전용입니다. 시간 유형의 인간이 읽을 수 있는 현지화된 표시 이름입니다.

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

PostalAddress의 스키마 버전입니다. 최신 버전인 0으로 설정해야 합니다.

모든 새 버전은 이전 버전과 호환되어야 합니다.

string

필수 항목입니다. 주소의 국가/지역의 CLDR 지역 코드입니다. 이는 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 몫입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 'CH' 되었습니다.

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (아는 경우). 대개 입력 양식의 UI 언어이거나 주소에 사용된 언어 중 하나와 일치해야 합니다. 국가/지역 또는 음역된 언어로 된 언어입니다. 이는 특정 국가에서 형식에 영향을 줄 수 있지만 데이터의 정확성에 중요하지는 않으며 유효성 검사 또는 기타 형식 지정 이외의 관련 작업에는 영향을 미치지 않습니다.

이 값을 알 수 없는 경우, 잘못될 가능성이 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다.

예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 표시해야 하는 것은 아니지만, 우편번호가 사용되는 지역에서는 주소의 다른 부분에 대한 추가 유효성 검사 (예: 미국의 주/우편번호 유효성 검사)가 트리거될 수 있습니다.

string

선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용할 경우 값은 'CEDEX'와 같이 선택적으로 뒤에 숫자가 오는 문자열 (예: 'CEDEX 7')이거나 '섹터 코드'를 나타내는 숫자만 사용할 수 있습니다. (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 지표' (예: 코트디부아르)

string

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

string

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

string

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

string

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

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

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

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

string

선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 'care of'라는 단어와 확인할 수 있습니다

string

선택사항입니다. 주소에 있는 조직의 이름입니다.

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

object (TimePeriod)

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

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

enum (DayOfWeek)

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

object (TimeOfDay)

필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.

enum (DayOfWeek)

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

object (TimeOfDay)

필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

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

integer

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

integer

특정 분의 초입니다. 일반적으로 0~59 사이의 값이어야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.

integer

나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 합니다.

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

필수 항목입니다. 비즈니스의 정규 영업시간에 대한 예외 목록입니다.

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

object (Date)

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

object (TimeOfDay)

선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. closed가 false인 경우 지정해야 합니다.

object (Date)

선택사항입니다. 특별 영업시간 기간이 종료되는 캘린더 날짜입니다. endDate 필드가 설정되지 않으면 startDate에 지정된 날짜가 기본값입니다. 설정하는 경우 이 필드는 startDate 이후 최대 1일과 같거나 그 이후여야 합니다.

object (TimeOfDay)

선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. closed가 false인 경우 지정해야 합니다.

boolean

선택사항입니다. true인 경우 endDate, openTime, closeTime는 무시되며 startDate에 지정된 날짜는 위치가 하루 종일 폐업한 것으로 간주됩니다.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

필수 항목입니다. [type]을 나타냅니다. 방문 서비스 업체의 [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] 입니다.

object (Places)

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

string

변경할 수 없습니다. 이 서비스 지역 비즈니스가 위치한 국가/지역의 CLDR 지역 코드입니다. 자세한 내용은 http://cldr.unicode.org/ 및 http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참조하세요. 예: 'CH' 되었습니다.

이 입력란은 CUSTOMER_LOCATION_ONLY 비즈니스에 필수이며 그 외의 경우에는 무시됩니다.

여기에 지정된 지역은 비즈니스가 서비스를 제공하는 지역과 다를 수 있습니다 (예: 운영 중인 지역이 아닌 다른 지역에서 서비스를 제공하는 방문 서비스 업체).

생성 후 이 위치에 대한 인증이 필요한 경우 인증 목적으로 제공된 주소가 이 지역 내에 있어야 하며 비즈니스 소유자 또는 공식 대리인이 제공된 인증 주소로 우편물을 받을 수 있어야 합니다.

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

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

{
  "placeName": string,
  "placeId": string
}

string

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

string

필수 항목입니다. 장소의 ID입니다. 지역과 일치해야 합니다. (https://developers.google.com/places/web-service/supported_types#table3)

{
  "adPhone": string
}

string

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

enum (OpenForBusiness)

필수 항목입니다. 위치가 현재 영업 중인지 여부를 나타냅니다. 영업 종료 상태로 업데이트되지 않는 한 기본적으로 모든 위치는 영업 상태입니다.

boolean

출력 전용입니다. 비즈니스를 재개점할 수 있는지 여부를 나타냅니다.

object (Date)

선택사항입니다. 위치가 처음 문을 연 날짜입니다. 정확한 날짜를 알 수 없는 경우 월과 연도만 제공될 수 있습니다. 날짜는 과거이거나 1년 이내여야 합니다.

{
  "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
}

boolean

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

boolean

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

boolean

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

boolean

출력 전용입니다. 비즈니스 정보가 지역 게시물을 관리할 수 있는지 여부를 나타냅니다.

boolean

출력 전용입니다. 비즈니스 정보가 서비스 목록을 수정할 수 있는지 여부를 나타냅니다.

boolean

출력 전용입니다. 비즈니스 정보가 음식 메뉴를 사용할 수 있는지 여부를 나타냅니다.

boolean

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

boolean

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

string

출력 전용입니다. 이 위치가 Google 지도에 표시되면 이 필드에 위치의 장소 ID가 입력됩니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다.

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

string

출력 전용입니다. 이 위치가 복제하는 위치 리소스입니다.

string

출력 전용입니다. 지도상의 위치에 대한 링크입니다.

string

출력 전용입니다. 고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지로 연결되는 링크입니다.

boolean

출력 전용입니다. 비즈니스 정보가 비즈니스에 전화를 걸 수 있는지 여부를 나타냅니다.

boolean

출력 전용입니다. 등록정보에 판매자 음성이 있는지 여부를 나타냅니다. 이 불리언이 false인 경우 locations.getVoiceOfMerchantState API를 호출하여 Voice of Merchant가 없는 이유에 대한 세부정보를 가져와야 합니다.

{
  "description": string
}

string

필수 항목입니다. 자신의 음성으로 위치 설명. 다른 사람이 수정할 수 없음

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

이 위치와 관계가 있는 상위 위치입니다.

object (RelevantLocation)

이 위치와 관계가 있는 하위 위치의 목록입니다.

string

이 위치가 속한 체인의 리소스 이름입니다. [체인 ID 찾는 방법] [Locations.SearchChains]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

필수 항목입니다. PlaceID로 관계의 다른 쪽에 있는 위치를 지정합니다.

enum (RelationType)

필수 항목입니다. 관계의 유형입니다.

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

string

필수 항목입니다. 시간 유형입니다. 고객이 위치 카테고리의 지원되는 영업시간 유형을 확인하려면 {#link businessCategories:BatchGet}을 호출해야 합니다.

object (TimePeriod)

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

{
  "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.
}

object (Money)

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

object (StructuredServiceItem)

선택사항입니다. 이 필드는 구조화된 서비스 데이터의 케이스가 설정됩니다.

object (FreeFormServiceItem)

선택사항입니다. 자유 형식 서비스 데이터의 경우 이 필드가 설정됩니다.

{
  "serviceTypeId": string,
  "description": string
}

string

필수 항목입니다. serviceTypeId 필드는 Google에서 제공하는 고유 ID로 ServiceType에서 확인할 수 있습니다. 이 정보는 categories.batchGet RPC 서비스에서 제공합니다.

string

선택사항입니다. 구조화된 서비스 항목의 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.

{
  "category": string,
  "label": {
    object (Label)
  }
}

string

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

object (Label)

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

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

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

string

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

string

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

ISO 4217에 정의된 3자리 통화 코드입니다.

string (int64 format)

금액의 전체 단위입니다. 예를 들어 currencyCode가 "USD"이면 단위 1개는 1달러(USD)입니다.

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