A API Google Business Performance tem um NOVO método de API que permite buscar várias "DailyMetrics" em uma única solicitação de API. Confira a programação de descontinuação e instruções para migrar do método de API reportInsights v4 para a API Google Business Profile Performance.
Esse tipo de postagem precisa incluir um botão. O texto dele é determinado no campo actionType da postagem. Um link para um URL fornecido pelo usuário é adicionado ao botão.
Para criar uma postagem com um botão de call-to-action, use:
As postagens com call-to-action podem ter diferentes tipos de ação que determinam o tipo de conteúdo.
Estes são os compatíveis:
Tipos de ação
BOOK
Uma postagem que incentiva o usuário a agendar um compromisso, reservar uma mesa ou algo do tipo
ORDER
Uma postagem que incentiva o usuário a fazer algo
SHOP
Uma postagem que incentiva o usuário a ver um catálogo de produtos
LEARN_MORE
Uma postagem que incentiva o usuário a ver detalhes adicionais em um site
SIGN_UP
Uma postagem que incentiva o usuário a se registrar, fazer uma inscrição ou participar de algo
CALL
Uma postagem que incentiva o usuário a ligar para uma empresa
Postagens de ofertas
Para criar uma postagem desse tipo, use:
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"}
Editar postagens
Depois que uma postagem é criada, você pode editá-la com uma solicitação PATCH.
Para fazer isso, use:
HTTP
$PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{"summary":"Order your Christmas turkeys now!!"}
Excluir postagens
Depois que uma postagem é criada, você pode excluí-la com uma solicitação DELETE.
[null,null,["Última atualização 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```"]]