Vous pouvez utiliser l'API Google My Business pour créer des posts dans la recherche Google au sein de différentes catégories (actualités, événements et offres, par exemple).
Ce tutoriel vous explique comment effectuer les tâches suivantes :
- Créer des posts pour des événements
- Créer des posts d'incitation à l'action
- Créer des posts pour des offres
- Modifier des posts
- Supprimer des posts
Avant de commencer
Avant d'utiliser l'API Google My Business, vous devez enregistrer votre application et obtenir des identifiants OAuth 2.0.
Pour savoir comment vous lancer avec l'API Google My Business, consultez Configuration de base.
Posts pour des événements
À l'aide d'un post, informez vos clients d'un événement à venir organisé par votre établissement. Le post affichera en évidence les dates et heures de début et de fin.
Pour créer un post dans un compte associé à un utilisateur, utilisez l'API accounts.locations.localPosts
.
Pour créer un post pour un utilisateur authentifié, utilisez le code suivant :
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId} /locations/{locationId} /localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
Posts d'incitation à l'action
Les posts contenant une incitation à l'action incluent un bouton. Le texte affiché sur le bouton d'incitation à l'action est déterminé par le champ actionType
du post. Un lien vers une URL fournie par l'utilisateur est ajouté au bouton.
Pour créer un post avec un bouton d'incitation à l'action, utilisez le code suivant :
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId} /locations/{locationId} /localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
Types d'actions
Les posts comprenant une incitation à l'action diffèrent en fonction du type d'action.
Les types d'incitation à l'action suivants sont acceptés :
Types d'actions | |
---|---|
BOOK |
Crée un post qui invite l'utilisateur à prendre rendez-vous, ou à réserver une table ou autre chose. |
ORDER |
Crée un post qui invite l'utilisateur à commander quelque chose. |
SHOP |
Crée un post qui invite l'utilisateur à parcourir un catalogue de produits. |
LEARN_MORE |
Crée un post qui invite l'utilisateur à consulter des informations supplémentaires sur un site Web. |
SIGN_UP |
Crée un post qui invite l'utilisateur à s'abonner, à s'inscrire ou à participer à quelque chose. |
CALL |
Crée un post qui invite l'utilisateur à appeler une entreprise. |
Posts pour des offres
Pour créer un post pour une offre, utilisez le code suivant :
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId} /locations/{locationId} /localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
Modifier des posts
Après avoir créé un post, vous pouvez le modifier à l'aide d'une requête PATCH
.
Pour modifier un post, utilisez le code suivant :
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId} /locations/{locationId} /localPosts/{localPostId} ?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
Supprimer des posts
Après avoir créé un post, vous pouvez le supprimer à l'aide d'une requête DELETE
.
Pour supprimer un post, utilisez le code suivant :
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId} /locations/{locationId} /localPosts/{localPostId}