Google Business Profile API - Ayrshare API Documentation

发布到 Google Business Profile

使用 Google Business Profile API 可以创建四种类型的 Google Business Profile（前身为 Google My Business）帖子。在下面的示例中，post 文本作为更新发布到用户的 Google 商家主页。了解更多关于 Google Business Profile (GBP) 的信息。

在与 Ayrshare 关联之前，你必须认领你的 Google Business Profile 主页。请在链接授权期间选择作为 GBP 主页管理员的 Google 账户。该商家主页还必须经过验证且是公开的。你可以在 https://business.google.com/ 访问你的 GBP 管理控制台并检查验证状态

目前无法通过 Google Business Profile API 创建产品帖子。包含纯文本的基本 GBP 帖子的 JSON，将出现在 “What’s New” 部分：

Google Business Profile Post

{
  "post": "The best GMB ever #best https://www.google.com",
  "platforms": ["gmb"] // Please note to use `gmb`
}

或包含图片的基本 GBP 帖子的 JSON：

Google Business Profile Post with Image

{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}

如果你的视频不是以已知的视频扩展名（如 mp4）结尾，请使用 isVideo 参数。详情请参见 /post 端点。
更多信息请参见 Google Business Profile 媒体指南和 Google Business Profile 授权。

Google Business Profile 发布要求

请确保你的帖子不包含以下内容。Google 会拒绝你的帖子，帖子将显示为 “This post is no longer available” 或在 Google 控制台中带有 “Rejected” 标签：

电话号码。Google 会拒绝所有包含电话号码的帖子。
垃圾内容、虚假陈述或虚假声明。
与你的业务无关的偏离主题的帖子。
重复内容。
不适当的内容。
冒犯性语言。

更多信息请参见 Google Business Profile 内容政策。

标准帖子（What’s New）

标准本地帖子出现在 “Posts” GBP 部分，并归类为 “What’s New”。它可以包含帖子文本、图片或行动号召（见下方）。通过 Google Business Profile API 不支持将视频发布到 What’s New 部分。关于如何将视频发布到 Google Business Profile 的详情，请参见图片或视频帖子。 这些帖子将出现在 GMB 管理控制台的 “Posts -> What’s New” 部分。

Google Business Profile Standard Post

{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional - images only
  "gmbOptions": {
    "callToAction": {
      // optional
      "actionType": "learn_more",
      "url": "https://www.ayrshare.com"
    }
  }
}

图片或视频帖子

你可以将图片或视频帖子发布到 Google Business Profile。图片和视频将出现在 GBP 管理控制台的 “Photos” 部分。

要求

你的 GBP 位置只能添加一张图片或一个视频，它将出现在 GBP 控制台的 “Photos” 部分。
每篇帖子仅允许一张图片或一个视频。
端点要求提供帖子文本，但 GBP 不会使用。
图片或视频帖子不支持行动号召。
请务必在 gmbOptions 对象中包含 isPhotoVideo 参数。

Google Business Profile Image Post

{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}

视频处理

Google 有时需要额外的时间来处理上传的视频。你可以在 Google Business Profile 控制台中查看媒体的状态：

前往你的 Google Business Profile 控制台。
点击 “See your profile” 按钮。你将被带到 GBP 页面。
点击 “Photos” 标签。
你将看到照片和视频列表。
点击你想查看的照片或视频。

如果你的视频状态为 “pending”，Google 仍在处理中。请等几分钟并刷新页面。请确保你的 Google Business Profile 已经过验证并且是公开的。如果视频似乎停留在 “pending” 状态，这可能是 Google 端的错误。请联系 Google Business 支持寻求帮助。

产品类别

你可以为图片或视频指定产品类别，以便媒体在 GBP 控制台的 “Photos” 部分中进行分类。例如，如果图片的类别为 “product”，它将出现在 Photos 的 “Product” 标签下。某些类别不允许用于特定的商家类型。例如，Ayrshare 不能使用 food_and_drink，因为我们不属于食品/饮料行业。可用类别：

cover：封面照片。一个位置只有一张封面照片。
profile：个人资料照片。一个位置只有一张个人资料照片。
logo：徽标照片。
exterior：外部媒体。
interior：内部媒体。
product：产品媒体。
at_work：工作中媒体。
food_and_drink：食品和饮料媒体。
menu：菜单媒体。
common_area：公共区域媒体。
rooms：房间媒体。
teams：团队媒体。

事件帖子

推广你商家的活动。活动需要标题、开始和结束日期，还可以包含视频。例如，房地产经纪人可能会宣传开放房源。

活动支持行动号召。
使用 mediaUrls 参数包含可选的图片。
活动不支持视频。
活动帖子将出现在 GBP 管理控制台的 “Posts -> Events” 部分。
post 文本将用作活动详情。

Google Business Profile Event Post

{
  "post": "A great event!", // Event Details
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "event": {
      "title": "Check this event out.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z" // required
    }
  }
}

优惠帖子

提供你商家的促销优惠。优惠需要标题以及开始和结束日期和时间。帖子上会自动添加一个 “View offer” 操作按钮。你还可以在帖子中包含照片、描述、优惠券代码、链接以及条款和条件。例如，一家玩具店可能会宣传所有毛绒玩具一周内八折。使用 mediaUrls 参数包含图片。 优惠不支持视频。 这些帖子将出现在 GBP 管理控制台的 “Posts -> Offers” 部分。

Google Business Profile Offers Post

{
  "post": "A great offer for everyone!",
  "platforms": ["gmb"],
  "gmbOptions": {
    "offer": {
      "title": "Great Sale.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z", // required
      "couponCode": "BOGO-JET-CODE", // required - max 58 characters
      "redeemOnlineUrl": "https://www.ayrshare.com", // required
      "termsConditions": "Offer only valid if you can prove you are a time traveler" // required
    }
  }
}

couponCode 最多 58 个字符。

行动号召

提供关于你的商家的一般信息，并以操作按钮的形式显示。例如，一个网站可能会推广一个 Learn More 按钮以重定向到他们的网站。行动号召可以添加到标准帖子或活动中。优惠不能有行动号召。使用 mediaUrls 参数包含图片。

Google Business Profile Call to Action Post

{
  "post": "Take this action!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], //optional
  "gmbOptions": {
    "callToAction": {
      "actionType": "order", // required
      "url": "https://www.ayrshare.com" // required for all action types but "call"
    }
  }
}

actionType 在帖子上显示为按钮。可能的值有：

book：提示用户预约、订座或类似操作。
order：提示用户订购某物。
shop：提示用户浏览产品目录。
learn_more：提示用户查看网站上的更多详情。
sign_up：提示用户注册、登录或加入某物。
call：提示用户致电商家。call 不需要 url 字段。但你必须先在你的 Google Business Profile 中设置电话号码，才能在帖子中显示呼叫操作。

url 参数是用户点击后将被引导到的 URL。更多 Google Business Profile 信息。

Google Business Profile 关联

首个评论

Google Business Profile 不支持帖子评论，因此对于仅发布到 Google Business Profile 的帖子，firstComment 参数会被跳过。将返回一个 firstComment 警告/跳过对象，但帖子本身仍会成功，不会引发错误。

Google Business Profile 提及

虽然你可以在 Google Business Profile 帖子中添加 @handle，但 Google Business Profile 不支持在帖子文本中解析提及。 @handle 将保留为纯文本。

字符限制

更多信息请参见 Google Business Profile 字符限制。

​发布到 Google Business Profile

​Google Business Profile 发布要求

​标准帖子（What’s New）

​图片或视频帖子

​要求

​视频处理

​产品类别

​事件帖子

​优惠帖子

​行动号召

Google Business Profile 关联

​首个评论

​Google Business Profile 提及

​字符限制

发布到 Google Business Profile

Google Business Profile 发布要求

标准帖子（What’s New）

图片或视频帖子

要求

视频处理

产品类别

事件帖子

优惠帖子

行动号召

首个评论

Google Business Profile 提及

字符限制