REST Resource: accounts.locations.localPosts

Recurso: LocalPost

Representa la publicación local de una ubicación.

Representación 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

Solo salida. Identificador de Google para esta publicación local con el formato accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

El idioma de la publicación local.
summary

string

Descripción o cuerpo de la publicación local.
callToAction

object (CallToAction)

Es la URL a la que se envía a los usuarios cuando hacen clic en la promoción. Se ignora para el tipo de tema OFFER.
createTime

string (Timestamp format)

Solo salida. Hora de creación de la publicación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo salida. Hora de la última modificación que hizo el usuario de la publicación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Información del evento. Obligatorio para los tipos de tema EVENT y OFFER.
state

enum (LocalPostState)

Solo salida. El estado de la publicación, que indica en qué parte de su ciclo de vida se encuentra.
media[]

object (MediaItem)

Contenido multimedia asociado con la publicación. sourceUrl es el único campo de datos admitido para un MediaItem de LocalPost.
searchUrl

string

Solo salida. El vínculo a la publicación local en la Búsqueda de Google. Este vínculo se puede usar para compartir la publicación en redes sociales, correo electrónico, mensaje de texto, etcétera.
topicType

enum (LocalPostTopicType)

Obligatorio. El tipo de tema de la publicación: estándar, evento, oferta o alerta.
alertType

enum (AlertType)

El tipo de alerta para el que se crea la publicación. Este campo solo se aplica a las publicaciones de la alerta de topicType y se comporta como un subtipo de alertas.
offer

object (LocalPostOffer)

Datos adicionales para las publicaciones de ofertas. Esto solo debe configurarse cuando el topicType es OFFER.

CallToAction

Una acción que se realiza cuando el usuario hace clic en la publicación

Representación JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Campos
actionType

enum (ActionType)

El tipo de acción que se realizará.
url

string

La URL a la que se dirigirá al usuario cuando haga clic. Este campo no se debe configurar para el CTA de la llamada.

ActionType

El tipo de acción que se realizará.

Enumeraciones
ACTION_TYPE_UNSPECIFIED Indica un tipo no especificado.
BOOK Esta publicación quiere que un usuario reserve una cita, una mesa, etcétera.
ORDER Esta publicación quiere que un usuario haga un pedido.
SHOP En esta publicación, se quiere que un usuario explore un catálogo de productos.
LEARN_MORE El objetivo de esta publicación es que el usuario obtenga más información (en su sitio web).
SIGN_UP Esta publicación quiere que un usuario se registre, se registre o se una a algo.
GET_OFFER

Obsoleta. Usa OFFER en LocalPostTopicType para crear una publicación con contenido de ofertas.
CALL Esta publicación quiere que un usuario llame a la empresa.

LocalPostEvent

Toda la información relacionada con un evento destacado en una publicación local.

Representación JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Campos
title

string

Nombre del evento.
schedule

object (TimeInterval)

Fecha y hora de inicio y finalización del evento

TimeInterval

Un intervalo de tiempo inclusivo. Debe contener todos los campos para ser válido.

Representación JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Campos
startDate

object (Date)

Es la fecha de inicio de este período.
startTime

object (TimeOfDay)

Es la hora de inicio de este período.
endDate

object (Date)

Es la fecha de finalización de este período.
endTime

object (TimeOfDay)

Es la hora de finalización de este período.

TimeOfDay

Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos bisiestos. Los tipos relacionados son google.type.Date y google.protobuf.Timestamp.

Representación JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas del día en formato de 24 horas. Debe ser del 0 al 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de horas del día. Debe ser un valor entre 0 y 59.
seconds

integer

Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999.

LocalPostState

Indica en qué estado se encuentra la publicación.

Enumeraciones
LOCAL_POST_STATE_UNSPECIFIED No se especificó el estado.
REJECTED Se rechazó esta publicación debido a un incumplimiento de la política de contenido.
LIVE Se publicó esta publicación y, actualmente, aparece en los resultados de las búsquedas.
PROCESSING Esta publicación se está procesando y no aparece en los resultados de la búsqueda.

LocalPostTopicType

El tipo de tema de la publicación local, que se usa para seleccionar diferentes plantillas a fin de crear y renderizar una publicación.

Enumeraciones
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED No se especificó ningún tipo de publicación.
STANDARD La publicación contiene información básica, como imágenes y resumen.
EVENT La publicación contiene información básica y un evento.
OFFER La publicación incluye información básica y contenido relacionado con un evento y una oferta (p.ej., un código de cupón)
ALERT Anuncios oportunos y de prioridad alta relacionados con un evento en curso. Estos tipos de publicaciones no siempre están disponibles para su creación.

AlertType

El tipo de evento para el que se creó la publicación de la alerta.

Enumeraciones
ALERT_TYPE_UNSPECIFIED No se especificó ninguna alerta.
COVID_19 Alertas relacionadas con la pandemia de la enfermedad del coronavirus de 2019. Las publicaciones sobre el COVID-19 solo admiten un campo de resumen y un campo de llamado a la acción. Cuando estas alertas ya no sean relevantes, se inhabilitará la creación de nuevas publicaciones de alertas para el tipo COVID-19. Sin embargo, el comercio podrá seguir administrando sus publicaciones existentes sobre el COVID-19.

LocalPostOffer

Campos específicos para las publicaciones de ofertas.

Representación JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Campos
couponCode

string

Opcional. Código de oferta que se pueda usar en la tienda o en línea
redeemOnlineUrl

string

Opcional. Vínculo en línea para canjear la oferta.
termsConditions

string

Opcional. Términos y condiciones de la oferta.

Métodos

create

 Crea una nueva entrada local asociada con la ubicación especificada y la muestra.

delete

 Borra una publicación local.

get

 Obtiene la publicación local especificada.

list

 Muestra una lista de publicaciones locales asociadas con una ubicación.

patch

 Actualiza la publicación local especificada y muestra la publicación local actualizada.

reportInsights

 Muestra estadísticas de un conjunto de publicaciones locales asociadas con una sola ficha.