REST Resource: accounts.locations.localPosts

Ресурс: LocalPost

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

JSON-представление
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
Поля
name

string

Только вывод. Идентификатор Google для этого локального сообщения в форме: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}

languageCode

string

Язык местной почты.

summary

string

Описание/тело локальной публикации.

callToAction

object ( CallToAction )

URL-адрес, на который перенаправляются пользователи при переходе по промоакции. Игнорируется для типа темы OFFER .

createTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

Только вывод. Время последней модификации сообщения пользователем.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

event

object ( LocalPostEvent )

Информация о событии. Требуется для типов тем EVENT и OFFER .

state

enum ( LocalPostState )

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

media[]

object ( MediaItem )

СМИ, связанные с публикацией. sourceUrl — единственное поддерживаемое поле данных для LocalPost MediaItem.

searchUrl

string

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

topicType

enum ( LocalPostTopicType )

Необходимый. Тип темы публикации: стандартная, событие, предложение или предупреждение.

alertType

enum ( AlertType )

Тип оповещения, для которого создается сообщение. Это поле применимо только к сообщениям типа «ТемаТип оповещения» и ведет себя как подтип оповещений.

offer

object ( LocalPostOffer )

Дополнительные данные для постов с предложениями. Это значение следует устанавливать только в том случае, если для параметра themeType установлено значение OFFER.

Призыв к действию

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

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

enum ( ActionType )

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

url

string

URL-адрес, на который будет перенаправлен пользователь при нажатии. Это поле следует оставить незаполненным для призыва к действию «Позвонить».

Тип действия

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

Перечисления
ACTION_TYPE_UNSPECIFIED Тип не указан.
BOOK В этом сообщении пользователь хочет записаться на прием/стол/и т. д.
ORDER Этот пост хочет, чтобы пользователь что-то заказал.
SHOP В этом посте пользователь хочет просмотреть каталог продуктов.
LEARN_MORE Этот пост хочет, чтобы пользователь узнал больше (на своем веб-сайте).
SIGN_UP В этом сообщении пользователю предлагается зарегистрироваться/зарегистрироваться/присоединиться к чему-либо.
GET_OFFER

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

CALL В этом сообщении пользователь хочет позвонить в компанию.

Локалпостевент

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

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

string

Название мероприятия.

schedule

object ( TimeInterval )

Дата/время начала и окончания мероприятия.

Временной интервал

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

JSON-представление
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Поля
startDate

object ( Date )

Дата начала этого периода.

startTime

object ( TimeOfDay )

Время начала этого периода.

endDate

object ( Date )

Дата окончания этого периода.

endTime

object ( TimeOfDay )

Время окончания этого периода.

ВремяДня

Обозначает время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. 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.

Локалпостстате

Указывает, в каком состоянии находится сообщение

Перечисления
LOCAL_POST_STATE_UNSPECIFIED Штат не указан.
REJECTED Этот пост был отклонен из-за нарушения политики в отношении контента.
LIVE Этот пост опубликован и в настоящее время появляется в результатах поиска.
PROCESSING Это сообщение находится в обработке и не отображается в результатах поиска.

Локалпосттопиктипе

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

Перечисления
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Тип сообщения не указан.
STANDARD Публикация содержит основную информацию, такую ​​как краткое описание и изображения.
EVENT Пост содержит основную информацию и событие.
OFFER Публикация содержит основную информацию, контент, связанный с событием и предложением (например, код купона).
ALERT Высокоприоритетные и своевременные объявления, связанные с текущим событием. Посты такого типа не всегда доступны для создания.

Тип оповещения

Тип события, для которого было создано оповещение.

Перечисления
ALERT_TYPE_UNSPECIFIED Никакого оповещения не указано.
COVID_19 Оповещения, связанные с пандемией коронавирусного заболевания 2019 года. Сообщения Covid поддерживают только поле сводки и поле призыва к действию. Когда эти оповещения перестанут быть актуальными, создание новых публикаций с оповещениями для типа COVID-19 будет отключено. Однако продавец по-прежнему сможет управлять своими существующими сообщениями о COVID-19.

LocalPostOffer

Специальные поля для публикаций предложений.

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

string

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

redeemOnlineUrl

string

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

termsConditions

string

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

Методы

create

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

delete

 Удаляет локальную публикацию.

get

 Получает указанное локальное сообщение.

list

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

patch

 Обновляет указанное локальное сообщение и возвращает обновленное локальное сообщение.

reportInsights

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