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 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.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Uniquement en sortie. Date et heure de la dernière modification du post par l'utilisateur.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Informations sur l'événement. Obligatoire pour les types de thèmes EVENT et OFFER.
state

enum (LocalPostState)

Uniquement en sortie. État du post, indiquant dans quelle partie de son cycle de vie il se trouve.
media[]

object (MediaItem)

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

string

Uniquement en sortie. Lien vers le post local dans la recherche Google. Ce lien peut être utilisé pour partager le post sur les réseaux sociaux, par e-mail, par message, 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 d'alerte topicType et se comporte comme un sous-type d'alerte.
offer

object (LocalPostOffer)

Données supplémentaires pour les posts pour une offre. Doit être défini uniquement lorsque le topicType est 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'internaute est redirigé lorsqu'il clique sur l'annonce. 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 propose à l'utilisateur de réserver 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 souhaite que l'utilisateur en savoir plus (sur son site Web).
SIGN_UP Ce post propose à un utilisateur de s'inscrire/s'inscrire/rejoindre quelque chose.
GET_OFFER

Obsolète. Utilisez OFFER dans LocalPostTopicType pour créer un post contenant une offre.
CALL Ce post propose à l'utilisateur d'appeler l'établissement.

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 inclusif. 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é pour non-respect du 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 (par exemple, un code promotionnel)
ALERT Annonces opportunes et hautement prioritaires concernant un événement en cours. Il n'est pas toujours possible de créer ce type de post.

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 maladie à coronavirus de 2019. Les posts concernant la COVID-19 ne peuvent contenir qu'un champ récapitulatif et un champ d'incitation à l'action. Lorsque ces alertes ne seront plus pertinentes, la création de posts d'alerte de type COVID-19 sera désactivée. Toutefois, le marchand pourra toujours gérer ses posts liés à la COVID-19.

LocalPostOffer

Champs spécifiques pour les posts "Offre".

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 pour profiter de 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 l'affiche.

reportInsights

 Affiche des insights pour un ensemble de posts locaux associés à une seule fiche.