REST Resource: accounts.locations.localPosts

Recurso: LocalPost

Representa una 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. Es el identificador de Google de 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)

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 la creación de la publicación.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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 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)

El 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 a través de redes sociales, correo electrónico, mensaje de texto, etcétera.

topicType

enum (LocalPostTopicType)

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

alertType

enum (AlertType)

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

offer

object (LocalPostOffer)

Datos adicionales de las publicaciones de ofertas 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. No debes configurar este campo para el CTA de la llamada.

ActionType

El tipo de acción que se realizará.

Enumeradores
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 pida algo.
SHOP En esta publicación, se pretende que un usuario explore un catálogo de productos.
LEARN_MORE Esta publicación quiere 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

Ya no está disponible. Usa OFFER en LocalPostTopicType para crear una publicación con contenido de la oferta.

CALL Esta publicación quiere que un usuario llame a la empresa.

LocalPostEvent

Toda la información relativa a un evento que se muestra 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. Debe contener todos los campos para que sea 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.

Enumeradores
LOCAL_POST_STATE_UNSPECIFIED No se ha especificado el estado.
REJECTED Esta publicación se rechazó debido a un incumplimiento de la política de contenido.
LIVE Esta publicación se publicó 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 para crear y renderizar una publicación.

Enumeradores
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 contiene información básica, un evento y contenido relacionado con la oferta (p. ej., el 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 su autoría.

AlertType

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

Enumeradores
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 dejen de ser relevantes, se inhabilitará la creación de nuevas publicaciones de alerta para el tipo COVID-19. Sin embargo, el comercio podrá seguir administrando sus publicaciones sobre el COVID-19 existentes.

LocalPostOffer

Campos específicos para las publicaciones de oferta

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

string

Opcional. Es un 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

Elimina 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 devuelve la publicación local actualizada.

reportInsights

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