Package google.mybusiness.businessinformation.v1

색인

• AttributesService(인터페이스)
• CategoriesService(인터페이스)
• Chains(인터페이스)
• GoogleLocations(인터페이스)
• Locations(인터페이스)
• AdWordsLocationExtensions(메시지)
• Attribute(메시지)
• AttributeMetadata(메시지)
• AttributeMetadata.AttributeValueMetadata(메시지)
• AttributeValueType(열거형)
• Attributes(메시지)
• BatchGetCategoriesRequest(메시지)
• BatchGetCategoriesResponse(메시지)
• BusinessHours(메시지)
• Categories(메시지)
• Category(메시지)
• CategoryView(열거형)
• Chain(메시지)
• Chain.ChainName(메시지)
• Chain.ChainUri(메시지)
• CreateLocationRequest(메시지)
• DeleteLocationRequest(메시지)
• ErrorCode(열거형)
• GetAttributesRequest(메시지)
• GetChainRequest(메시지)
• GetGoogleUpdatedAttributesRequest(메시지)
• GetGoogleUpdatedLocationRequest(메시지)
• GetLocationRequest(메시지)
• GoogleLocation(메시지)
• GoogleUpdatedLocation(메시지)
• Label(메시지)
• ListAttributeMetadataRequest(메시지)
• ListAttributeMetadataResponse(메시지)
• ListCategoriesRequest(메시지)
• ListCategoriesResponse(메시지)
• ListLocationsRequest(메시지)
• ListLocationsResponse(메시지)
• Location(메시지)
• Metadata(메시지)
• MoreHours(메시지)
• MoreHoursType(메시지)
• OpenInfo(메시지)
• OpenInfo.OpenForBusiness(열거형)
• PhoneNumbers(메시지)
• PlaceInfo(메시지)
• Places(메시지)
• Profile(메시지)
• RelationshipData(메시지)
• RelevantLocation(메시지)
• RelevantLocation.RelationType(열거형)
• RepeatedEnumAttributeValue(메시지)
• SearchChainsRequest(메시지)
• SearchChainsResponse(메시지)
• SearchGoogleLocationsRequest(메시지)
• SearchGoogleLocationsResponse(메시지)
• ServiceAreaBusiness(메시지)
• ServiceAreaBusiness.BusinessType(열거형)
• ServiceItem(메시지)
• ServiceItem.FreeFormServiceItem(메시지)
• ServiceItem.StructuredServiceItem(메시지)
• ServiceType(메시지)
• SpecialHourPeriod(메시지)
• SpecialHours(메시지)
• TimePeriod(메시지)
• UpdateAttributesRequest(메시지)
• UpdateLocationRequest(메시지)
• UriAttributeValue(메시지)

AttributesService

클라이언트가 지정된 위치의 속성을 조회하고 업데이트하도록 허용합니다.

GetAttributes
rpc GetAttributes(GetAttributesRequest) returns (Attributes) 지정된 위치에 설정된 모든 속성을 조회합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetGoogleUpdatedAttributes
rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes) 지정된 위치의 Google 업데이트 버전을 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListAttributeMetadata
rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse) 지정된 기본 카테고리 및 국가가 있는 위치에 사용할 수 있는 속성 목록을 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateAttributes
rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes) 지정된 위치의 속성을 업데이트합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

CategoriesService

이 API는 Google에서 지원되는 업체 위치에 대한 정보를 제공합니다. 자세한 내용은 이 도움말의 카테고리 섹션을 참조하세요. https://support.google.com/business/answer/3038177

BatchGetCategories
rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse) 제공된 언어 및 GConcept ID에 대한 비즈니스 카테고리 목록을 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListCategories
rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse) 비즈니스 카테고리의 목록을 반환합니다. 검색은 카테고리 이름과 일치하지만 카테고리 ID와는 일치하지 않습니다. 검색은 카테고리 이름 앞만 일치 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

체인

체인 비즈니스에 대한 정보를 조회하기 위한 서비스입니다.

GetChain
rpc GetChain(GetChainRequest) returns (Chain) 지정된 체인을 가져옵니다. 체인이 없으면 NOT_FOUND를 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

SearchChains
rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse) 체인 이름을 기준으로 체인을 검색합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

GoogleLocations

이 API를 사용하면 GoogleLocation에 액세스하고 검색할 수 있습니다.

SearchGoogleLocations
rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse) 지정된 요청과 일치하는 가능한 모든 위치를 검색합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

위치

이 API를 사용하면 Google에서 업체 위치를 관리할 수 있습니다.

CreateLocation
rpc CreateLocation(CreateLocationRequest) returns (Location) 로그인한 사용자가 소유할 새 위치를 만듭니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteLocation
rpc DeleteLocation(DeleteLocationRequest) returns (Empty) 위치를 삭제합니다. API를 사용하여 위치를 삭제할 수 없고 google.mybusiness.businessinformation.v1.LocationState에 위치가 표시되어 있는 경우 Google 비즈니스 프로필 웹사이트를 사용하세요. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetGoogleUpdatedLocation
rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation) 지정된 위치의 Google 업데이트 버전을 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetLocation
rpc GetLocation(GetLocationRequest) returns (Location) 지정된 위치를 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListLocations
rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse) 지정된 계정의 위치를 나열합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateLocation
rpc UpdateLocation(UpdateLocationRequest) returns (Location) 지정된 위치를 업데이트합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/business.manage 자세한 내용은 OAuth 2.0 개요를 참고하세요.

AdWordsLocationExtensions

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

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

속성

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

필드
name	string 필수 항목입니다. 이 속성의 리소스 이름입니다.
value_type	AttributeValueType 출력 전용. 이 속성에 포함된 값의 유형입니다. 값을 해석하는 방법을 결정하는 데 사용해야 합니다.
values[]	Value 이 속성의 값입니다. 제공된 값의 유형은 해당 속성에 예상되는 유형과 일치해야 합니다. 여러 속성 값을 제공할 수 있는 반복되는 입력란입니다. 속성 유형은 하나의 값만 지원합니다.
repeated_enum_value	RepeatedEnumAttributeValue 속성 값 유형이 REPEATED_ENUM인 경우 이 속성에 속성 값이 포함되고 다른 값 필드는 비어 있어야 합니다.
uri_values[]	UriAttributeValue 속성 값 유형이 URL인 경우 이 입력란에는 이 속성의 값이 포함되며 다른 값 입력란은 비어 있어야 합니다.

AttributeMetadata

속성의 메타데이터입니다. 현지화된 이름과 관련 속성을 함께 그룹화하기 위한 제목을 비롯하여 속성의 표시 정보가 포함됩니다.

필드
parent	string 속성의 고유 식별자입니다.
value_type	AttributeValueType 속성의 값 유형입니다. 설정 및 검색된 값은 이 유형이어야 합니다.
display_name	string 사용할 수 있는 경우 속성의 현지화된 표시 이름입니다. 그렇지 않은 경우 영어 표시 이름입니다.
group_display_name	string 사용할 수 있는 경우 이 속성을 포함하는 그룹의 현지화된 표시 이름이고, 그렇지 않은 경우 영어 그룹 이름입니다. 관련 속성은 그룹으로 수집되며 여기에 제공된 제목 아래 함께 표시되어야 합니다.
repeatable	bool true인 경우 속성이 여러 값을 지원합니다. false인 경우 하나의 값만 제공해야 합니다.
value_metadata[]	AttributeValueMetadata 일부 속성 유형 (예: enum)의 경우 지원되는 값 목록과 이러한 값에 해당하는 표시 이름이 제공됩니다.
deprecated	bool true인 경우 속성은 지원 중단되었으며 더 이상 사용하면 안 됩니다. 지원 중단된 경우 이 속성을 업데이트해도 오류가 발생하지는 않지만 업데이트가 저장되지 않습니다. 지원 중단되면 어느 시점이 되면 속성이 완전히 삭제되고 오류가 됩니다.

AttributeValueMetadata

지원되는 속성 값의 메타데이터입니다.

필드
value	Value 속성 값입니다.
display_name	string 이 값의 표시 이름으로, 가능한 경우 현지화되고 그렇지 않은 경우 영어입니다. 값 표시 이름은 속성 표시 이름과 함께 컨텍스트에서 사용하기 위한 것입니다. 예를 들어 'Wi-Fi' 열거형 속성의 경우 유료 Wi-Fi를 나타내는 'paid'가 포함될 수 있습니다.

AttributeValueType

속성의 값 유형입니다.

열거형
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED	지정되지 않음
BOOL	이 속성의 값은 부울 값입니다.
ENUM	이 속성에는 사용할 수 있는 사용 가능한 값의 사전 결정된 목록이 있습니다. 이 속성의 메타데이터는 이러한 값을 나열합니다.
URL	이 속성의 값은 URL입니다.
REPEATED_ENUM	속성 값은 명시적으로 설정하거나 설정 해제할 수 있는 여러 값이 가능한 열거형입니다.

특성

지정된 위치의 모든 속성을 담는 컨테이너입니다.

필드
name	string 필수 항목입니다. 이 위치의 Google 식별자입니다(locations/{location_id}/attributes 형식).
attributes[]	Attribute 업데이트해야 하는 속성의 모음입니다.

BatchGetCategoriesRequest

BusinessCategories.BatchGetBusinessCategories 요청 메시지입니다.

필드
names[]	string 필수 항목입니다. 이름을 하나 이상 설정해야 합니다. 현지화된 카테고리 이름이 반환되어야 하는 GConcept ID입니다. 둘 이상의 카테고리에 대한 세부정보를 반환하려면 요청에서 이 매개변수를 반복합니다.
language_code	string 필수 항목입니다. 카테고리 이름이 반환되어야 하는 BCP 47 언어 코드입니다.
region_code	string 선택사항입니다. 비표준 언어를 유추하는 데 사용되는 ISO 3166-1 alpha-2 국가 코드입니다.
view	CategoryView 필수 항목입니다. 카테고리 리소스에 대해 응답으로 반환해야 하는 부분을 지정합니다.

BatchGetCategoriesResponse

BusinessCategories.BatchGetBusinessCategories의 응답 메시지입니다.

필드
categories[]	Category 요청에 제공된 GConcept ID와 일치하는 카테고리입니다. 요청에 있는 카테고리 ID와 동일한 순서로 나오지는 않습니다.

BusinessHours

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

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

카테고리

비즈니스를 설명하는 카테고리 모음입니다. 업데이트 중에는 두 필드를 모두 설정해야 합니다. 클라이언트가 업데이트 마스크를 사용하여 기본 카테고리 또는 추가 카테고리를 개별적으로 업데이트할 수 없습니다.

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

카테고리

이 비즈니스의 업무 내용이 아니라 업종을 설명하는 카테고리입니다. 유효한 카테고리 ID 목록과 사람이 읽을 수 있는 이름에 대한 매핑은 categories.list를 참고하세요.

필드
name	string 필수 항목입니다. 이 카테고리의 안정적인 ID입니다 (Google에서 제공). 카테고리를 수정할 때 (위치를 만들거나 업데이트할 때) 값을 지정해야 합니다.
display_name	string 출력 전용. 사람이 읽을 수 있는 카테고리 이름입니다. 위치를 읽을 때 설정됩니다. 위치를 수정할 때는 category_id를 설정해야 합니다.
service_types[]	ServiceType 출력 전용. 이 비즈니스 카테고리에 사용할 수 있는 모든 서비스 유형의 목록입니다.
more_hours_types[]	MoreHoursType 출력 전용. 이 비즈니스 카테고리에 사용할 수 있는 기타 영업시간 유형입니다.

CategoryView

서버에서 반환하는 데이터의 양을 제한하는 데 도움이 되는 enum입니다.

열거형
CATEGORY_VIEW_UNSPECIFIED	지정되지 않으며 CATEGORY_METADATA_ONLY와 같습니다.
BASIC	서버 응답에는 카테고리 필드 display_name, category_id, language_code만 포함됩니다. 서비스 유형 메타데이터 관련 필드가 생략됩니다.
FULL	응답의 모든 필드를 반환합니다.

체인

체인은 비즈니스 위치와 제휴할 수 있는 브랜드입니다.

필드
name	string 필수 항목입니다. chains/{chain_id} 형식의 체인 리소스 이름입니다.
chain_names[]	ChainName 체인의 이름입니다.
websites[]	ChainUri 체인의 웹사이트입니다.
location_count	int32 이 체인에 속한 위치의 수입니다.

ChainName

체인을 표시할 때 사용할 이름입니다.

필드
display_name	string 이 체인의 표시 이름입니다.
language_code	string 이름의 언어로 된 BCP 47 코드입니다.

ChainUri

체인을 표시할 때 사용되는 URL입니다.

필드
uri	string 이 체인의 URI입니다.

CreateLocationRequest

Locations.CreateLocation 요청 메시지입니다.

필드
parent	string 필수 항목입니다. 이 위치를 만들 계정의 이름입니다.
location	Location 필수 항목입니다. 새 위치 메타데이터입니다.
validate_only	bool 선택사항입니다. true인 경우 실제로 위치를 생성하지 않고 요청의 유효성이 검사됩니다.
request_id	string 선택사항입니다. 서버에서 중복 요청을 감지하는 고유한 요청 ID입니다. UUID를 사용하는 것이 좋습니다. 최대 길이는 50자(영문 기준)입니다.

DeleteLocationRequest

Locations.DeleteLocation 요청 메시지입니다.

필드
name	string 필수 항목입니다. 삭제할 위치의 이름입니다.

ErrorCode

API에서 반환된 모든 오류 코드입니다.

열거형
ERROR_CODE_UNSPECIFIED	오류 코드가 누락되었습니다.
INVALID_ATTRIBUTE_NAME	제공된 속성 중 하나를 이 위치에 적용할 수 없습니다. ListAttributeMetadata 응답에서 반환된 속성만 이 위치에 적용될 수 있습니다. 문제가 있는 모든 속성 이름은 메타데이터 아래의 attribute_names 키에 반환됩니다.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION	이 오류는 클라이언트가 위치를 연결하거나 인증된 위치에서 위치 연결을 삭제하려고 할 때 반환됩니다.
ASSOCIATE_LOCATION_INVALID_PLACE_ID	associateLocation 요청에 제공된 place_id이 위치와 일치하지 않거나 잘못되었습니다. 설정 중인 place_id가 SearchGoogleLocations 응답에서 반환되는 ID 중 하나와 일치하는지 확인합니다.
LAT_LNG_UPDATES_NOT_PERMITTED	이 프로젝트는 위치의 위도/경도 필드를 업데이트할 수 없습니다. UI에서 핀 고정 기능을 사용하여 위도/경도를 업데이트하거나 Google에 주소를 제공할 수 있습니다.
PO_BOX_IN_ADDRESS_NOT_ALLOWED	사서함은 주소로 사용할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
BLOCKED_REGION	국제 제재로 인해 해당 지역의 비즈니스는 허용되지 않습니다. 메타데이터 키에는 'field_maks'가 포함됩니다.
MISSING_BOTH_PHONE_AND_WEBSITE	CUSTOMER_LOCATION_ONLY 비즈니스에는 전화 또는 웹사이트가 필요합니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
MISSING_STOREFRONT_ADDRESS_OR_SAB	모든 위치에는 최소한 오프라인 매장 주소나 서비스 지역이 있어야 합니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
LAT_LNG_TOO_FAR_FROM_ADDRESS	위도/경도 및 주소 쌍이 너무 멀리 떨어져 있습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
LAT_LNG_REQUIRED	DEPRECATED. PIN_DROP_REQUIRED로 대체되었습니다. 지정된 주소를 찾을 수 없습니다. 위도/경도를 입력하세요. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_CHARACTERS	잘못된 문자가 있습니다. 메타데이터 키에는 'field_mask' 및 'invalid_characters'가 있습니다.
FORBIDDEN_WORDS	금지된 단어가 발견되었습니다. 메타데이터 키에는 'field_mask' 및 'forbidden_words'가 포함됩니다.
INVALID_INTERCHANGE_CHARACTERS	잘못된 문자가 있습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
FIELDS_REQUIRED_FOR_CATEGORY	이 위치 카테고리에는 추가 입력란이 필요합니다. 메타데이터 키에는 'field_mask', 'value', 'fields_required'가 포함됩니다.
STOREFRONT_REQUIRED_FOR_CATEGORY	비즈니스 카테고리에 고객이 방문할 수 있는 오프라인 매장 위치가 필요합니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
ADDRESS_MISSING_REGION_CODE	주소에 필수 region_code가 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
ADDRESS_EDIT_CHANGES_COUNTRY	주소는 다른 국가로 이동할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS	특별 영업시간은 위치에 정규 영업시간이 있는 경우에만 지정할 수 있습니다. 메타데이터가 비어 있습니다.
INVALID_TIME_SCHEDULE	시간 일정이 잘못되었습니다. 겹치는 시간 또는 종료 시간이 시작 시간보다 빠릅니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_HOURS_VALUE	시간 형식 또는 값이 잘못되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
OVERLAPPED_SPECIAL_HOURS	특별 영업시간은 겹칠 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY	비즈니스 기본 카테고리에서 이 영업시간 유형을 지원하지 않습니다. 메타데이터 키에는 'field_mask' 및 'incompatible_hours_type'이 있습니다.
DUPLICATE_CHILDREN_LOCATIONS	management_data에 child_locations가 중복됩니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY	방문 서비스 업체에는 선택한 기본 카테고리를 포함할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_SERVICE_AREA_PLACE_ID	service_area에 잘못된 place_id가 있습니다. 메타데이터 키에는 'field_mask' 및 'place_id'가 포함됩니다.
INVALID_AREA_TYPE_FOR_SERVICE_AREA	service_area에 대한 지역 유형이 잘못되었습니다. 메타데이터 키에는 'field_mask' 및 'place_id'가 포함됩니다.
OPENING_DATE_TOO_FAR_IN_THE_FUTURE	개업일을 1년 이내의 날짜로 입력하세요. 메타데이터 키에는 'field_mask'가 포함됩니다.
OPENING_DATE_MISSING_YEAR_OR_MONTH	개업일은 연도 또는 월을 지정해야 합니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
OPENING_DATE_BEFORE_1AD	개업일은 서기 1년 이전일 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
TOO_MANY_ENTRIES	입력란에 항목이 너무 많습니다. 메타데이터 키에는 'field_mask' 및 'max_count'가 포함됩니다.
INVALID_PHONE_NUMBER	전화번호 입력이 인식되지 않습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
INVALID_PHONE_NUMBER_FOR_REGION	해당 지역의 전화번호 형식에 맞지 않습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
MISSING_PRIMARY_PHONE_NUMBER	기본 전화번호가 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
THROTTLED	지금은 필드를 업데이트할 수 없습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA	지점 반경 서비스 지역은 더 이상 지원되지 않습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_CATEGORY	카테고리 ID가 잘못되었습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
CANNOT_REOPEN	이 비즈니스는 다시 영업을 재개할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_BUSINESS_OPENING_DATE	개업일이 잘못되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_LATLNG	latlng가 잘못되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
PROFILE_DESCRIPTION_CONTAINS_URL	비즈니스 설명에는 URL을 포함할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION	숙박 시설 위치의 프로필 설명은 수정할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_URL	잘못된 링크 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_ADDRESS	잘못된 주소입니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF	ParentChain은 위치 자체가 될 수 없습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
RELATION_CANNOT_BE_THE_LOCATION_ITSELF	관계는 위치 자체일 수 없습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
MISSING_ADDRESS_COMPONENTS	주소 구성요소의 값이 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
READ_ONLY_ADDRESS_COMPONENTS	읽기 전용 주소 구성요소는 수정할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
STRING_TOO_LONG	문자열이 너무 깁니다. 메타데이터 키에는 'field_mask' 및 'max_length'가 포함됩니다.
STRING_TOO_SHORT	문자열이 너무 짧습니다. 메타데이터 키에는 'field_mask' 및 'min_length'가 있습니다.
REQUIRED_FIELD_MISSING_VALUE	필수 입력란의 값이 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED	제공업체의 URL을 추가하거나 수정할 수 없습니다. 메타데이터 키에는 'attribute_name'이 포함됩니다.
ATTRIBUTE_INVALID_ENUM_VALUE	알 수 없는 enum 속성 값입니다. 메타데이터 키에는 'attribute_name'이 포함됩니다.
ATTRIBUTE_NOT_AVAILABLE	이 위치에는 확장 가능한 속성이 유효하지 않습니다. 메타데이터 키에는 ''attribute_name'이 포함됩니다.
ATTRIBUTE_CANNOT_BE_REPEATED	확장 가능한 속성은 한 번만 지정됩니다. 메타데이터 키에는 'attribute_name'이 포함됩니다.
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY	확장 가능 속성이 위치에 설정된 카테고리와 호환되지 않습니다. 메타데이터 키에는 'attribute_name'이 포함됩니다.
ADDRESS_REMOVAL_NOT_ALLOWED	비즈니스 주소 삭제가 허용되지 않습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
AMBIGUOUS_TITLE	언어에서 가장 좋은 이름이 모호합니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_CATEGORY_FOR_SAB	순수 SAB에는 gcid:installation_poi의 하위유형인 gcid가 포함될 수 없습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
RELATION_ENDPOINTS_TOO_FAR	관계 엔드포인트가 서로 너무 멀리 있습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.
INVALID_SERVICE_ITEM	schema_service_item과 free_form_service_item이 모두 설정되지 않았습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME	라벨에 표시 이름이 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME	표시 이름이 모든 가격 목록에 있는 모든 라벨에 대해 고유하지는 않습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
SERVICE_ITEM_LABEL_INVALID_UTF8	라벨에 잘못된 UTF-8 기호가 있습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID	free_form_service_item에 category_id 필드가 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL	free_form_service_item에 라벨이 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID	Structured_service_item에 service_type_id 필드가 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
INVALID_LANGUAGE	언어 코드가 잘못되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
PRICE_CURRENCY_MISSING	ISO 4217 통화 코드가 누락되었습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
PRICE_CURRENCY_INVALID	입력한 통화 코드가 유효한 ISO 4217이 아닙니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
SERVICE_TYPE_ID_DUPLICATE	서비스 유형 ID가 위치 내에서 고유하지 않습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
PIN_DROP_REQUIRED	지정된 주소를 찾을 수 없습니다. UI를 사용하여 핀을 고정하세요. 메타데이터 키에는 'field_mask'가 포함됩니다.
STALE_DATA	최근 Google에서 하나 이상의 항목을 업데이트했습니다. 현재 이 비즈니스의 소유자만 business.google.com을 방문하여 '필드'에 있는 데이터를 변경할 수 있습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
PHONE_NUMBER_EDITS_NOT_ALLOWED	이 위치에 대해 전화번호 입력란이 사용 중지되어 있으므로 수정할 수 없습니다. 메타데이터 키에는 'field_mask'가 포함됩니다.
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION	두 위치 간의 논리적 관계 (예: 위협, 작업)를 모델링하는 관계가 두 개 이상 있습니다. 메타데이터 키에는 'field_mask' 및 'value'가 포함됩니다.

GetAttributesRequest

AttributesService.GetAttributes 요청입니다.

필드
name	string 필수 항목입니다. 이 위치의 Google 식별자입니다(locations/{location_id}/attributes 형식).

GetChainRequest

Locations.GetChain 요청 메시지입니다.

필드
name	string 필수 항목입니다. chains/{chain_place_id} 형식의 체인 리소스 이름입니다.

GetGoogleUpdatedAttributesRequest

AttributesService.GetGoogleUpdatedAttributes 요청입니다.

필드
name	string 필수 항목입니다. 이 위치의 Google 식별자입니다(locations/{location_id}/attributes 형식).

GetGoogleUpdatedLocationRequest

Locations.GetGoogleUpdatedLocation 요청 메시지입니다.

필드
name	string 필수 항목입니다. 가져올 위치의 이름입니다.
read_mask	FieldMask 필수 항목입니다. 응답에서 반환될 필드를 지정하기 위해 마스크를 읽습니다.

GetLocationRequest

Locations.GetLocation 요청 메시지입니다.

필드
name	string 필수 항목입니다. 가져올 위치의 이름입니다.
read_mask	FieldMask 필수 항목입니다. 응답에서 반환될 필드를 지정하기 위해 마스크를 읽습니다.

GoogleLocation

Google에 있는 Location를 나타냅니다. 이 위치는 사용자 또는 다른 사용자가 소유권을 주장했거나 소유권을 주장하지 않을 수 있는 위치일 수 있습니다.

필드
name	string 이 GoogleLocation의 리소스 이름으로, googleLocations/{googleLocationId} 형식입니다.
location	Location 희소하게 채워진 Location 정보. 이 필드는 현재 사용자가 소유권을 주장하지 않는 경우 CreateLocation에서 재사용할 수 있습니다.
request_admin_rights_uri	string 사용자를 관리자 권한 요청 UI로 리디렉션하는 URL입니다. 이 필드는 현재 사용자를 포함하여 다른 사용자가 이미 위치의 소유권을 주장한 경우에만 표시됩니다.

GoogleUpdatedLocation

Google에서 수정한 위치를 나타냅니다.

필드
location	Location 이 위치의 Google 업데이트 버전입니다.
diff_mask	FieldMask Google에서 업데이트한 필드
pending_mask	FieldMask 대기 중인 수정사항이 있지만 지도 및 Google 검색에 아직 푸시되지 않은 입력란입니다.

라벨

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

필드
display_name	string 필수 항목입니다. 가격 목록, 섹션 또는 상품의 표시 이름입니다.
description	string 선택사항입니다. 가격 목록, 섹션 또는 상품의 설명입니다.
language_code	string 선택사항입니다. 이러한 문자열이 적용되는 BCP-47 언어 코드입니다. 언어당 하나의 라벨 집합만 설정할 수 있습니다.

ListAttributeMetadataRequest

AttributesService.ListAttributeMetadata 요청입니다.

필드
parent	string 사용 가능한 속성을 조회할 위치의 리소스 이름입니다. 이 필드가 설정되면 category_name, region_code, language_code, show_all이 필수가 아니며 설정되어서는 안 됩니다.
category_name	string 사용 가능한 속성을 찾기 위한 기본 카테고리의 안정적인 ID입니다. 카테고리/{category_id} 형식이어야 합니다.
region_code	string 사용 가능한 속성을 찾기 위한 ISO 3166-1 alpha-2 국가 코드입니다.
language_code	string 속성 표시 이름을 가져올 BCP 47 언어 코드입니다. 이 언어를 사용할 수 없는 경우 영어로 제공됩니다.
show_all	bool 이 필드가 true로 설정된 경우 상위 및 category_name 필드를 고려하지 않고 사용 가능한 모든 속성의 메타데이터가 반환됩니다. show_all이 true로 설정된 경우 language_code 및 region_code가 필요합니다.
page_size	int32 페이지당 포함할 속성 수입니다. 기본값은 200, 최솟값은 1입니다.
page_token	string 지정하면 속성 메타데이터의 다음 페이지가 검색됩니다.

ListAttributeMetadataResponse

AttributesService.ListAttributeMetadata에 대한 응답입니다.

필드
attribute_metadata[]	AttributeMetadata 사용 가능한 속성의 속성 메타데이터 모음입니다.
next_page_token	string 속성 수가 요청된 페이지 크기를 초과하면 이 필드는 attributes.list에 대한 후속 호출에서 다음 속성 페이지를 가져오는 토큰으로 채워집니다. 속성이 더 이상 없으면 이 필드는 응답에 표시되지 않습니다.

ListCategoriesRequest

BusinessCategories.ListCategories 요청 메시지입니다.

필드
region_code	string 필수 항목입니다. ISO 3166-1 alpha-2 국가 코드입니다.
language_code	string 필수 항목입니다. BCP 47 언어 코드입니다.
filter	string 선택사항입니다. 사용자의 필터 문자열. 지원되는 유일한 필드는 displayName입니다. 예: filter=displayName=foo.
page_size	int32 선택사항입니다. 페이지당 가져올 카테고리 수입니다. 기본값은 100, 최소는 1, 최대 페이지 크기는 100입니다.
page_token	string 선택사항입니다. 지정하면 카테고리의 다음 페이지를 가져옵니다.
view	CategoryView 필수 항목입니다. 카테고리 리소스에 대해 응답으로 반환해야 하는 부분을 지정합니다.

ListCategoriesResponse

BusinessCategories.ListCategories의 응답 메시지입니다.

필드
categories[]	Category 요청된 매개변수를 기준으로 한 일치 카테고리입니다.
next_page_token	string 카테고리 수가 요청된 페이지 크기를 초과하면 이 필드는 ListCategories에 대한 후속 호출에서 다음 카테고리 페이지를 가져오는 토큰으로 채워집니다.

ListLocationsRequest

Locations.ListLocations 요청 메시지입니다.

필드
parent	string 필수 항목입니다. 위치를 가져올 계정의 이름입니다. 상위 [계정] [google.mybusiness.accountmanagement.v1.Account] 가 [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL인 경우, 계정에서 직접 소유한 위치만 반환되며, 그렇지 않은 경우 직간접적으로 계정에서 액세스할 수 있는 모든 위치가 반환됩니다.
page_size	int32 선택사항입니다. 페이지당 가져올 위치 수입니다. 설정하지 않으면 기본값은 10입니다. 최소 1, 최대 페이지 크기는 100입니다.
page_token	string 선택사항입니다. 지정하면 위치의 다음 page를 가져옵니다. 요청된 페이지 크기에 넣을 수 있는 위치보다 많은 위치가 있는 경우 이전 ListLocations 호출에서 페이지 토큰이 반환됩니다.
filter	string 선택사항입니다. 반환할 위치를 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. filter가 비어 있으면 제약 조건이 적용되고 요청된 계정에 대해 모든 위치 (페이지 매김)를 가져옵니다. 유효한 입력란과 사용 예에 대한 자세한 내용은 위치 데이터 사용 가이드를 참고하세요.
order_by	string 선택사항입니다. 요청의 정렬 순서입니다. 여러 필드는 SQL 구문에 따라 쉼표로 구분되어야 합니다. 기본 정렬 순서는 오름차순입니다. 내림차순을 지정하려면 접미사 ' desc'를 추가해야 합니다. order_by에 유효한 필드는 title 및 store_code입니다. 예: 'title, store_code desc', 'title' 또는 'store_code desc'
read_mask	FieldMask 필수 항목입니다. 응답에서 반환될 필드를 지정하기 위해 마스크를 읽습니다.

ListLocationsResponse

Locations.ListLocations의 응답 메시지입니다.

필드
locations[]	Location 위치입니다.
next_page_token	string 위치 수가 요청된 페이지 크기를 초과하면 이 필드는 ListLocations에 대한 후속 호출에서 다음 위치 페이지를 가져오는 토큰으로 채워집니다. 위치가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다.
total_size	int32 페이지로 나누기와 관계없이 목록에 있는 대략적인 위치 수입니다. 이 필드는 filter이 쿼리 매개변수로 사용되는 경우에만 반환됩니다.

위치

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

필드
name	string 이 위치의 Google 식별자로, locations/{location_id} 형식입니다.
language_code	string 변경할 수 없습니다. 위치의 언어입니다. 생성 중에 설정되며 업데이트할 수 없습니다.
store_code	string 선택사항입니다. 이 위치의 외부 식별자로, 지정된 계정 내에서 고유해야 합니다. 위치를 자신의 레코드와 연결하는 방법입니다.
title	string 필수 항목입니다. 위치 이름은 오프라인 매장, 웹사이트, 회사 서간지에서 일관되게 사용되고 고객에게 알려져 있는 비즈니스의 실제 이름을 반영해야 합니다. 추가 정보는 해당하는 경우 리소스의 다른 필드 (예: Address, Categories)에 포함할 수 있습니다. 이름에 불필요한 정보를 추가하지 마세요 (예: 'Google Inc. - Mountain View Corporate 본사'보다 'Google' 선호). 마케팅 소개 문구, 판매점 코드, 특수문자, 영업시간 또는 영업 종료/영업 상태, 전화번호, 웹사이트 URL, 서비스/제품 정보, 위치/주소 또는 경로, 보관 정보를 포함하지 마세요 (예: 'Duane Reade의 체이스 ATM').
phone_numbers	PhoneNumbers 선택사항입니다. 고객이 비즈니스에 연락하는 데 사용할 수 있는 다양한 전화번호입니다.
categories	Categories 선택사항입니다. 비즈니스를 설명하는 다양한 카테고리입니다.
storefront_address	PostalAddress 선택사항입니다. 정확한 주소를 사용해 업체 위치를 설명하세요. 원격 위치에 있는 사서함이나 우편함은 사용할 수 없습니다. 현재는 주소에 최대 5개의 address_lines 값을 지정할 수 있습니다. 이 필드는 오프라인 매장이 있는 비즈니스에만 설정해야 합니다. 이 필드는 CUSTOMER_LOCATION_ONLY 유형의 위치에 설정되어서는 안 되지만 설정하면 제공된 모든 값이 삭제됩니다.
website_uri	string 선택사항입니다. 이 비즈니스의 URL입니다. 가능하면 모든 위치 또는 브랜드를 나타내는 일반 웹사이트/URL 대신 이 개별 업체 위치를 나타내는 URL을 사용하세요.
regular_hours	BusinessHours 선택사항입니다. 비즈니스의 영업시간입니다.
special_hours	SpecialHours 선택사항입니다. 비즈니스의 특별 영업시간입니다. 일반적으로 휴일 영업시간과 정규 영업시간 외의 기타 시간도 포함됩니다. 이 영업시간은 정규 영업시간보다 우선합니다. 정규 영업시간 없이는 이 필드를 설정할 수 없습니다.
service_area	ServiceAreaBusiness 선택사항입니다. 방문 서비스 업체는 고객의 위치에서 서비스를 제공합니다. 방문 서비스 업체인 경우, 이 필드는 업체가 서비스를 제공하는 지역을 설명합니다.
labels[]	string 선택사항입니다. 비즈니스에 태그를 지정할 수 있는 자유형 문자열 컬렉션입니다. 이러한 라벨은 사용자에게 표시되지 않으며 나만 볼 수 있습니다. 라벨당 1~255자(영문 기준)여야 합니다.
ad_words_location_extensions	AdWordsLocationExtensions 선택사항입니다. 애드워즈에 표시되는 추가 정보입니다.
latlng	LatLng 선택사항입니다. 사용자가 제공한 위도 및 경도입니다. 위치를 생성할 때 제공된 주소가 성공적으로 지오코딩되면 이 필드는 무시됩니다. 이 필드는 사용자가 제공한 latlng 값이 생성 중에 허용되었거나 latlng 값이 Google 비즈니스 프로필 웹사이트를 통해 업데이트된 경우에만 get 요청 시 반환됩니다. 이 필드는 승인된 고객만 업데이트할 수 있습니다.
open_info	OpenInfo 선택사항입니다. 위치가 현재 영업 중인지 여부를 나타내는 플래그.
metadata	Metadata 출력 전용. 사용자가 수정할 수 없는 추가 정보입니다.
profile	Profile 선택사항입니다. 비즈니스를 직접 설명하고 비즈니스와 제공 항목에 관한 고유한 이야기를 사용자와 공유합니다. 이 입력란은 숙박 시설 카테고리 (예: 호텔, 모텔, 여관)를 제외한 모든 카테고리에서 필수입니다.
relationship_data	RelationshipData 선택사항입니다. 이 매장과 관련된 모든 매장 및 체인입니다.
more_hours[]	MoreHours 선택사항입니다. 비즈니스의 여러 부서 또는 특정 고객에 대한 추가 영업시간입니다.
service_items[]	ServiceItem 선택사항입니다. 판매자가 지원하는 서비스 목록입니다. 이발, 온수기 설치 등의 서비스가 제공될 수 있습니다. 중복된 서비스 항목은 자동으로 삭제됩니다.

메타데이터

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

필드
has_google_updated	bool 출력 전용. 이 위치와 연결된 장소 ID에 클라이언트가 업데이트하거나 거부해야 하는 업데이트가 있는지 여부를 나타냅니다. 이 불리언이 설정되면 getGoogleUpdated 메서드를 호출하여 확인해야 하는 정보를 조회해야 합니다.
has_pending_edits	bool 출력 전용. 이 위치의 속성이 수정 대기 중 상태에 있는지 여부를 나타냅니다.
can_delete	bool 출력 전용. API를 사용하여 위치를 삭제할 수 있는지 여부를 나타냅니다.
can_operate_local_post	bool 출력 전용. 비즈니스 정보가 지역 게시물을 관리할 수 있는지를 나타냅니다.
can_modify_service_list	bool 출력 전용. 비즈니스 정보가 서비스 목록을 수정할 수 있는지를 나타냅니다.
can_have_food_menus	bool 출력 전용. 등록정보가 음식 메뉴에 적합한지 여부를 나타냅니다.
can_operate_health_data	bool 출력 전용. 위치가 건강 데이터를 활용할 수 있는지를 나타냅니다.
can_operate_lodging_data	bool 출력 전용. 위치가 숙박 시설 데이터에서 운영할 수 있는지 여부를 나타냅니다.
place_id	string 출력 전용. 이 위치가 Google 지도에 표시되면 이 필드는 위치의 장소 ID로 채워집니다. 이 ID는 다양한 Places API에서 사용할 수 있습니다. 이 필드는 Create 호출 중에 설정할 수 있지만 Update 호출 중에는 설정할 수 없습니다.
duplicate_location	string 출력 전용. 이 위치가 복제하는 위치 리소스입니다.
maps_uri	string 출력 전용. 지도상의 위치에 대한 링크입니다.
new_review_uri	string 출력 전용. 고객이 위치에 대한 리뷰를 남길 수 있는 Google 검색 페이지의 링크입니다.
can_have_business_calls	bool 출력 전용. 비즈니스 정보에 비즈니스 전화를 걸 수 있는지 여부를 나타냅니다.
has_voice_of_merchant	bool 출력 전용. 등록정보에 판매자 음성이 포함되어 있는지 나타냅니다. 이 부울이 false인 경우 locations.getVoiceOfMerchantState API를 호출하여 판매자 목소리가 없는 이유에 대한 세부정보를 가져와야 합니다.

MoreHours

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

필드
hours_type_id	string 필수 항목입니다. 시간 유형입니다. 고객은 {#link businessCategories:BatchGet}을(를) 호출하여 위치 카테고리에 대해 지원되는 시간 유형을 가져와야 합니다.
periods[]	TimePeriod 필수 항목입니다. 이 위치가 영업 중인 시간의 컬렉션입니다. 각 기간은 위치가 주중에 영업 중인 시간 범위를 나타냅니다.

MoreHoursType

정상 영업시간 외에 비즈니스에서 제공할 수 있는 추가 영업시간 유형입니다.

필드
hours_type_id	string 출력 전용. Google에서 이 영업시간 유형에 제공하는 안정적인 ID입니다.
display_name	string 출력 전용. 사람이 읽을 수 있는 시간 유형의 영어 표시 이름입니다.
localized_display_name	string 출력 전용. 사람이 읽을 수 있는 시간 유형의 현지화된 표시 이름입니다.

OpenInfo

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

필드
status	OpenForBusiness 필수 항목입니다. 위치가 현재 영업 중인지 여부를 나타냅니다. 영업 종료 상태로 업데이트되지 않는 한 기본적으로 모든 위치는 영업 상태입니다.
can_reopen	bool 출력 전용. 비즈니스를 재개점할 수 있는지 여부를 나타냅니다.
opening_date	Date 선택사항입니다. 위치가 처음 문을 연 날짜입니다. 정확한 날짜를 알 수 없는 경우 월과 연도만 제공될 수 있습니다. 날짜는 과거이거나 1년 이내여야 합니다.

OpenForBusiness

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

열거형
OPEN_FOR_BUSINESS_UNSPECIFIED	지정되지 않음
OPEN	위치가 영업 중임을 나타냅니다.
CLOSED_PERMANENTLY	위치가 폐업 상태임을 나타냅니다.
CLOSED_TEMPORARILY	위치가 임시 휴업 상태임을 나타냅니다.

PhoneNumbers

비즈니스의 전화번호 모음입니다. 업데이트 중에는 두 필드를 모두 설정해야 합니다. 클라이언트는 업데이트 마스크를 사용하여 기본 전화번호 또는 추가 전화번호만 업데이트할 수 없습니다. '[phone]'와 같은 국제 전화 형식을 사용하는 것이 좋습니다. (https://developers.google.com/style/phone-numbers#international-phone-numbers)에서 자세한 내용을 확인하세요.

필드
primary_phone	string 필수 항목입니다. 가능한 한 개별 업체 위치로 직접 연결되는 전화번호입니다. 가능하면 중앙의 콜센터 전화번호가 아닌 지역 전화번호를 사용하세요.
additional_phones[]	string 선택사항입니다. 기본 전화번호 외에 비즈니스에 연락할 수 있는 전화번호 (휴대전화 또는 유선 전화번호)입니다. 최대 2개까지 추가할 수 있으며 팩스 번호는 사용할 수 없습니다.

PlaceInfo

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

필드
place_name	string 필수 항목입니다. 장소의 현지화된 이름입니다. Scottsdale, AZ을 예로 들 수 있습니다.
place_id	string 필수 항목입니다. 장소의 ID입니다. 리전과 일치해야 합니다. (https://developers.google.com/places/web-service/supported_types#table3)

Places

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

필드
place_infos[]	PlaceInfo 장소 ID로 표시되는 지역입니다. 최대 20개 장소로 제한됩니다.

프로필

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

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

RelationshipData

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

필드
parent_location	RelevantLocation 이 위치와 관계가 있는 상위 위치입니다.
children_locations[]	RelevantLocation 이 위치와 관계가 있는 하위 위치의 목록입니다.
parent_chain	string 이 위치가 속한 체인의 리소스 이름입니다. [체인 ID를 찾는 방법] [Locations.SearchChains]

RelevantLocation

현재 위치와 관련된 다른 위치에 관한 정보입니다. 관계는 DEPARTMENT_OF 또는 INDEPENDENT_ESTABLISHMENT_OF 중 하나일 수 있으며, 여기에 지정된 위치는 위치의 어느 쪽 (상위/하위)에 있을 수 있습니다.

필드
place_id	string 필수 항목입니다. 관계의 다른 쪽에 있는 위치를 placeID로 지정합니다.
relation_type	RelationType 필수 항목입니다. 관계 유형입니다.

RelationType

지정할 유형 관계입니다.

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

RepeatedEnumAttributeValue

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

필드
set_values[]	string 설정된 열거형 값.
unset_values[]	string 설정되지 않은 열거형 값.

SearchChainsRequest

Locations.SearchChains의 요청 메시지입니다.

필드
chain_name	string 필수 항목입니다. 이름으로 체인을 검색합니다. 완전/부분적/퍼지/관련 쿼리가 지원됩니다. 예: 'walmart', 'wal-mart', 'walmmmart', '沃尔玛'
page_size	int32 이 쿼리에서 반환할 일치하는 체인의 최대 개수입니다. 기본값은 10입니다. 가능한 최댓값은 500입니다.

SearchChainsResponse

Locations.SearchChains의 응답 메시지입니다.

필드
chains[]	Chain SearchChainsRequest에서 쿼리된 Chain_display_name과 일치하는 체인입니다. 일치하는 항목이 없으면 이 필드는 비어 있습니다. 결과는 관련성 순으로 나열됩니다.

SearchGoogleLocationsRequest

GoogleLocations.SearchGoogleLocations 요청 메시지입니다.

필드
page_size	int32 반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청하면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기 기능이 없습니다.
통합 필드 search_query. 검색어입니다. 위치 객체 또는 문자열 쿼리로 제공될 수 있습니다. search_query은 다음 중 하나여야 합니다.
location	Location 검색할 위치입니다. 제공된 경우 제공된 위치 세부정보와 일치하는 위치를 찾습니다.
query	string 검색할 텍스트 쿼리입니다. 쿼리 문자열의 검색결과는 정확한 위치를 제공하는 경우보다 정확도가 떨어질 수 있지만 부정확한 일치는 더 많이 제공될 수 있습니다.

SearchGoogleLocationsResponse

GoogleLocations.SearchGoogleLocations의 응답 메시지입니다.

필드
google_locations[]	GoogleLocation 지정된 요청과 일치할 가능성이 있는 GoogleLocations 모음으로, 정확성이 높은 것부터 낮은 순으로 나열됩니다.

ServiceAreaBusiness

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

필드
business_type	BusinessType 필수 항목입니다. 방문 서비스 업체의 [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] 을 나타냅니다.
places	Places 이 비즈니스가 서비스를 제공하는 지역이 장소의 집합을 통해 정의됩니다.
region_code	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로 업데이트하는 경우 위치 업데이트에 storefront_address 필드 마스크를 포함하고 이 필드를 비워 두어야 합니다.
CUSTOMER_AND_BUSINESS_LOCATION	비즈니스 주소 및 주변 지역에서 서비스를 제공합니다.

ServiceItem

단일 서비스 항목을 설명하는 메시지입니다. 판매자가 제공하는 서비스 유형을 설명하는 데 사용됩니다. 예를 들어 이발은 서비스가 될 수 있습니다.

필드
price	Money 선택사항입니다. 서비스 항목의 금전적 가격을 나타냅니다. 가격을 포함할 때는 currency_code 및 단위를 설정하는 것이 좋습니다. 이 가격은 서비스 항목의 고정 가격으로 처리됩니다.
통합 필드 service_item_info. 다음 필드 중 하나를 항상 설정해야 합니다. service_item_info은 다음 중 하나여야 합니다.
structured_service_item	StructuredServiceItem 선택사항입니다. 이 필드는 구조화된 서비스 데이터의 케이스로 설정됩니다.
free_form_service_item	FreeFormServiceItem 선택사항입니다. 이 필드는 자유 형식 서비스 데이터의 경우로 설정됩니다.

FreeFormServiceItem

판매자가 제공하는 자유 형식의 서비스를 나타냅니다. Google 구조 서비스 데이터의 일부로 노출되지 않는 서비스입니다. 판매자는 지오판매자 표시 경로를 통해 이러한 서비스의 이름을 직접 입력합니다.

필드
category	string 필수 항목입니다. 이 필드는 카테고리 이름 (카테고리의 안정적인 ID)을 나타냅니다. category 및 service_type_id는 Category 메시지에 제공된 가능한 조합과 일치해야 합니다.
label	Label 필수 항목입니다. 언어 태그가 지정된 항목 라벨입니다. 항목 이름은 140자(영문 기준) 이하, 설명은 250자(영문 기준) 이하여야 합니다. 이 필드는 입력이 맞춤 서비스 항목인 경우에만 설정해야 합니다. 표준화된 서비스 유형은 service_type_id를 통해 업데이트해야 합니다.

StructuredServiceItem

판매자가 제공하는 구조화된 서비스를 나타냅니다. 예: toilet_installation

필드
service_type_id	string 필수 항목입니다. service_type_id 필드는 Google에서 제공하는 고유 ID로, ServiceType에서 확인할 수 있습니다. 이 정보는 BatchGetCategories RPC 서비스에서 제공합니다.
description	string 선택사항입니다. 구조화된 서비스 항목에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다.

ServiceType

비즈니스에서 제공하는 서비스 유형을 설명하는 메시지입니다.

필드
service_type_id	string 출력 전용. 이 서비스 유형의 안정적인 ID입니다 (Google에서 제공).
display_name	string 출력 전용. 사람이 읽을 수 있는 서비스 유형의 표시 이름입니다.

SpecialHourPeriod

위치의 영업시간이 정상 영업시간과 다른 경우 단일 기간을 나타냅니다. 특별 영업시간에 표시되는 범위는 24시간 미만이어야 합니다. open_time 및 start_date는 close_time 및 end_date보다 이전이어야 합니다. close_time 및 end_date는 지정된 start_date 다음 날 오전 11시 59분까지 연장할 수 있습니다. 예를 들어 다음 입력은 유효합니다.

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

다음 입력은 유효하지 않습니다.

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00

필드
start_date	Date 필수 항목입니다. 특별 영업시간 기간이 시작되는 캘린더 날짜입니다.
open_time	TimeOfDay 선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. closed이 false인 경우 지정해야 합니다.
end_date	Date 선택사항입니다. 특별 영업시간 기간이 종료되는 캘린더 날짜입니다. end_date 필드가 설정되지 않으면 start_date에 지정된 날짜가 기본값입니다. 설정하는 경우 이 필드는 start_date 이후 1일 이하여야 합니다.
close_time	TimeOfDay 선택사항입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다. closed이 false인 경우 지정해야 합니다.
closed	bool 선택사항입니다. true인 경우 end_date, open_time, close_time는 무시되며 start_date에 지정된 날짜는 위치가 하루 종일 휴업한 것으로 처리됩니다.

SpecialHours

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

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

TimePeriod

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

필드
open_day	DayOfWeek 필수 항목입니다. 이 기간이 시작되는 day of the week를 나타냅니다.
open_time	TimeOfDay 필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.
close_day	DayOfWeek 필수 항목입니다. 이 기간이 끝나는 day of the week를 나타냅니다.
close_time	TimeOfDay 필수 항목입니다. 유효한 값은 00:00~24:00이며, 여기서 24:00은 지정된 일 필드 끝의 자정을 나타냅니다.

UpdateAttributesRequest

AttributesService.UpdateAttributes 요청입니다.

필드
attributes	Attributes 업데이트해야 하는 속성의 모음입니다.
attribute_mask	FieldMask 필수 항목입니다. 업데이트할 속성의 속성 이름입니다. attributes/{attribute}로 표시됩니다. 업데이트: 업데이트하려는 속성 필드에 제공된 모든 속성은 attribute_mask에서 설정해야 합니다. 위 목록에 설정되었지만 attribute_mask에는 설정되지 않은 속성은 무시됩니다. 삭제: 특정 속성을 삭제하려면 속성 목록에 일치하는 항목 없이 attribute_mask에 지정해야 합니다. 위치에 설정된 모든 속성을 삭제하려면 위치에 해당하는 모든 속성을 검색한 다음 속성 필드가 비어 있는 attribute_mask에 추가해야 합니다.

UpdateLocationRequest

Locations.UpdateLocation 요청 메시지입니다.

필드
location	Location 필수 항목입니다. 업데이트된 위치 정보입니다.
update_mask	FieldMask 필수 항목입니다. 업데이트할 특정 필드입니다.
validate_only	bool 선택사항입니다. true인 경우 실제로 위치를 업데이트하지 않고 요청의 유효성이 검사됩니다. 이 필드가 설정되면 유효성 검사 오류가 있는 경우에만 오류가 반환됩니다. 오류가 발견되지 않으면 응답이 비어 있습니다.

UriAttributeValue

URL이 value_type인 속성 값입니다.

필드
uri	string 필수 항목입니다. 이 속성에 제안된 URI 값입니다.