Für die Google Business Performance API gibt es eine NEUE API-Methode, mit der sich mehrere „DailyMetrics“-Objekte in einer einzelnen Anfrage abrufen lassen. Sehen Sie sich den Zeitplan für die Einstellung und die Anleitung für die Migration von der reportInsights API-Methode Version 4 zur Google Business Profile Performance API an.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
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:
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:
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":“Offeronlyvalidifyoucanproveyouareatimetraveler”
},
"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:
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[[["\u003cp\u003eThe Google My Business API allows you to create and manage posts for your business directly on Google Search and Maps, including Event, Call to Action, and Offer posts, to engage with your customers.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, you must register your application and obtain OAuth 2.0 credentials, following the setup instructions provided in the documentation.\u003c/p\u003e\n"],["\u003cp\u003eYou can create posts with various features, like event schedules, call-to-action buttons with customizable actions (book, order, shop, etc.), and offer details like coupon codes and terms.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating posts, the API enables you to edit their content or delete them entirely using dedicated HTTP methods and specifying the desired changes or target post ID.\u003c/p\u003e\n"],["\u003cp\u003eProduct posts cannot be created using the Google My Business API at this time.\u003c/p\u003e\n"]]],[],null,["# Create Posts on Google\n\n\u003cbr /\u003e\n\nThe Google My Business API provides you with the ability to create Posts in\nGoogle Search within several categories, such as news, events, and offers.\n\nThis tutorial shows you how to do the following:\n\n- Create [Event Posts](#event_posts).\n- Create [Call to action Posts](#call_to_action_posts).\n- Create [Offer Posts](#offer_posts).\n- [Edit Posts](#edit_posts).\n- [Delete Posts](#delete_posts).\n\n| **Note:** Product Posts cannot be created via the Google My Business API at this time.\n\nBefore you begin\n----------------\n\nBefore you use the Google My Business API, you need to register your application\nand obtain OAuth 2.0 credentials.\n\nFor details on how to get started with the Google My Business API, see [Basic\nsetup](/my-business/content/basic-setup).\n| **Note:** Small businesses and large chains are eligible to create Posts.\n\nEvent Posts\n-----------\n\nNotify your customers about the next event at your business with a Post. Your\nPost for an event includes start and end dates and times, which display\nprominently on the Post.\n\nTo make a Post to an account associated with a user, use the\n[`accounts.locations.localPosts`](/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost) API.\n\nTo create a Post for an authenticated user, use the following:\nHTTP \n\n```bash\n$ POST\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts\n{\n \"languageCode\": \"en-US\",\n \"summary\": \"Come in for our spooky Halloween event!\",\n \"event\": {\n \"title\": \"Halloween Spook-tacular!\",\n \"schedule\": {\n \"startDate\": {\n \"year\": 2017,\n \"month\": 10,\n \"day\": 31,\n },\n \"startTime\": {\n \"hours\": 9,\n \"minutes\": 0,\n \"seconds\": 0,\n \"nanos\": 0,\n },\n \"endDate\": {\n \"year\": 2017,\n \"month\": 10,\n \"day\": 31,\n },\n \"endTime\": {\n \"hours\": 17,\n \"minutes\": 0,\n \"seconds\": 0,\n \"nanos\": 0,\n },\n }\n },\n \"media\": [\n {\n \"mediaFormat\": \"PHOTO\",\n \"sourceUrl\": \"https://www.google.com/real-image.jpg\",\n }\n ],\n \"topicType\": \"EVENT\"\n}\n```\n\nCall to action Posts\n--------------------\n\nPosts with a call to action include a button. The text on the call to action\nbutton is determined by the `actionType` field of the Post. A link to a\nuser-provided URL is added to the button.\n\nTo create a Post with a call to action button, use the following:\nHTTP \n\n```bash\n$ POST\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts\n{\n \"languageCode\": \"en-US\",\n \"summary\": \"Order your Thanksgiving turkeys now!!\",\n \"callToAction\": {\n \"actionType\": \"ORDER\",\n \"url\": \"http://google.com/order_turkeys_here\",\n },\n \"media\": [\n {\n \"mediaFormat\": \"PHOTO\",\n \"sourceUrl\": \"https://www.google.com/real-turkey-photo.jpg\",\n }\n ],\n \"topicType\": \"OFFER\"\n}\n```\n\n### Action types\n\nThe call to action Posts can have different action types that determine the type\nof call to action Post.\n\nThe following are the supported call to action types:\n\n| Action types ||\n|--------------|-----------------------------------------------------------------------------------------|\n| `BOOK` | Creates a Post that prompts a user to book an appointment, table, or something similar. |\n| `ORDER` | Creates a Post that prompts a user to order something. |\n| `SHOP` | Creates a Post that prompts a user to browse a product catalog. |\n| `LEARN_MORE` | Creates a Post that prompts a user to see additional details on a website. |\n| `SIGN_UP` | Creates a Post that prompts a user to register, sign up, or join something. |\n| `CALL` | Creates a Post that prompts a user to call a business. |\n\nOffer Posts\n-----------\n\nTo create an Offer Post, use the following:\nHTTP \n\n```bash\n$ POST\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts\n{\n \"languageCode\": \"en-US\",\n \"summary\": \"Buy one Google jetpack, get a second one free!!\",\n \"offer\": {\n \"couponCode\": “BOGO-JET-CODE”,\n \"redeemOnlineUrl\": “https://www.google.com/redeem”,\n \"termsConditions\": “Offer only valid if you can prove you are a time traveler”\n },\n \"media\": [\n {\n \"mediaFormat\": \"PHOTO\",\n \"sourceUrl\": \"https://www.google.com/real-jetpack-photo.jpg\",\n }\n ],\n \"topicType\": \"OFFER\"\n}\n```\n\nEdit Posts\n----------\n\nOnce a post is created, you can edit it with a `PATCH` request.\n\nTo edit a Post, use the following:\nHTTP \n\n```bash\n$ PATCH\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary\n{\n \"summary\": \"Order your Christmas turkeys now!!\"\n}\n```\n\nDelete Posts\n------------\n\nAfter a Post is created, you can delete it with a `DELETE` request.\n\nTo delete a Post, use the following:\nHTTP \n\n```bash\n$ DELETE\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}\n```"]]