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, sous la forme accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Langue de l'annonce locale.
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. Date/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 l'événement. Obligatoire pour les types de sujets EVENT et OFFER.
state

enum (LocalPostState)

Uniquement en sortie. État de la publication, indiquant à quelle phase de son cycle de vie elle se trouve.
media[]

object (MediaItem)

Le 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. Ce lien peut être utilisé pour partager le post 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 type topicType Alert et se comporte comme un sous-type d'alertes.
offer

object (LocalPostOffer)

Données supplémentaires pour les posts d'offres. Ce champ ne doit être défini que si le type de sujet est "OFFRE".

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 post. 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 propose à l'utilisateur d'en savoir plus (sur le site Web).
SIGN_UP Ce post propose à l'utilisateur de s'inscrire ou de participer.
GET_OFFER

Obsolète. Utilisez OFFER dans LocalPostTopicType pour créer un post avec du contenu d'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 inclusif. Pour qu'il soit valide, il doit contenir tous les champs.

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 de la publication

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 comporte des informations de base, telles qu'un résumé et des images.
EVENT Le post comporte des informations de base et un événement.
OFFER Le post comporte des informations de base, un événement et du contenu lié à une offre (par exemple, un code promotionnel).
ALERT Annonces ponctuelles hautement prioritaires concernant un événement en cours. Il n'est pas toujours possible de créer ces types de posts.

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 2019. Les posts sur le COVID-19 n'acceptent que les champs "Résumé" et "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, les marchands pourront toujours gérer leurs posts existants sur 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 bénéficier de l'offre.
termsConditions

string

Facultatif. Conditions d'utilisation de l'offre.

Méthodes

create

 Crée un post local associé à l'emplacement spécifié, puis le renvoie.

delete

 Supprime un post local.

get

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

list

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

patch

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

reportInsights

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