REST Resource: accounts.locations

Ресурс: Местоположение

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

JSON-представление
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Поля
name

string

Идентификатор Google для этого местоположения в форме: locations/{locationId} .

languageCode

string

Неизменяемый. Язык локации. Устанавливается при создании и не подлежит обновлению.

storeCode

string

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

title

string

Необходимый. Название местоположения должно отражать реальное название вашей компании, которое постоянно используется на витрине вашего магазина, на веб-сайте и на канцелярских товарах и известно клиентам. Любая дополнительная информация, если она уместна, может быть включена в другие поля ресурса (например, Address , Categories ). Не добавляйте к своему имени ненужную информацию (например, отдавайте предпочтение «Google», а не «Google Inc. — штаб-квартира компании в Маунтин-Вью»). Не включайте маркетинговые слоганы, коды магазинов, специальные символы, часы работы или статус «закрыто/открыто», номера телефонов, URL-адреса веб-сайтов, информацию об услугах/продуктах, местоположение/адрес или направления, а также информацию о правилах содержания (например, «Chase ATM в Дуэйн-Риде»). ").

phoneNumbers

object ( PhoneNumbers )

Необязательный. Различные номера телефонов, которые клиенты могут использовать, чтобы связаться с компанией.

categories

object ( Categories )

Необязательный. Различные категории, описывающие бизнес.

storefrontAddress

object ( PostalAddress )

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

websiteUri

string

Необязательный. URL-адрес этой компании. Если возможно, используйте URL-адрес, который представляет это отдельное местоположение компании, а не общий веб-сайт/URL-адрес, который представляет все местоположения или бренд.

regularHours

object ( BusinessHours )

Необязательный. График работы предприятия.

specialHours

object ( SpecialHours )

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

serviceArea

object ( ServiceAreaBusiness )

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

labels[]

string

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

adWordsLocationExtensions

object ( AdWordsLocationExtensions )

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

latlng

object ( LatLng )

Необязательный. Предоставляемые пользователем широта и долгота. При создании местоположения это поле игнорируется, если предоставленный адрес геокодируется успешно. Это поле возвращается только в запросах на получение, если предоставленное пользователем значение latlng было принято во время создания или значение latlng было обновлено через веб-сайт профиля компании в Google. Это поле могут обновлять только одобренные клиенты.

openInfo

object ( OpenInfo )

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

metadata

object ( Metadata )

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

profile

object ( Profile )

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

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

relationshipData

object ( RelationshipData )

Необязательный. Все локации и сеть, связанные с этим.

moreHours[]

object ( MoreHours )

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

serviceItems[]

object ( ServiceItem )

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

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

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

JSON-представление
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Поля
primaryPhone

string

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

additionalPhones[]

string

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

Категории

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

JSON-представление
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Поля
primaryCategory

object ( Category )

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

additionalCategories[]

object ( Category )

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

Категория

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

JSON-представление
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Поля
name

string

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

displayName

string

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

serviceTypes[]

object ( ServiceType )

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

moreHoursTypes[]

object ( MoreHoursType )

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

Тип сервиса

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

JSON-представление
{
  "serviceTypeId": string,
  "displayName": string
}
Поля
serviceTypeId

string

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

displayName

string

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

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

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

JSON-представление
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Поля
hoursTypeId

string

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

displayName

string

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

localizedDisplayName

string

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

Почтовый адрес

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

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

Советы по вводу/редактированию адреса: – Используйте виджет адреса, готовый к интернационализации, например https://github.com/google/libaddressinput . – Пользователям не должны предоставляться элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где это поле есть. использовал.

Дополнительные инструкции по использованию этой схемы см. на странице https://support.google.com/business/answer/6397478 .

JSON-представление
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Поля
revision

integer

Версия схемы PostalAddress . Это значение должно быть установлено на 0, что соответствует последней версии.

Все новые версии должны быть обратно совместимы со старыми версиями.

regionCode

string

Необходимый. CLDR-код региона страны/региона адреса. Это никогда не предполагается, и пользователь должен убедиться в правильности значения. Подробности см. на https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: «CH» для Швейцарии.

languageCode

string

Необязательный. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не имеет решающего значения для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

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

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

postalCode

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

Необязательный. Название организации по адресу.

Часы работы

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

JSON-представление
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Поля
periods[]

object ( TimePeriod )

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

ВремяПериод

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

JSON-представление
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Поля
openDay

enum ( DayOfWeek )

Необходимый. Указывает day of the week с которого начинается этот период.

openTime

object ( TimeOfDay )

Необходимый. Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня.

closeDay

enum ( DayOfWeek )

Необходимый. Указывает day of the week в который заканчивается этот период.

closeTime

object ( TimeOfDay )

Необходимый. Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня.

ДеньНедели

Представляет день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

ВремяДня

Обозначает время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. API может разрешить високосные секунды. Связанные типы: google.type.Date и google.protobuf.Timestamp .

JSON-представление
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Поля
hours

integer

Часы суток в 24-часовом формате. Должно быть от 0 до 23. API может разрешить использование значения «24:00:00» для таких сценариев, как время закрытия предприятия.

minutes

integer

Минуты часа дня. Должно быть от 0 до 59.

seconds

integer

Секунды минут времени. Обычно должно быть от 0 до 59. API может допускать значение 60, если он допускает дополнительные секунды.

nanos

integer

Доли секунды в наносекундах. Должно быть от 0 до 999 999 999.

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

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

JSON-представление
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Поля
specialHourPeriods[]

object ( SpecialHourPeriod )

Необходимый. Список исключений из обычного режима работы предприятия.

Специальный часпериод

Представляет один период времени, когда часы работы местоположения отличаются от обычных часов работы. Особый часовой период должен представлять собой диапазон менее 24 часов. openTime и startDate должны предшествовать closeTime и endDate . closeTime и endDate могут продлиться до 11:59 на следующий день после указанного startDate . Например, допустимы следующие входные данные:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Следующие входные данные недействительны:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON-представление
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Поля
startDate

object ( Date )

Необходимый. Календарная дата начала этого особого часового периода.

openTime

object ( TimeOfDay )

Необязательный. Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня. Должно быть указано, если closed имеет значение false.

endDate

object ( Date )

Необязательный. Календарная дата окончания этого особого часового периода. Если поле endDate не задано, по умолчанию используется дата, указанная в startDate . Если установлено, это поле должно быть равно или не превышать 1 дня после startDate .

closeTime

object ( TimeOfDay )

Необязательный. Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня. Должно быть указано, если closed имеет значение false.

closed

boolean

Необязательный. Если true, endDate , openTime и closeTime игнорируются, а дата, указанная в startDate рассматривается как местоположение, закрывающееся на весь день.

Дата

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

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Связанные типы:

JSON-представление
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должно быть от 1 до 31 и действительно для года и месяца, или 0, чтобы указать год отдельно или год и месяц, если день не имеет значения.

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

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

JSON-представление
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Поля
businessType

enum ( BusinessType )

Необходимый. Указывает [тип] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] компании в зоне обслуживания.

places

object ( Places )

Территория, которую обслуживает этот бизнес, определяется набором мест.

regionCode

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, обновление местоположения должно включать маску поля storefrontAddress и устанавливать это поле пустым.
CUSTOMER_AND_BUSINESS_LOCATION Предлагает услуги по служебному адресу и в окрестностях.

Места

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

JSON-представление
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Поля
placeInfos[]

object ( PlaceInfo )

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

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

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

JSON-представление
{
  "placeName": string,
  "placeId": string
}
Поля
placeName

string

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

placeId

string

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

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

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

JSON-представление
{
  "adPhone": string
}
Поля
adPhone

string

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

ШиротаДлительность

Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.

JSON-представление
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Оно должно находиться в диапазоне [-180,0, +180,0].

ОпенИнфо

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

JSON-представление
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Поля
status

enum ( OpenForBusiness )

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

canReopen

boolean

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

openingDate

object ( Date )

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

OpenForBusiness

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

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

Метаданные

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

JSON-представление
{
  "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
}
Поля
hasGoogleUpdated

boolean

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

hasPendingEdits

boolean

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

canDelete

boolean

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

canOperateLocalPost

boolean

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

canModifyServiceList

boolean

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

canHaveFoodMenus

boolean

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

canOperateHealthData

boolean

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

canOperateLodgingData

boolean

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

placeId

string

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

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

duplicateLocation

string

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

mapsUri

string

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

newReviewUri

string

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

canHaveBusinessCalls

boolean

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

hasVoiceOfMerchant

boolean

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

Профиль

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

JSON-представление
{
  "description": string
}
Поля
description

string

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

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

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

JSON-представление
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Поля
parentLocation

object ( RelevantLocation )

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

childrenLocations[]

object ( RelevantLocation )

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

parentChain

string

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

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

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

JSON-представление
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Поля
placeId

string

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

relationType

enum ( RelationType )

Необходимый. Тип отношений.

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

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

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

БольшеЧасов

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

JSON-представление
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Поля
hoursTypeId

string

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

periods[]

object ( TimePeriod )

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

Сервиситем

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

JSON-представление
{
  "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.
}
Поля
price

object ( Money )

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

Поле объединения service_item_info . Всегда должно быть установлено одно из следующих полей. service_item_info может быть только одним из следующих:
structuredServiceItem

object ( StructuredServiceItem )

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

freeFormServiceItem

object ( FreeFormServiceItem )

Необязательный. В этом поле будет указан случай данных об услугах в свободной форме.

СтруктурированныйServiceItem

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

JSON-представление
{
  "serviceTypeId": string,
  "description": string
}
Поля
serviceTypeId

string

Необходимый. Поле serviceTypeId — это уникальный идентификатор, предоставленный Google, который можно найти в ServiceType . Эту информацию предоставляет RPC-сервис categories.batchGet .

description

string

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

FreeFormServiceItem

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

JSON-представление
{
  "category": string,
  "label": {
    object (Label)
  }
}
Поля
category

string

Необходимый. Это поле представляет имя категории (т. е. стабильный идентификатор категории). category и serviceTypeId должны соответствовать возможным комбинациям, указанным в сообщении Category .

label

object ( Label )

Необходимый. Ярлыки с языковыми тегами для элемента. Мы рекомендуем, чтобы имена элементов были длиной не более 140 символов, а описания — не более 250 символов. Это поле следует задавать только в том случае, если входные данные представляют собой индивидуальный элемент услуги. Стандартизированные типы услуг следует обновлять через serviceTypeId.

Этикетка

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

JSON-представление
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Поля
displayName

string

Необходимый. Отображаемое имя прайс-листа, раздела или позиции.

description

string

Необязательный. Описание прайс-листа, раздела или позиции.

languageCode

string

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

Деньги

Представляет сумму денег с типом валюты.

JSON-представление
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Поля
currencyCode

string

Трехбуквенный код валюты, определенный в ISO 4217.

units

string ( int64 format)

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

nanos

integer

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

Методы

create

Создает новое местоположение, владельцем которого будет вошедший в систему пользователь.

list

Перечисляет местоположения для указанной учетной записи.