Créer des posts sur Google

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 :

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 :

HTTP
$ 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 :

HTTP
$ 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 :

HTTP
$ 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 :

HTTP
$ 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 :

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}