REST Resource: accounts.locations.localPosts

Ressource: LocalPost

Représente un post local pour un établissement.

Représentation 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)
  }
}
Champs
name

string

Uniquement en sortie. Identifiant Google de ce post local au format suivant: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Langue du post local.
summary

string

Description/Corps du post local.
callToAction

object (CallToAction)

URL vers laquelle les utilisateurs sont redirigés lorsqu'ils cliquent sur la promotion. Ignoré pour le type de sujet OFFER.
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création du post.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière modification du post publié par l'utilisateur.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informations sur les événements. Obligatoire pour les types de sujets EVENT et OFFER.
state

enum (LocalPostState)

Uniquement en sortie. État de la publication indiquant la partie de son cycle de vie dans laquelle elle se trouve.
media[]

object (MediaItem)

Contenu multimédia associé au post. sourceUrl est le seul champ de données accepté pour un MediaItem LocalPost.
searchUrl

string

Uniquement en sortie. Lien vers le post local dans la recherche Google. Vous pouvez utiliser ce lien pour partager la publication sur les réseaux sociaux, par e-mail, par SMS, etc.
topicType

enum (LocalPostTopicType)

Obligatoire. Type de sujet du post: standard, événement, offre ou alerte.
alertType

enum (AlertType)

Type d'alerte pour lequel le post est créé. Ce champ ne s'applique qu'aux posts de l'alerte topicType et se comporte comme un sous-type d'alerte.
offer

object (LocalPostOffer)

Données supplémentaires pour les posts d'offres. Ce paramètre ne doit être défini que lorsque le topicType est défini sur OFFER.

CallToAction

Action effectuée lorsque l'utilisateur clique sur le post

Représentation JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Champs
actionType

enum (ActionType)

Type d'action qui sera effectuée.
url

string

URL vers laquelle l'utilisateur est dirigé lorsqu'il clique sur le lien. Ce champ ne doit pas être défini pour l'incitation à l'action "Appeler".

ActionType

Type d'action qui sera effectuée.

Enums
ACTION_TYPE_UNSPECIFIED Type non spécifié
BOOK Ce post souhaite qu'un utilisateur prenne un rendez-vous, une table, etc.
ORDER Ce post propose à l'utilisateur de commander quelque chose.
SHOP Ce post propose à l'utilisateur de parcourir un catalogue de produits.
LEARN_MORE Ce post vise à permettre à l'utilisateur d'en savoir plus (sur son site Web).
SIGN_UP Ce post propose à l'utilisateur de s'inscrire/s'inscrire/rejoindre quelque chose.
GET_OFFER

Obsolète. Utilisez OFFER dans LocalPostTopicType pour créer un post avec le contenu de l'offre.
CALL Ce post propose à l'utilisateur d'appeler l'entreprise.

LocalPostEvent

Toutes les informations concernant un événement présenté dans un post local.

Représentation JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Champs
title

string

Nom de l'événement.
schedule

object (TimeInterval)

Dates et heures de début et de fin de l'événement

TimeInterval

Intervalle de temps inclus. Il doit contenir tous les champs pour être valide.

Représentation JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Champs
startDate

object (Date)

Date de début de cette période.
startTime

object (TimeOfDay)

Heure de début de cette période.
endDate

object (Date)

Date de fin de cette période.
endTime

object (TimeOfDay)

Heure de fin de cette période.

TimeOfDay

Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date et google.protobuf.Timestamp.

Représentation JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Champs
hours

integer

Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.
minutes

integer

Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.
seconds

integer

Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
nanos

integer

Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999.

LocalPostState

Indique l'état du post.

Enums
LOCAL_POST_STATE_UNSPECIFIED État non spécifié.
REJECTED Ce post a été refusé, car il ne respecte pas le règlement relatif au contenu.
LIVE Ce post est publié et apparaît actuellement dans les résultats de recherche.
PROCESSING Ce post est en cours de traitement et n'apparaît pas dans les résultats de recherche.

LocalPostTopicType

Type de sujet du post local, qui permet de sélectionner différents modèles pour créer et afficher un post.

Enums
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Aucun type de post n'est spécifié.
STANDARD Le post contient des informations de base, comme un résumé et des images.
EVENT Le post contient des informations de base et un événement.
OFFER Le post contient des informations de base, un événement et du contenu lié à une offre (code promotionnel, par exemple).
ALERT Annonces urgentes et prioritaires concernant un événement en cours. Il n'est pas toujours possible de créer des posts de ce type.

AlertType

Type d'événement pour lequel le post d'alerte a été créé.

Enums
ALERT_TYPE_UNSPECIFIED Aucune alerte n'est spécifiée.
COVID_19 Alertes liées à la pandémie de coronavirus 2019. Les posts concernant la COVID-19 ne peuvent comporter qu'un champ de résumé et un champ d'incitation à l'action. Lorsque ces alertes ne seront plus pertinentes, la création de posts d'alerte pour le type COVID-19 sera désactivée. Toutefois, le marchand pourra toujours gérer ses posts concernant la COVID-19.

LocalPostOffer

Champs spécifiques pour les posts d'offres.

Représentation JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Champs
couponCode

string

Facultatif. Code promotionnel utilisable en magasin ou en ligne.
redeemOnlineUrl

string

Facultatif. Lien en ligne permettant d'utiliser l'offre.
termsConditions

string

Facultatif. Conditions d'utilisation de l'offre

Méthodes

create

 Crée un post local associé à l'établissement spécifié, puis l'affiche.

delete

 Supprime un post local.

get

 Récupère le post local spécifié.

list

 Affiche une liste de posts locaux associés à un établissement.

patch

 Met à jour le post local spécifié et affiche le post local mis à jour.

reportInsights

 Affiche les insights d'un ensemble de posts locaux associés à une seule fiche.