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 onde os usuários são direcionados ao clicar na promoção. Ignorado para o tipo de tópico 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. A 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 do 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 se encontra.

media[]

object (MediaItem)

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

searchUrl

string

Apenas saída. O link para a postagem local na Pesquisa Google. Use esse link para compartilhar a postagem nas mídias sociais, e-mail, mensagem de texto etc.

topicType

enum (LocalPostTopicType)

Obrigatório. O tipo de tema 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 de alertas topicType e se comporta como um subtipo de alertas.

offer

object (LocalPostOffer)

Dados adicionais para postagens de oferta. Só é preciso definir quando o topicType é OFFER.

CallToAction

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 o qual o usuário será direcionado após um clique. Este campo deve 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 faça um pedido.
SHOP Esta postagem pede que um usuário navegue por um catálogo de produtos.
LEARN_MORE Esta postagem pede que um usuário saiba mais (no site dele).
SIGN_UP Esta postagem pede que um usuário se registre/se inscreva/participe de algo.
GET_OFFER

Obsoleto. Use OFFER no 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 o estado da postagem

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 diferentes modelos 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 um conteúdo relacionado à oferta (por exemplo, código do 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 campos de resumo e de call-to-action. Quando esses alertas não forem mais relevantes, a criação de novas postagens de alerta para o tipo COVID-19 será desativada. No entanto, o comerciante ainda poderá gerenciar as postagens 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 que pode ser usado na 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 uma nova postagem local associada ao lugar especificado e a retorna.

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 retorna a postagem local atualizada.

reportInsights

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