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 (сообщение)

АтрибутыСервис

Позволяет клиентам искать и обновлять атрибуты для данного местоположения.

Получить атрибуты
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 .

ЛистАтрибутМетаданные
rpc ListAttributeMetadata( ListAttributeMetadataRequest ) returns ( ListAttributeMetadataResponse ) Возвращает список атрибутов, которые будут доступны для местоположения с заданной основной категорией и страной. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

Обновление атрибутов
rpc UpdateAttributes( UpdateAttributesRequest ) returns ( Attributes ) Обновить атрибуты для данного местоположения. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

РубрикиСервис

Этот API предоставляет информацию о поддерживаемых категориях местоположений компаний в Google. Справочную информацию см. в разделе «Категории» этой статьи: https://support.google.com/business/answer/3038177.

Пакетное получение категорий
rpc BatchGetCategories( BatchGetCategoriesRequest ) returns ( BatchGetCategoriesResponse ) Возвращает список бизнес-категорий для указанного языка и идентификаторов GConcept. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

СписокКатегорий

rpc ListCategories( ListCategoriesRequest ) returns ( ListCategoriesResponse ) Возвращает список категорий бизнеса. Поиск будет соответствовать названию категории, но не ее идентификатору. Поиск соответствует только началу названия категории (то есть по запросу «еда» может выдаваться «Фуд-корт», но не «Ресторан быстрого питания»). Области авторизации Требуется следующая область действия 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 .

Поисковые цепочки
rpc SearchChains( SearchChainsRequest ) returns ( SearchChainsResponse ) Ищет цепочку по названию цепочки. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

GoogleМестаположения

Этот API обеспечивает доступ и поиск в GoogleLocation.

ПоискGoogleМестоположения
rpc SearchGoogleLocations( SearchGoogleLocationsRequest ) returns ( SearchGoogleLocationsResponse ) Найдите все возможные местоположения, соответствующие указанному запросу. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

Локации

Этот API позволяет управлять местоположениями компаний в Google.

Создать местоположение
rpc CreateLocation( CreateLocationRequest ) returns ( Location ) Создает новое местоположение, владельцем которого будет вошедший в систему пользователь. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

Удалить местоположение

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 .

Получить местоположение
rpc GetLocation( GetLocationRequest ) returns ( Location ) Возвращает указанное местоположение. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

СписокМестоположений
rpc ListLocations( ListLocationsRequest ) returns ( ListLocationsResponse ) Перечисляет местоположения для указанной учетной записи. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

ОбновитьМестоположение
rpc UpdateLocation( UpdateLocationRequest ) returns ( Location ) Обновляет указанное расположение. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/business.manage Дополнительную информацию см. в обзоре OAuth 2.0 .

Расширения местоположения AdWords

Дополнительная информация, отображаемая в AdWords.

Поля
ad_phone	string Необходимый. Альтернативный номер телефона, который будет отображаться в расширениях адресов AdWords вместо основного номера телефона местоположения.

Атрибут

Атрибут местоположения. Атрибуты предоставляют дополнительную информацию о местоположении. Атрибуты, которые можно задать для местоположения, могут различаться в зависимости от свойств этого местоположения (например, категории). Доступные атрибуты определяются Google и могут быть добавлены и удалены без изменений API.

Поля
name	string Необходимый. Имя ресурса для этого атрибута.
value_type	AttributeValueType Только вывод. Тип значения, которое содержит этот атрибут. Это следует использовать для определения того, как интерпретировать значение.
values[]	Value Значения этого атрибута. Тип предоставленных значений должен соответствовать ожидаемому для этого атрибута. Это повторяющееся поле, в котором могут быть указаны несколько значений атрибута. Типы атрибутов поддерживают только одно значение.
repeated_enum_value	RepeatedEnumAttributeValue Если тип значения атрибута — REPEATED_ENUM, он содержит значение атрибута, а остальные поля значений должны быть пустыми.
uri_values[]	UriAttributeValue Если типом значения атрибута является URL-адрес, это поле содержит значения для этого атрибута, а остальные поля значений должны быть пустыми.

АтрибутМетаданные

Метаданные для атрибута. Содержит отображаемую информацию для атрибута, включая локализованное имя и заголовок для группировки связанных атрибутов.

Поля
parent	string Уникальный идентификатор атрибута.
value_type	AttributeValueType Тип значения атрибута. Ожидается, что установленные и полученные значения будут относиться к этому типу.
display_name	string Локализованное отображаемое имя атрибута, если оно доступно; в противном случае — отображаемое имя на английском языке.
group_display_name	string Локализованное отображаемое имя группы, содержащей этот атрибут, если доступно; в противном случае — английское название группы. Связанные атрибуты собраны в группу и должны отображаться вместе под указанным здесь заголовком.
repeatable	bool Если это правда, атрибут поддерживает несколько значений. Если значение false, следует указать только одно значение.
value_metadata[]	AttributeValueMetadata Для некоторых типов атрибутов (например, перечислений) предоставляется список поддерживаемых значений и соответствующие отображаемые имена для этих значений.
deprecated	bool Если это правда, атрибут устарел и больше не должен использоваться. Если он устарел, обновление этого атрибута не приведет к ошибке, но обновления не будут сохранены. В какой-то момент после устаревания атрибут будет полностью удален, и это станет ошибкой.

АтрибутЗначениеМетаданные

Метаданные для поддерживаемых значений атрибутов.

Поля
value	Value Значение атрибута.
display_name	string Отображаемое имя для этого значения, локализованное, если оно доступно; иначе на английском языке. Отображаемое имя значения предназначено для использования в контексте с отображаемым именем атрибута. Например, для атрибута перечисления «WiFi» оно может содержать «Paid», обозначающее платный Wi-Fi.

АтрибутЗначениеТип

Тип значения атрибута.

Перечисления
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED	Не указан.
BOOL	Значения этого атрибута являются логическими.
ENUM	Атрибут имеет заранее определенный список доступных значений, которые можно использовать. В метаданных для этого атрибута будут перечислены эти значения.
URL	Значениями этого атрибута являются URL-адреса.
REPEATED_ENUM	Значение атрибута представляет собой перечисление с несколькими возможными значениями, которые можно явно установить или удалить.

Атрибуты

Контейнер для всех атрибутов данного местоположения.

Поля
name	string Необходимый. Идентификатор Google для этого местоположения в формате locations/{location_id}/attributes .
attributes[]	Attribute Коллекция атрибутов, которые необходимо обновить.

Пакетный запрос категорий GetCategories

Сообщение запроса для BusinessCategories.BatchGetBusinessCategories.

Поля
names[]	string Необходимый. Должно быть установлено хотя бы одно имя. Идентификаторы GConcept, для которых должны быть возвращены локализованные имена категорий. Чтобы вернуть сведения для более чем одной категории, повторите этот параметр в запросе.
language_code	string Необходимый. Код языка BCP 47, на котором должны быть возвращены имена категорий.
region_code	string Необязательный. Код страны ISO 3166-1 альфа-2, используемый для определения нестандартного языка.
view	CategoryView Необходимый. Указывает, какие части ресурса категории должны быть возвращены в ответе.

Пакетный метод GetCategoriesResponse

Ответное сообщение для BusinessCategories.BatchGetBusinessCategories.

Поля
categories[]	Category Категории, соответствующие идентификаторам GConcept, указанным в запросе. Они не будут идти в том же порядке, что и идентификаторы категорий в запросе.

Рабочие часы

Представляет периоды времени, в течение которых это местоположение открыто для бизнеса. Содержит коллекцию экземпляров [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Поля
periods[]	TimePeriod Необходимый. Подборка случаев, когда это заведение было открыто для бизнеса. Каждый период представляет собой диапазон часов, в течение которых заведение открыто в течение недели.

Категории

Коллекция категорий, описывающих бизнес. Во время обновлений оба поля должны быть установлены. Клиентам запрещено индивидуально обновлять основные или дополнительные категории с помощью маски обновления.

Поля
primary_category	Category Необходимый. Категория, которая лучше всего описывает основной бизнес, которым занимается данное заведение.
additional_categories[]	Category Необязательный. Дополнительные категории для описания вашего бизнеса. Категории помогают вашим клиентам находить точные и конкретные результаты по интересующим их услугам. Чтобы информация о вашей компании была точной и актуальной, убедитесь, что вы используете как можно меньше категорий для описания вашего основного бизнеса в целом. Выбирайте категории, которые максимально конкретны, но отражают ваш основной бизнес.

Категория

Категория, описывающая, чем является этот бизнес (а не чем он занимается). Список допустимых идентификаторов категорий и сопоставлений с их удобочитаемыми именами см. в разделе categories.list .

Поля
name	string Необходимый. Стабильный идентификатор (предоставленный Google) для этой категории. Значение необходимо указывать при изменении категории (при создании или обновлении локации).
display_name	string Только вывод. Читабельное имя категории. Это устанавливается при чтении местоположения. При изменении местоположения необходимо установить category_id .
service_types[]	ServiceType Только вывод. Список всех типов услуг, доступных для этой бизнес-категории.
more_hours_types[]	MoreHoursType Только вывод. Дополнительные типы часов, доступные для этой категории бизнеса.

КатегорияПросмотр

Перечисление, помогающее ограничить объем данных, возвращаемых сервером.

Перечисления
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 Количество локаций, входящих в эту цепочку.

Имяцепи

Имя, которое будет использоваться при отображении цепочки.

Поля
display_name	string Отображаемое имя этой цепочки.
language_code	string Код языка названия BCP 47.

ЦепнойУри

URL-адрес, который будет использоваться при отображении цепочки.

Поля
uri	string URI для этой цепочки.

Создать запрос местоположения

Сообщение запроса для Locations.CreateLocation.

Поля
parent	string Необходимый. Имя учетной записи, в которой необходимо создать это местоположение.
location	Location Необходимый. Новые метаданные местоположения.
validate_only	bool Необязательный. Если это правда, запрос проверяется без фактического создания местоположения.
request_id	string Необязательный. Уникальный идентификатор запроса, позволяющий серверу обнаруживать дублированные запросы. Мы рекомендуем использовать UUID. Максимальная длина — 50 символов.

Удалитьлокационный запрос

Сообщение запроса для Locations.DeleteLocation.

Поля
name	string Необходимый. Имя места, которое нужно удалить.

Код ошибки

Все коды ошибок, возвращаемые API.

Перечисления
ERROR_CODE_UNSPECIFIED	Отсутствует код ошибки.
INVALID_ATTRIBUTE_NAME	К этому местоположению нельзя применить один из предоставленных атрибутов. К этому местоположению можно применять только атрибуты, возвращаемые в ответе ListAttributeMetadata . Все проблемные имена атрибутов будут возвращены в ключе attribute_names в метаданных.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION	Эта ошибка возвращается, когда клиент пытается связать местоположение или очистить связь с местоположением, которое находится в проверенном состоянии.
ASSOCIATE_LOCATION_INVALID_PLACE_ID	place_id , указанный в запросе associateLocation , не соответствует местоположению или недействителен. Убедитесь, что устанавливаемый place_id соответствует одному из идентификаторов, возвращаемых в ответе SearchGoogleLocations .
LAT_LNG_UPDATES_NOT_PERMITTED	Этому проекту не разрешено обновлять поле широты и долготы в местоположении. Вы можете либо обновить широту/долготу, используя функцию перетаскивания булавок в пользовательском интерфейсе, либо предоставить нам адрес.
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	УСТАРЕЛО. Заменено 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	В адресе отсутствует необходимый код региона. Ключи метаданных включают «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	Special_hours не могут перекрываться. Ключи метаданных включают «field_mask».
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY	Основная категория вашей компании не поддерживает этот тип часов. Ключи метаданных включают «field_mask» и «inсовместимый_hours_type».
DUPLICATE_CHILDREN_LOCATIONS	Дублируйте Children_locations в Relationship_data. Ключи метаданных включают «field_mask».
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY	Компания в зоне обслуживания не может иметь выбранную основную категорию. Ключи метаданных включают «field_mask».
INVALID_SERVICE_AREA_PLACE_ID	Неверный 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	Введите дату открытия в пределах года. Ключи метаданных включают «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	Неверный идентификатор категории. Ключи метаданных включают «field_mask» и «value».
CANNOT_REOPEN	Бизнес не может возобновить работу. Ключи метаданных включают «field_mask».
INVALID_BUSINESS_OPENING_DATE	Неверная дата открытия бизнеса. Ключи метаданных включают «field_mask».
INVALID_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	Неизвестное значение атрибута перечисления. Ключи метаданных включают «attribute_name».
ATTRIBUTE_NOT_AVAILABLE	Масштабируемый атрибут недействителен для этого местоположения. Ключи метаданных включают «имя_атрибута».
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, которые являются подтипами gcid:making_poi. Ключи метаданных включают «field_mask» и «value».
RELATION_ENDPOINTS_TOO_FAR	Конечные точки отношений находятся слишком далеко друг от друга. Ключи метаданных включают «field_mask» и «value».
INVALID_SERVICE_ITEM	Ни структурированный_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	Отсутствует поле Category_id в free_form_service_item. Ключи метаданных включают «field_mask».
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL	Отсутствует ярлык в free_form_service_item. Ключи метаданных включают «field_mask».
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID	Отсутствует поле service_type_id в структурированном_service_item. Ключи метаданных включают «field_mask».
INVALID_LANGUAGE	Код языка недействителен. Ключи метаданных включают «field_mask».
PRICE_CURRENCY_MISSING	Отсутствует код валюты ISO 4217. Ключи метаданных включают «field_mask».
PRICE_CURRENCY_INVALID	Указанный код валюты недействителен в соответствии со стандартом ISO 4217. Ключи метаданных включают «field_mask».
SERVICE_TYPE_ID_DUPLICATE	Идентификаторы типов услуг не уникальны в пределах местоположения. Ключи метаданных включают «field_mask».
PIN_DROP_REQUIRED	Указанный адрес не может быть найден. Пожалуйста, используйте пользовательский интерфейс, чтобы добавить булавку. Ключи метаданных включают «field_mask».
STALE_DATA	Один или несколько элементов были недавно обновлены Google. В настоящее время только владелец этой компании может вносить изменения в данные, расположенные в поле "field", посетив сайт business.google.com. Ключи метаданных включают «field_mask».
PHONE_NUMBER_EDITS_NOT_ALLOWED	Поле номера телефона для этого местоположения отключено, и его редактирование запрещено. Ключи метаданных включают «field_mask».
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION	Существует более одного отношения, моделирующего логическое отношение между двумя местоположениями (например, деперация, работа). Ключи метаданных включают «field_mask» и «value».

Получить атрибуты запрос

Запрос 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 Необходимый. Прочитайте маску, чтобы указать, какие поля будут возвращены в ответе.

Получить запрос местоположения

Сообщение запроса для Locations.GetLocation.

Поля
name	string Необходимый. Имя места для получения.
read_mask	FieldMask Необходимый. Прочитайте маску, чтобы указать, какие поля будут возвращены в ответе.

GoogleМестоположение

Представляет Location , которое присутствует в Google. Это может быть местоположение, на которое заявили права пользователь или кто-то другой, или оно может быть невостребованным.

Поля
name	string Имя ресурса этого GoogleLocation в формате googleLocations/{googleLocationId} .
location	Location Малонаселенная информация Location . Это поле можно повторно использовать в CreateLocation , если оно в настоящее время не востребовано пользователем.
request_admin_rights_uri	string URL-адрес, который перенаправит пользователя в пользовательский интерфейс запроса прав администратора. Это поле присутствует только в том случае, если местоположение уже было заявлено каким-либо пользователем, включая текущего пользователя.

GoogleОбновленноеМестоположение

Представляет местоположение, измененное Google.

Поля
location	Location Обновленная Google версия этого места.
diff_mask	FieldMask Поля, которые Google обновил.
pending_mask	FieldMask Поля, в которых есть ожидающие изменения, которые еще не были перенесены в Карты и Поиск.

Этикетка

Метка, которая будет использоваться при отображении прайс-листа, раздела или товара.

Поля
display_name	string Необходимый. Отображаемое имя прайс-листа, раздела или товара.
description	string Необязательный. Описание прайс-листа, раздела или позиции.
language_code	string Необязательный. Код языка BCP-47, к которому применяются эти строки. Для каждого языка можно установить только один набор меток.

ListAttributeMetadataRequest

Запрос AttributesService.ListAttributeMetadata.

Поля
parent	string Имя ресурса местоположения для поиска доступных атрибутов. Если это поле установлено, имя_категории, код_региона, код_языка и show_all не являются обязательными и не должны быть установлены.
category_name	string Стабильный идентификатор основной категории для поиска доступных атрибутов. Должно быть в формате категории/{category_id}.
region_code	string Код страны ISO 3166-1 альфа-2 для поиска доступных атрибутов.
language_code	string Код языка BCP 47, на котором будут отображаться отображаемые имена атрибутов. Если этот язык недоступен, они будут предоставлены на английском языке.
show_all	bool Метаданные для всех доступных атрибутов возвращаются, если для этого поля установлено значение true, игнорируя поля «родитель» и «имя_категории». Language_code и Region_code необходимы, если для параметра show_all установлено значение true.
page_size	int32 Сколько атрибутов включить на страницу. По умолчанию — 200, минимум — 1.
page_token	string Если указано, извлекается следующая страница метаданных атрибута.

ListAttributeMetadataResponse

Ответ для AttributesService.ListAttributeMetadata.

Поля
attribute_metadata[]	AttributeMetadata Коллекция метаданных атрибутов для доступных атрибутов.
next_page_token	string Если количество атрибутов превысило запрошенный размер страницы, это поле будет заполнено токеном для получения следующей страницы атрибутов при последующем вызове attributes.list . Если атрибутов больше нет, это поле не будет присутствовать в ответе.

СписокКатегорийЗапрос

Сообщение запроса для BusinessCategories.ListCategories.

Поля
region_code	string Необходимый. Код страны ISO 3166-1 альфа-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 .

СписокМестоположенийЗапрос

Сообщение запроса для 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, описание_кода_магазина», «заголовок» или «описание_кода_магазина».
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», а не «Google Inc. — штаб-квартира компании в Маунтин-Вью»). Не включайте маркетинговые слоганы, коды магазинов, специальные символы, часы работы или статус «закрыто/открыто», номера телефонов, URL-адреса веб-сайтов, информацию об услугах/продуктах, местоположение/адрес или направления, а также информацию о правилах содержания (например, «Chase ATM в Дуэйн-Риде»). ").
phone_numbers	PhoneNumbers Необязательный. Различные номера телефонов, которые клиенты могут использовать, чтобы связаться с компанией.
categories	Categories Необязательный. Различные категории, описывающие бизнес.
storefront_address	PostalAddress Необязательный. Точный и точный адрес, описывающий местоположение вашей компании. Почтовые ящики или почтовые ящики, расположенные в удаленных местах, не принимаются. На данный момент вы можете указать в адресе максимум пять значений 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 Необязательный. Дополнительная информация, отображаемая в AdWords.
latlng	LatLng Необязательный. Предоставляемые пользователем широта и долгота. При создании местоположения это поле игнорируется, если предоставленный адрес геокодируется успешно. Это поле возвращается только в запросах на получение, если предоставленное пользователем значение latlng было принято во время создания или значение latlng было обновлено через веб-сайт профиля компании в Google. Это поле могут обновлять только одобренные клиенты.
open_info	OpenInfo Необязательный. Флаг, указывающий, открыто ли в данный момент местоположение для бизнеса.
metadata	Metadata Только вывод. Дополнительная нередактируемая пользователем информация.
profile	Profile Необязательный. Описывает ваш бизнес собственным голосом и делится с пользователями уникальной историей вашего бизнеса и предложений. Это поле является обязательным для всех категорий, кроме категорий размещения (например, гостиницы, мотели, гостиницы).
relationship_data	RelationshipData Необязательный. Все локации и сеть, связанные с этим.
more_hours[]	MoreHours Необязательный. Больше часов для различных отделов компании или конкретных клиентов.
service_items[]	ServiceItem Необязательный. Список услуг, поддерживаемых продавцами. Услугой может быть стрижка, установка водонагревателя и т. д. Дублирующиеся позиции услуги будут удалены автоматически.

Метаданные

Дополнительная нередактируемая пользователем информация о местоположении.

Поля
has_google_updated	bool Только вывод. Указывает, есть ли в идентификаторе места, связанном с этим местоположением, обновления, которые необходимо обновить или отклонить клиентом. Если это логическое значение установлено, вам следует вызвать метод 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, это поле заполняется идентификатором места для этого местоположения. Этот идентификатор можно использовать в различных API-интерфейсах Places. Это поле можно задать во время вызовов Create, но не для Update.
duplicate_location	string Только вывод. Ресурс местоположения, который дублирует это местоположение.
maps_uri	string Только вывод. Ссылка на местоположение на Картах.
new_review_uri	string Только вывод. Ссылка на страницу в Google Поиске, где клиент может оставить отзыв о местоположении.
can_have_business_calls	bool Только вывод. Указывает, разрешено ли объявление для деловых звонков.
has_voice_of_merchant	bool Только вывод. Указывает, есть ли в объявлении голос продавца. Если это логическое значение ложно, вам следует вызвать API location.getVoiceOfMerchantState, чтобы получить подробную информацию о том, почему у них нет Voice of Merchant.

БольшеЧасов

Периоды времени, в течение которых местоположение открыто для определенных видов бизнеса.

Поля
hours_type_id	string Необходимый. Тип часов. Клиентам следует вызвать {#link businessCategories:BatchGet}, чтобы получить поддерживаемые типы часов для категорий их местоположений.
periods[]	TimePeriod Необходимый. Коллекция раз, когда это место было открыто. Каждый период представляет собой диапазон часов, в течение которых заведение открыто в течение недели.

ПодробнееЧасыТип

Дополнительные типы часов, которые компания может предложить в дополнение к своим обычным часам.

Поля
hours_type_id	string Только вывод. Стабильный идентификатор, предоставленный Google для этого типа часов.
display_name	string Только вывод. Удобочитаемое английское отображаемое имя для типа часов.
localized_display_name	string Только вывод. Удобочитаемое локализованное отображаемое имя для типа часов.

ОпенИнфо

Информация, касающаяся состояния открытия бизнеса.

Поля
status	OpenForBusiness Необходимый. Указывает, открыто ли местоположение в настоящее время для бизнеса. Все локации открыты по умолчанию, если не обновлено положение о закрытии.
can_reopen	bool Только вывод. Указывает, имеет ли этот бизнес право на повторное открытие.
opening_date	Date Необязательный. Дата первого открытия заведения. Если точный день неизвестен, можно указать только месяц и год. Дата должна быть в прошлом или не позднее одного года в будущем.

Открыт для бизнеса

Указывает статус местоположения.

Перечисления
OPEN_FOR_BUSINESS_UNSPECIFIED	Не указан.
OPEN	Указывает, что локация открыта.
CLOSED_PERMANENTLY	Указывает, что местоположение закрыто навсегда.
CLOSED_TEMPORARILY	Указывает, что локация временно закрыта.

Телефонные номера

Коллекция телефонных номеров для бизнеса. Во время обновлений оба поля должны быть установлены. Клиенты не могут обновлять только основные или дополнительные номера телефонов, используя маску обновления. Предпочтителен международный формат телефона, например «[phone]», подробнее см. ( https://developers.google.com/style/phone-numbers#international-phone-numbers) .

Поля
primary_phone	string Необходимый. Номер телефона, который максимально напрямую связан с местоположением вашей компании. По возможности используйте местный номер телефона вместо центрального номера службы поддержки колл-центра.
additional_phones[]	string Необязательный. До двух телефонных номеров (мобильный или стационарный, без факса), по которым можно позвонить в вашу компанию, в дополнение к вашему основному номеру телефона.

Информация о месте

Определяет область, представленную идентификатором места.

Поля
place_name	string Необходимый. Локализованное название места. Например, Scottsdale, AZ .
place_id	string Необходимый. Идентификатор места. Должно соответствовать региону. ( https://developers.google.com/places/web-service/supported_types#table3 )

Места

Определяет объединение территорий, представленных набором мест.

Поля
place_infos[]	PlaceInfo Области, представленные идентификаторами мест. Ограничено максимум 20 местами.

Профиль

Вся информация, относящаяся к профилю местоположения.

Поля
description	string Необходимый. Описание локации своим голосом, недоступное для редактирования кем-либо еще.

Данные отношений

Информация обо всех родительских и дочерних местоположениях, связанных с этим.

Поля
parent_location	RelevantLocation Родительское местоположение, с которым это местоположение связано.
children_locations[]	RelevantLocation Список дочерних локаций, с которыми эта локация связана.
parent_chain	string Имя ресурса цепочки, членом которой является это местоположение. [Как найти идентификатор цепочки] [Locations.SearchChains]

СоответствующееМестоположение

Информация о другом местоположении, связанном с текущим. Отношение может быть любым из DEPARTMENT_OF или INDEPENDENT_ESTABLISHMENT_OF, а указанное здесь местоположение может находиться на любой стороне (родительском/дочернем) этого местоположения.

Поля
place_id	string Необходимый. Укажите местоположение, находящееся на другой стороне отношения, по его идентификатору места.
relation_type	RelationType Необходимый. Тип отношений.

Тип отношения

Отношения типов, которые необходимо указать.

Перечисления
RELATION_TYPE_UNSPECIFIED	Тип не указан.
DEPARTMENT_OF	Это представляет собой связь между двумя офисами, которые имеют одну физическую территорию, один и тот же бренд/высшее руководство/организацию, но с разными ключевыми атрибутами, такими как часы работы магазина или номера телефонов. Например, Costco Pharmacy — это отдел Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN	Это относится к случаям, когда два заведения расположены в одном физическом месте, но принадлежат разным компаниям (например, Starbucks в Safeway, магазины в торговом центре).

Повторенноеэнуматтрибутевалуе

Значения атрибута с value_type REPEATED_ENUM. Он состоит из двух списков идентификаторов значений: установленных (true) и неустановленных (false). Отсутствующие значения считаются неизвестными. Должно быть указано хотя бы одно значение.

Поля
set_values[]	string Установленные значения перечисления.
unset_values[]	string Значения перечисления, которые не установлены.

ПоискЦепиЗапрос

Сообщение запроса для Locations.SearchChains.

Поля
chain_name	string Необходимый. Найдите сеть по названию. Поддерживаются точные/частичные/нечеткие/связанные запросы. Примеры: «walmart», «wal-mart», «walmmart», «沃尔玛».
page_size	int32 Максимальное количество совпадающих цепочек, возвращаемых по этому запросу. По умолчанию — 10. Максимально возможное значение — 500.

SearchChainsResponse

Ответное сообщение для Locations.SearchChains.

Поля
chains[]	Chain Цепочки, соответствующие запрошенному Chain_display_name в SearchChainsRequest. Если совпадений нет, это поле будет пустым. Результаты перечислены в порядке релевантности.

ПоискGoogleМестоположенияЗапрос

Сообщение запроса для GoogleLocations.SearchGoogleLocations.

Поля
page_size	int32 Количество совпадений для возврата. Значение по умолчанию — 3, максимум — 10. Обратите внимание, что задержка может увеличиться, если запрошено большее количество. Пагинации нет.
Поле объединения search_query . Поисковый запрос. Это может быть предоставлено либо как объект местоположения, либо как строковый запрос. search_query может быть только одним из следующих:
location	Location Место для поиска. Если указано, будут найдены местоположения, соответствующие предоставленным данным о местоположении.
query	string Текстовый запрос для поиска. Результаты поиска по строке запроса будут менее точными, чем при указании точного местоположения, но могут давать больше неточных совпадений.

ПоискGoogleМестаОтвет

Ответное сообщение для GoogleLocations.SearchGoogleLocations.

Поля
google_locations[]	GoogleLocation Коллекция местоположений GoogleLocations, которые потенциально соответствуют указанному запросу, перечисленные в порядке от большей к меньшей точности.

СервисПлощадьБизнес

Предприятия зоны обслуживания предоставляют свои услуги по месту нахождения клиента (например, у слесаря ​​или сантехника).

Поля
business_type	BusinessType Необходимый. Указывает [тип] [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 и в противном случае игнорируется. Указанный здесь регион может отличаться от регионов для областей, которые обслуживает эта компания (например, компании зоны обслуживания, которые предоставляют услуги в регионах, отличных от того, в котором они базируются). Если это местоположение требует проверки после создания, адрес, указанный для целей проверки, должен находиться в этом регионе, а владелец бизнеса или его уполномоченный представитель должен иметь возможность получать почтовую почту по указанному адресу проверки.

Вид бизнеса

Указывает, предлагает ли эта компания услуги только на месте в месте нахождения клиента (например, эвакуатор) или одновременно по адресу и на месте (например, магазин пиццы с обеденной зоной, который также осуществляет доставку клиентам).

Перечисления
BUSINESS_TYPE_UNSPECIFIED	Только вывод. Не указан.
CUSTOMER_LOCATION_ONLY	Предлагает услуги только в окрестностях (не по служебному адресу). Если компания обновляется с CUSTOMER_AND_BUSINESS_LOCATION на CUSTOMER_LOCATION_ONLY, обновление местоположения должно включать маску поля storefront_address и устанавливать это поле пустым.
CUSTOMER_AND_BUSINESS_LOCATION	Предлагает услуги по адресу бизнеса и в окрестностях.

ServiceItem

Сообщение, которое описывает единый элемент службы. Он используется для описания типа услуг, который предоставляет продавец. Например, стрижка может быть услугой.

Поля
price	Money Необязательный. Представляет денежную цену товара обслуживания. Мы рекомендуем, чтобы Currency_code и Units были установлены при включении цены. Это будет рассматриваться как фиксированная цена для обслуживания.
Объединение Полевое service_item_info . Одно из следующих полей всегда должно быть установлено. service_item_info может быть только одним из следующих:
structured_service_item	StructuredServiceItem Необязательный. Это поле будет установлено в случае данных структурированных служб.
free_form_service_item	FreeFormServiceItem Необязательный. Это поле будет установлено в случае данных о свободной форме.

FreeFormServiceItem

Представляет собой услугу бесплатной формы, предлагаемая продавцом. Это услуги, которые не раскрываются как часть наших данных службы структуры. Торговец вручную вводит имена таких услуг через геомерхатную поверхность.

Поля
category	string Необходимый. Это поле представляет имя категории (т.е. стабильный идентификатор категории). category и service_type_id должны соответствовать возможным комбинациям, представленным в сообщении Category .
label	Label Необходимый. Языковые этикетки для предмета. Мы рекомендуем, чтобы имена элементов составляли 140 символов или меньше, а описания 250 символов или меньше. Это поле следует установить только в том случае, если вход является пользовательским элементом службы. Стандартизированные типы службы должны быть обновлены с помощью service_type_id.

Структурированная ServiceItem

Представляет структурированную услугу, предлагаемую продавцом. Например: Tailet_installation.

Поля
service_type_id	string Необходимый. Поле service_type_id - это Google, предоставляемый уникальным идентификатором, который можно найти в ServiceType . Эта информация предоставляется BatchGetCategories RPC Service.
description	string Необязательный. Описание структурированного элемента обслуживания. Предел символов 300.

Тип Обслуживания

Сообщение, описывающее тип услуги, который предлагает бизнес.

Поля
service_type_id	string Только вывод. Стабильный идентификатор (предоставленный Google) для этого типа службы.
display_name	string Только вывод. Число читаемого на дисплее имя для типа службы.

SpecialHourPeriod

Представляет собой один период времени, когда рабочие часы местоположения отличаются от обычных рабочих часов. Специальный час должен представлять собой диапазон менее 24 часов. open_time и start_date должны предшествовать close_time и end_date . close_time и end_date могут простираться до 11:59 утра на следующий день после указанной start_date . Например, следующие входы действительны:

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 является ложным.
end_date	Date Необязательный. Календарь дата дата этого особенного часа заканчивается. Если поле end_date не установлено, по умолчанию в дату, указанную в start_date . Если установлено, это поле должно быть равным или не более чем через 1 день после start_date .
close_time	TimeOfDay Необязательный. Допустимые значения: 00: 00-24: 00, где 24:00 представляет полуночи в конце указанного дня. Должен быть указан, если closed является ложным.
closed	bool Необязательный. Если true, end_date , open_time и close_time игнорируются, а дата, указанная в start_date , рассматривается как место, которое закрывается в течение всего дня.

Специальные часы

Представляет собой набор периодов времени, когда рабочие часы местоположения отличаются от обычных рабочих часов.

Поля
special_hour_periods[]	SpecialHourPeriod Необходимый. Список исключений из обычных часов бизнеса.

Временной период

Представляет собой много времени, когда бизнес открыт, начиная с указанного дня открытых дверей/времени и закрытия в указанный близкий день/время. Время закрытия должно произойти после времени открытия, например, в тот же день или в последующий день.

Поля
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 представляет полуночи в конце указанного дня.

Запрос обновления атрибутов

Запрос на AttributessErvice.UpdateatTributes.

Поля
attributes	Attributes Коллекция атрибутов, которые необходимо обновить.
attribute_mask	FieldMask Необходимый. Атрибут Имя атрибутов, которые вы хотели бы обновить. Представлено attributes/{attribute} . Обновления: все атрибуты, представленные в поле «Атрибуты», которые вы хотели бы обновить, должны быть установлены в attribute_mask . Атрибуты, установленные в приведенном выше списке, но не в attribute_mask , будут проигнорированы. Удаления: если вы хотите удалить определенные атрибуты, они должны быть указаны в attribute_mask без соответствующей записи в списке атрибутов. Если вы хотите удалить все атрибуты, установленные в месте, вам следует найти все применимые атрибуты для местоположения, а затем добавить их в attribute_mask в поле пустых атрибутов.

UpdateLocationRequest

Запросить сообщение о локации. UpdateLocation.

Поля
location	Location Необходимый. Обновленная информация о месте.
update_mask	FieldMask Необходимый. Конкретные поля для обновления.
validate_only	bool Необязательный. Если это правда, запрос проверяется без фактического обновления местоположения. Если это поле установлено, мы будем возвращать ошибки проверки только в том случае, если они были. Ответ будет пустым, если ошибок не обнаружено.

Uriattributevalue

Значения для атрибута с value_type URL.

Поля
uri	string Необходимый. Предлагаемое значение URI для этого атрибута.