借助 Google My Business API,您可以在 在 Google 中搜索多个类别,例如资讯、活动和优惠。
本教程介绍了如何执行以下操作:
- 创建包含活动信息的帖子。
- 创建包含号召性用语的帖子。
- 创建包含优惠信息的帖子。
- 修改帖子。
- 删除帖子。
准备工作
您需要先注册应用,然后才能使用 Google My Business API 并获取 OAuth 2.0 凭据
要详细了解如何开始使用 Google My Business API,请参阅基本 设置。
<ph type="x-smartling-placeholder">包含活动信息的帖子
通过帖子告知客户您商家即将举行的下一次活动。您的 活动信息包含开始和结束日期及时间,这些日期和时间会 帖子中的醒目位置。
要向与用户关联的账号发布帖子,请使用
accounts.locations.localPosts
API。
如需为经过身份验证的用户创建帖子,请使用以下代码:
<ph type="x-smartling-placeholder">$ 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" }
包含号召性用语的帖子
包含号召性用语的帖子带有一个按钮。号召性用语上的文字
按钮取决于帖子的 actionType
字段。指向
用户提供的网址添加到了该按钮。
如需创建包含号召性用语按钮的帖子,请使用以下代码:
<ph type="x-smartling-placeholder">$ 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" }
操作类型
号召性用语帖子可采用不同的操作类型,具体取决于类型 号召性用语帖子。
以下是受支持的号召性用语类型:
操作类型 | |
---|---|
BOOK |
创建帖子,提示用户预约服务、桌位或 类似的内容。 |
ORDER |
创建帖子,提示用户订购商品。 |
SHOP |
创建帖子,提示用户浏览商品 目录。 |
LEARN_MORE |
创建帖子,提示用户查看 网站。 |
SIGN_UP |
创建帖子,提示用户注册、注册或加入 什么。 |
CALL |
创建帖子,提示用户致电商家。 |
优惠帖子
如需创建包含优惠信息的帖子,请使用以下代码:
<ph type="x-smartling-placeholder">$ 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" }
编辑帖子
创建帖子后,您可以使用 PATCH
请求对其进行修改。
如需修改帖子,请使用以下代码:
<ph type="x-smartling-placeholder">$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
删除帖子
创建帖子后,您可以使用 DELETE
请求将其删除。
如需删除帖子,请使用以下命令:
<ph type="x-smartling-placeholder">$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}