REST Resource: accounts.locations.localPosts

Recurso: LocalPost

Representa una publicación local para 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. Es el identificador de Google de esta publicación local con el formato accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}.
languageCode

string

Es el idioma de la publicación local.
summary

string

Es la descripción o el 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. Es la 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 de la publicación que realizó el usuario.

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. Es obligatorio para los tipos de temas EVENT y OFFER.
state

enum (LocalPostState)

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

object (MediaItem)

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

string

Solo salida. Es 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, por correo electrónico, por mensaje de texto, etcétera.
topicType

enum (LocalPostTopicType)

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

enum (AlertType)

Es el tipo de alerta para el que se creó la publicación. Este campo solo se aplica a las publicaciones de topicType Alert y se comporta como un subtipo de Alertas.
offer

object (LocalPostOffer)

Datos adicionales para las publicaciones de ofertas. Esto solo se debe establecer cuando topicType sea OFFER.

CallToAction

Es 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)

Es el tipo de acción que se realizará.
url

string

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

ActionType

Es el tipo de acción que se realizará.

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

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

LocalPostEvent

Toda la información relacionada con un evento que se incluye 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 inclusive. Para que sea válido, debe contener todos los campos.

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 Indica que no se especificó el estado.
REJECTED Se rechazó esta publicación debido a un incumplimiento de la política de contenido.
LIVE Esta publicación está publicada y aparece en los resultados de la búsqueda.
PROCESSING Esta publicación se está procesando y no aparece en los resultados de la búsqueda.

LocalPostTopicType

Es el tipo de tema de la publicación local, que se usa para seleccionar diferentes plantillas para 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 un resumen y imágenes.
EVENT La publicación contiene información básica y un evento.
OFFER La publicación contiene información básica, un evento y contenido relacionado con la oferta (p.ej., un código de cupón)
ALERT Anuncios oportunos y de alta prioridad relacionados con un evento en curso. Estos tipos de publicaciones no siempre están disponibles para la autoría.

AlertType

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

Enumeraciones
ALERT_TYPE_UNSPECIFIED No se especifica ninguna alerta.
COVID_19 Alertas relacionadas con la pandemia de la enfermedad por 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 del tipo COVID-19. Sin embargo, el comercio podrá administrar 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 puede 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 publicación local asociada con la ubicación especificada y la muestra.

delete

 Borra una publicación local.

get

 Obtiene la publicación local especificada.

list

 Devuelve 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 para un conjunto de publicaciones locales asociadas con una sola ficha.