- Ressource: LocalPost
- CallToAction
- ActionType
- LocalPostEvent
- TimeInterval
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- AlertType
- LocalPostOffer
- Méthodes
Ressource: LocalPost
Représente un post local pour un établissement.
Représentation JSON | |
---|---|
{ "name": string, "languageCode": string, "summary": string, "callToAction": { object ( |
Champs | |
---|---|
name |
Uniquement en sortie. Identifiant Google de ce post local, au format |
languageCode |
Langue du post local. |
summary |
Description/Corps du post local. |
callToAction |
URL vers laquelle les utilisateurs sont redirigés lorsqu'ils cliquent sur la promotion. Ignoré pour le type de sujet |
createTime |
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: |
updateTime |
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: |
event |
Informations sur l'événement. Obligatoire pour les types de thèmes |
state |
Uniquement en sortie. État du post, indiquant dans quelle partie de son cycle de vie il se trouve. |
media[] |
Média associé au post. sourceUrl est le seul champ de données accepté pour un LocalPost MediaItem. |
searchUrl |
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 |
Obligatoire. Type de sujet du post: standard, événement, offre ou alerte. |
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 |
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 ( |
Champs | |
---|---|
actionType |
Type d'action qui sera effectuée. |
url |
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 |
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 ( |
Champs | |
---|---|
title |
Nom de l'événement |
schedule |
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 ( |
Champs | |
---|---|
startDate |
Date de début de cette période. |
startTime |
Heure de début de cette période. |
endDate |
Date de fin de cette période. |
endTime |
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 |
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 |
Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59. |
seconds |
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 |
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 |
Facultatif. Code promotionnel utilisable en magasin ou en ligne. |
redeemOnlineUrl |
Facultatif. Lien en ligne pour profiter de l'offre. |
termsConditions |
Facultatif. Conditions d'utilisation de l'offre. |
Méthodes |
|
---|---|
|
Crée un post local associé à l'établissement spécifié, puis l'affiche. |
|
Supprime un post local. |
|
Récupère le post local spécifié. |
|
Affiche une liste de posts locaux associés à un établissement. |
|
Met à jour le post local spécifié et l'affiche. |
|
Affiche des insights pour un ensemble de posts locaux associés à une seule fiche. |