REST Resource: accounts.locations.localPosts

Recurso: LocalPost

Representa uma postagem local de um local.

Representação 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)
  }
}
Campos
name

string

Apenas saída. Identificador do Google para esta postagem local no formato: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

O idioma da postagem local.
summary

string

Descrição/corpo da postagem local.
callToAction

object (CallToAction)

O URL para o qual os usuários são direcionados ao clicar na promoção. Ignorado para o tipo de tema OFFER.
createTime

string (Timestamp format)

Apenas saída. Hora da criação da postagem.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. Hora da última modificação da postagem feita pelo usuário.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informações sobre o evento. Obrigatório para os tipos de tópico EVENT e OFFER.
state

enum (LocalPostState)

Apenas saída. O estado da postagem, indicando em qual parte do ciclo de vida ela está.
media[]

object (MediaItem)

A mídia associada à postagem. sourceUrl é o único campo de dados com suporte para um MediaItem de LocalPost.
searchUrl

string

Apenas saída. O link para a postagem local na Pesquisa Google. Esse link pode ser usado para compartilhar a postagem nas mídias sociais, por e-mail, mensagem de texto etc.
topicType

enum (LocalPostTopicType)

Obrigatório. O tipo de tópico da postagem: padrão, evento, oferta ou alerta.
alertType

enum (AlertType)

O tipo de alerta para o qual a postagem foi criada. Este campo só é aplicável a postagens do tipo "Alerta" e funciona como um subtipo de alertas.
offer

object (LocalPostOffer)

Dados adicionais para postagens de oferta. Isso só deve ser definido quando o topicType for OFFER.

CallToAction

Uma ação realizada quando o usuário clica na postagem.

Representação JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Campos
actionType

enum (ActionType)

O tipo de ação que será realizada.
url

string

O URL para onde o usuário será direcionado após um clique. Este campo precisa ser deixado sem definição para a CTA de chamada.

ActionType

O tipo de ação que será realizada.

Enums
ACTION_TYPE_UNSPECIFIED Tipo não especificado.
BOOK Esta postagem pede que um usuário reserve um horário/mesa/etc.
ORDER Esta postagem pede que um usuário peça algo.
SHOP Esta postagem pede que um usuário navegue em um catálogo de produtos.
LEARN_MORE Esta postagem pede que um usuário saiba mais (no próprio site).
SIGN_UP Esta postagem pede que o usuário se registre, se inscreva ou participe.
GET_OFFER

Obsoleto. Use OFFER em LocalPostTopicType para criar uma postagem com conteúdo de oferta.
CALL Esta postagem pede que um usuário ligue para a empresa.

LocalPostEvent

Todas as informações relativas a um evento exibidas em uma postagem local.

Representação JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Campos
title

string

Nome do evento.
schedule

object (TimeInterval)

Data/hora de início e término do evento.

TimeInterval

Um intervalo de tempo inclusivo. Ele precisa conter todos os campos para ser válido.

Representação JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Campos
startDate

object (Date)

A data de início deste período.
startTime

object (TimeOfDay)

O horário de início deste período.
endDate

object (Date)

A data de término deste período.
endTime

object (TimeOfDay)

O horário de término deste período.

TimeOfDay

Representa um horário do dia. A data e o fuso horário não são relevantes ou são especificados em outro lugar. Uma API pode permitir segundos bissextos. Os tipos relacionados são google.type.Date e google.protobuf.Timestamp.

Representação JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas do dia no formato de 24 horas. Precisa ser de 0 a 23. Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.
minutes

integer

Minutos da hora do dia. Precisa ser de 0 a 59.
seconds

integer

Segundos do minutos do horário. Normalmente precisa ser de 0 a 59. Uma API pode permitir o valor 60 se permitir segundos bissextos.
nanos

integer

Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999.

LocalPostState

Indica em que estado a postagem está

Enums
LOCAL_POST_STATE_UNSPECIFIED Estado não especificado.
REJECTED Esta postagem foi rejeitada devido a uma violação da política de conteúdo.
LIVE Esta postagem foi publicada e está aparecendo nos resultados da pesquisa.
PROCESSING Esta postagem está sendo processada e não aparece nos resultados da pesquisa.

LocalPostTopicType

O tipo de tópico da postagem local, que é usado para selecionar modelos diferentes e criar e renderizar uma postagem.

Enums
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Nenhum tipo de postagem foi especificado.
STANDARD A postagem contém informações básicas, como resumo e imagens.
EVENT A postagem contém informações básicas e um evento.
OFFER A postagem contém informações básicas, um evento e conteúdo relacionado à oferta (por exemplo, código de cupom)
ALERT Anúncios de alta prioridade e oportunos relacionados a um evento em andamento. Esses tipos de postagens nem sempre estão disponíveis para criação.

AlertType

É o tipo de evento para o qual a postagem de alerta foi criada.

Enums
ALERT_TYPE_UNSPECIFIED Nenhum alerta é especificado.
COVID_19 Alertas relacionados à pandemia do coronavírus de 2019. As postagens sobre a Covid-19 só aceitam um campo de resumo e um campo de call-to-action. Quando esses alertas não forem mais relevantes, a criação de novas postagens de alerta sobre a COVID-19 será desativada. No entanto, o comerciante ainda poderá gerenciar as postagens atuais sobre a COVID-19.

LocalPostOffer

Campos específicos para postagens de oferta.

Representação JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Campos
couponCode

string

Opcional. Código de oferta utilizável em loja ou on-line.
redeemOnlineUrl

string

Opcional. Link on-line para resgatar a oferta.
termsConditions

string

Opcional. Termos e Condições da oferta.

Métodos

create

 Cria e retorna uma nova postagem local associada ao local especificado.

delete

 Exclui uma postagem local.

get

 Recebe a postagem local especificada.

list

 Retorna uma lista de postagens locais associadas a um local.

patch

 Atualiza a postagem local especificada e a retorna.

reportInsights

 Retorna insights de um conjunto de postagens locais associadas a uma única ficha.