Beiträge auf Google erstellen

Mit der Google My Business API haben Sie die Möglichkeit, Beiträge in der Google Suche in verschiedenen Kategorien zu erstellen, etwa News, Veranstaltungen oder Angebote.

In dieser Anleitung wird Folgendes beschrieben:

Hinweise

Bevor Sie die Google My Business API verwenden können, müssen Sie Ihre Anwendung registrieren und OAuth 2.0-Anmeldedaten abrufen.

Weitere Informationen zu den ersten Schritten mit der Google My Business API finden Sie unter Grundlegende Einrichtung.

Beiträge zu Veranstaltungen

Mit einem Beitrag können Sie Kunden über die nächste Veranstaltung in Ihrem Unternehmen informieren. Das Start- und Enddatum sowie die Uhrzeiten werden gut sichtbar im Beitrag aufgeführt.

Wenn Sie einen Beitrag für ein Konto erstellen, das einem Nutzer zugewiesen ist, verwenden Sie die accounts.locations.localPosts API.

Verwenden Sie folgenden Code, um einen Beitrag für einen authentifizierten Nutzer zu erstellen:

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

Beiträge mit einem Call-to-Action

Beiträge mit einem Call-to-Action enthalten eine Schaltfläche. Der Text auf der Schaltfläche wird im Feld actionType des Beitrags festgelegt. Auf der Schaltfläche wird ein Link zu einer vom Nutzer angegebenen URL eingefügt.

Verwenden Sie folgenden Code, um einen Beitrag mit einer Call-to-Action-Schaltfläche zu erstellen:

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

Call-to-Action-Typen

Die Art eines Beitrags mit einem Call-to-Action wird von verschiedenen Call-to-Action-Typen bestimmt.

Folgende Call-to-Action-Typen werden unterstützt:

Call-to-Action-Typen
BOOK Hier wird ein Beitrag erstellt, in dem der Nutzer z. B. aufgefordert wird, einen Termin zu buchen oder einen Tisch zu reservieren.
ORDER Hier wird ein Beitrag erstellt, in dem der Nutzer aufgefordert wird, etwas zu bestellen.
SHOP Hier wird ein Beitrag erstellt, in dem der Nutzer aufgefordert wird, sich einen Produktkatalog anzusehen.
LEARN_MORE Hier wird ein Beitrag erstellt, in dem der Nutzer aufgefordert wird, sich weitere Details auf einer Website anzusehen.
SIGN_UP Hier wird ein Beitrag erstellt, in dem der Nutzer aufgefordert wird, sich zu registrieren, sich anzumelden oder an etwas teilzunehmen.
CALL Hier wird ein Beitrag erstellt, in dem der Nutzer aufgefordert wird, ein Unternehmen anzurufen.

Angebote

Verwenden Sie folgenden Code, um einen Beitrag für ein Angebot zu erstellen:

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

Beiträge bearbeiten

Bestehende Beiträge können Sie mit einer PATCH-Anfrage bearbeiten.

Verwenden Sie folgenden Code, um einen Beitrag zu bearbeiten:

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

Beiträge löschen

Bestehende Beiträge können Sie mit einer DELETE-Anfrage löschen.

Verwenden Sie folgenden Code, um einen Beitrag zu löschen:

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