Creare post su Google

L'API Google My Business consente di creare post in Ricerca Google in diverse categorie, come notizie, eventi e offerte.

Questo tutorial illustra come svolgere le seguenti operazioni:

di Gemini Advanced.

Prima di iniziare

Prima di utilizzare l'API Google My Business, devi registrare la tua applicazione e ottenere le credenziali OAuth 2.0.

Per maggiori dettagli su come iniziare a utilizzare l'API Google My Business, consulta l'articolo Nozioni di base configurazione.

Post su eventi

Avvisa i tuoi clienti del prossimo evento che si terrà presso la tua attività con un post. Il tuo Il post di un evento include date e ore di inizio e di fine, che vengono visualizzate ben in evidenza nel post.

Per creare un post per un account associato a un utente, utilizza la API accounts.locations.localPosts.

Per creare un post per un utente autenticato, utilizza quanto segue:

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"
}

Post di invito all'azione

I post con un invito all'azione includono un pulsante. Il testo dell'invito all'azione viene determinato dal campo actionType del post. Un link a un viene aggiunto al pulsante l'URL fornito dall'utente.

Per creare un post con un pulsante di invito all'azione, utilizza quanto segue:

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"
}

Tipi di azione

I post di invito all'azione possono avere diversi tipi di azioni che determinano il tipo di un post di invito all'azione.

Di seguito sono riportati i tipi di invito all'azione supportati:

Tipi di azione
BOOK Crea un post che chiede all'utente di prenotare un appuntamento, un tavolo o qualcosa di simile.
ORDER Crea un post che chiede all'utente di ordinare qualcosa.
SHOP Crea un post che chiede all'utente di sfogliare un prodotto catalogo.
LEARN_MORE Crea un post che chiede all'utente di visualizzare ulteriori dettagli su un sito web.
SIGN_UP Crea un post che chiede all'utente di registrarsi, registrarsi o partecipare qualcosa.
CALL Crea un post che invita l'utente a chiamare un'attività commerciale.

Post sulle offerte

Per creare un post sull'offerta, utilizza quanto segue:

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"
}

Modifica post

Una volta creato un post, puoi modificarlo con una richiesta PATCH.

Per modificare un post, utilizza quanto segue:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

Elimina post

Dopo aver creato un post, puoi eliminarlo con una richiesta DELETE.

Per eliminare un post, utilizza quanto segue:

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