- Recurso: LocalPost
- CallToAction
- ActionType
- LocalPostEvent
- TimeInterval
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- AlertType
- LocalPostOffer
- Métodos
Recurso: LocalPost
Representa uma postagem local para um local.
Representação JSON | |
---|---|
{ "name": string, "languageCode": string, "summary": string, "callToAction": { object ( |
Campos | |
---|---|
name |
Apenas saída. O identificador do Google para esta postagem local está no formato: |
languageCode |
O idioma da postagem local. |
summary |
Descrição/corpo da postagem local. |
callToAction |
O URL para onde os usuários são direcionados ao clicar na promoção. Ignorado para o tipo de tópico |
createTime |
Apenas saída. Hora da criação da postagem. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
updateTime |
Apenas saída. Hora da última modificação da postagem feita pelo usuário. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
event |
Informações do evento. Obrigatório para os tipos de tópico |
state |
Apenas saída. O estado da postagem, indicando em que parte do ciclo de vida ela se encontra. |
media[] |
A mídia associada à postagem. sourceUrl é o único campo de dados compatível com um LocalPost MediaItem. |
searchUrl |
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, e-mail, mensagem de texto etc. |
topicType |
Obrigatório. O tipo de tema da postagem: padrão, evento, oferta ou alerta. |
alertType |
O tipo de alerta para o qual a postagem foi criada. Este campo só é aplicável a postagens de alerta topicType e se comporta como um subtipo de alertas. |
offer |
Dados adicionais para postagens de oferta. Só deve ser definido quando o topicType é OFFER. |
CallToAction
Ação realizada quando o usuário clica na postagem
Representação JSON | |
---|---|
{
"actionType": enum ( |
Campos | |
---|---|
actionType |
O tipo de ação que será realizada. |
url |
URL para o qual o usuário será direcionado após clicar. Esse 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 peça algo. |
SHOP |
Esta postagem pede que um usuário navegue em um catálogo de produtos. |
LEARN_MORE |
Esta postagem quer que um usuário saiba mais (no site dele). |
SIGN_UP |
Esta postagem pede que um usuário se registre, se inscreva ou participe. |
GET_OFFER |
Obsoleto. Use |
CALL |
Esta postagem pede que um usuário ligue para a empresa. |
LocalPostEvent
Todas as informações relacionadas a um evento são apresentadas em uma postagem local.
Representação JSON | |
---|---|
{
"title": string,
"schedule": {
object ( |
Campos | |
---|---|
title |
Nome do evento. |
schedule |
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 ( |
Campos | |
---|---|
startDate |
A data de início deste período. |
startTime |
É o horário de início deste período. |
endDate |
A data de término deste período. |
endTime |
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 |
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 |
Minutos da hora do dia. Precisa ser de 0 a 59. |
seconds |
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 |
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 aparece nos resultados da pesquisa. |
PROCESSING |
Esta postagem está sendo processada e não aparece nos resultados da pesquisa. |
LocalPostTopicType
O tipo de tema 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 um conteúdo relacionado a ofertas (por exemplo, código do cupom) |
ALERT |
Anúncios de alta prioridade e oportunos relacionados a um evento em andamento. Esses tipos de postagem 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ão compatíveis apenas com campos de resumo e 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 existentes sobre a COVID-19. |
LocalPostOffer
Campos específicos para postagens de oferta.
Representação JSON | |
---|---|
{ "couponCode": string, "redeemOnlineUrl": string, "termsConditions": string } |
Campos | |
---|---|
couponCode |
Opcional. Código da oferta que pode ser usado na loja ou on-line. |
redeemOnlineUrl |
Opcional. Link on-line para resgatar a oferta. |
termsConditions |
Opcional. Termos e Condições da oferta. |
Métodos |
|
---|---|
|
Cria uma nova postagem local associada ao local especificado e a retorna. |
|
Exclui uma postagem local. |
|
Recebe a postagem local especificada. |
|
Retorna uma lista de postagens locais associadas a um local. |
|
Atualiza a postagem local especificada e retorna a postagem atualizada. |
|
Retorna insights para um conjunto de postagens locais associadas a uma única página de detalhes. |