REST Resource: accounts.locations

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

string

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

string

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

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

object ( Category )

Необходимый. Категория, которая лучше всего описывает основной бизнес, которым занимается данное заведение.

object ( Category )

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

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

string

Необходимый. Стабильный идентификатор (предоставленный Google) для этой категории. Значение необходимо указывать при изменении категории (при создании или обновлении локации).

string

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

object ( ServiceType )

Только вывод. Список всех типов услуг, доступных для этой бизнес-категории.

object ( MoreHoursType )

Только вывод. Дополнительные типы часов, доступные для этой категории бизнеса.

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

string

Только вывод. Стабильный идентификатор (предоставленный Google) для этого типа услуги.

string

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

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

string

Только вывод. Стабильный идентификатор, предоставленный Google для этого типа часов.

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 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не имеет решающего значения для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (вместо указания возможно неправильного значения по умолчанию).

Примеры: «ж-Хант», «джа», «джа-Латн», «ен».

string

Необязательный. Почтовый индекс адреса. Не все страны используют или требуют наличия почтовых индексов, но там, где они используются, они могут вызвать дополнительную проверку других частей адреса (например, проверка штата/почтового индекса в США).

string

Необязательный. Дополнительный код сортировки для конкретной страны. В большинстве регионов это не используется. Там, где оно используется, значение представляет собой либо строку типа «CEDEX», за которой необязательно следует число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «указатель зоны доставки». (Малави) или «индикатор почтового отделения» (например, Кот-д'Ивуар).

string

Необязательный. Высшее административное подразделение, используемое для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В частности, для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Многие страны не используют административную зону в почтовых адресах. Например, в Швейцарии это место следует оставить незаселенным.

string

Необязательный. Обычно относится к части адреса, посвященной городу. Примеры: город в США, ИТ-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте locality пустым и используйте адресные строки.

string

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

string

Неструктурированные адресные строки, описывающие нижние уровни адреса.

Поскольку значения в адресных строках не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был ясен. Порядок адресных строк должен быть «порядком конверта» для страны/региона адреса. В местах, где это может отличаться (например, в Японии), адрес_языка используется для явного указания (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для упорядочения от малого к большому). Таким образом, в зависимости от языка можно выбрать наиболее конкретную строку адреса.

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

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

string

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

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 . Если установлено, это поле должно быть равно или не превышать 1 дня после startDate .

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 )

Необходимый. Указывает [тип] [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 )

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

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

string

Необходимый. Локализованное название места. Например, Scottsdale, AZ .

string

Необходимый. Идентификатор места. Должно соответствовать региону. ( https://developers.google.com/places/web-service/supported_types#table3 )

{
  "adPhone": string
}

string

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

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

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

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

Только вывод. Указывает, есть ли в идентификаторе места, связанном с этим местоположением, обновления, которые необходимо обновить или отклонить клиентом. Если это логическое значение установлено, вам следует вызвать метод getGoogleUpdated для поиска информации, которую необходимо проверить.

boolean

Только вывод. Указывает, находятся ли какие-либо свойства этого местоположения в состоянии ожидания редактирования.

boolean

Только вывод. Указывает, можно ли удалить местоположение с помощью API.

boolean

Только вывод. Указывает, может ли объявление управлять локальными публикациями.

boolean

Только вывод. Указывает, может ли объявление изменять список услуг.

boolean

Только вывод. Указывает, подходит ли объявление для меню еды.

boolean

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

boolean

Только вывод. Указывает, может ли местоположение работать с данными о жилье.

string

Только вывод. Если это местоположение отображается на Картах Google, это поле заполняется идентификатором места для этого местоположения. Этот идентификатор можно использовать в различных API-интерфейсах Places.

Это поле можно задать во время вызовов Create, но не для Update.

string

Только вывод. Ресурс местоположения, который дублирует это местоположение.

string

Только вывод. Ссылка на местоположение на Картах.

string

Только вывод. Ссылка на страницу в Google Поиске, где клиент может оставить отзыв о местоположении.

boolean

Только вывод. Указывает, разрешено ли объявление для деловых звонков.

boolean

Только вывод. Указывает, есть ли в объявлении голос продавца. Если это логическое значение ложно, вам следует вызвать API location.getVoiceOfMerchantState, чтобы получить подробную информацию о том, почему у них нет Voice of Merchant.

{
  "description": string
}

string

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

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

object ( RelevantLocation )

Родительское местоположение, с которым это местоположение связано.

object ( RelevantLocation )

Список дочерних локаций, с которыми эта локация связана.

string

Имя ресурса цепочки, членом которой является это местоположение. [Как найти идентификатор цепочки] [Locations.SearchChains]

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

string

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

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, который можно найти в ServiceType . Эту информацию предоставляет RPC-сервис categories.batchGet .

string

Необязательный. Описание структурированной услуги. Лимит символов — 300.

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

string

Необходимый. Это поле представляет имя категории (т. е. стабильный идентификатор категории). 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.

string ( int64 format)

Целые единицы суммы. Например, если currencyCode равен "USD" , то 1 единица равна одному доллару США.

integer

Количество нано (10^-9) единиц суммы. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если units положительны, nanos должен быть положительным или нулевым. Если units равны нулю, nanos может быть положительным, нулевым или отрицательным. Если units измерения отрицательные, nanos должно быть отрицательным или нулевым. Например, -1,75 доллара США представлены как units = -1 и nanos = -750 000 000.