添加 WhatsApp 和短信网址

您可以使用 Google 商家资料 (GBP) API 为特定营业地点添加或更新 WhatsApp 和短信网址属性。

通过实现这些属性，商家可以让客户使用 WhatsApp 或短信与他们联系。这样，商家就可以在 GBP 上与用户建立直接的沟通渠道，从而提高客户互动度和支持服务水平。

下面介绍了如何添加、更新或删除网址属性。

前提条件

在继续之前，请确保您已备妥：

  • Google 商家资料账号和营业地点
  • 用于更改 Google 商家资料营业地点的必要授权凭据

验证成功时的行为

如需添加、更新或删除属性，您需要发出 PATCH 请求。成功的 PATCH 请求会返回状态代码 HTTP 200 OK。

请求添加或更新属性

此方法适用于 WhatsApp 和短信。

如需添加或更新单个属性，请使用 HTTP PATCH 请求发送到 location.updateattributes 的 Google Business Profile API 端点。

在网址中使用 attributeMask 查询参数指定要定位到的属性。请求正文将包含更新后的属性数据。

对于 WhatsApp

请求如下所示。

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp

在实现时，请将 {locationId} 替换为 Google 商家资料营业地点的实际 ID。

请求正文（application/JSON）如下所示。

{
  "name": "locations/17826990302864573181/attributes",
  "attributes": [
  {
    "name":"attributes/url_whatsapp",

    "values":[],
    "uriValues": [
        {
          "uri": "https://wa.me/55555555"
        }
      ]
    }
  ]
}

将示例 55555555 替换为采用国际格式的商家 WhatsApp 电话号码。

短信

请求如下所示。

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_text_messaging

在实现时，请将 {locationId} 替换为 Google 商家资料营业地点的实际 ID。

请求正文（application/JSON）如下所示。

{
  "name": "locations/17826990302864573181/attributes",
  "attributes": [
    {
      "name":"attributes/url_text_messaging",

      "values":[],
      "uriValues": [
        {
        "uri": "sms:5555555555"
        }
      ]
    }
  ]
}

将示例 sms:5555555555 替换为用于发送短信的商家电话号码。

删除属性

您可以在 DELETE 请求中同时删除这两个属性，方法是在 attributeMask 查询参数中添加 attributes/url_whatsapp 或 attributes/url_text_messaging。请求正文将包含一个属性对象数组，每个对象对应一个要更新或删除的属性。

请求如下所示。

DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp,attributes/url_text_messaging3

在实现时，请将 {locationId} 替换为 Google 商家资料营业地点的实际 ID。

请求正文（application/JSON）如下所示。

{
  "name": "locations/17826990302864573181/attributes",
  "attributes": [
    {
    "name":"attributes/url_whatsapp",

    "values":[],
    "uriValues": []
    }
  ]
}

将示例 uriValues 替换为空括号。这会重置该值，并将其从您的 GBP 中移除。