Skip to main content
PATCH
更新用户
更新社交网络的账户或用户数据。目前支持 Google Business Profile 和 WhatsApp。
Google 对某些 Google Business Profile 位置字段的更新频率有限制,滚动 24 小时窗口内最多可更新 5 次。例如,在滚动 24 小时内对 phoneNumbers 更新超过 5 次将返回 400 响应。此限制仅适用于 Google Business Profile,不适用于 WhatsApp。

Header 参数

Path 参数

string
必填
取值:gbp、whatsapp

Body 参数

object
一个对象,包含客户可用来联系该商家的不同电话号码。
string
Google 为该位置分配的标识符。
string
一个用于在 AdWords 位置扩展中显示的备用电话号码,替代该位置的主电话。
string
该位置的外部标识符,在给定账户内必须唯一。可用于将该位置与你自己的记录进行关联。
string
位置名称应反映商家在现实世界中的实际名称,并与门店招牌、网站、办公用品以及客户所熟知的名称保持一致。
string
该商家的网站 URL。
array
用于为你的商家打标签的自由格式字符串集合。这些标签不会对用户展示;仅你可见。每个标签必须在 1-255 个字符之间。
object
表示经纬度对的对象。以两个 double 表示,分别代表纬度和经度。除非另有说明,该对象必须符合 WGS84 标准。
数值必须在规范化范围内。纬度,以度为单位。范围必须为 [-90.0, +90.0]。经度,以度为单位。范围必须为 [-180.0, +180.0]。
object
此字段包含商家用自己语言撰写的位置描述。该描述其他人无法编辑。

WhatsApp

WhatsApp 处于 Private Beta 阶段。 更新 WhatsApp 商家资料需要账户已获得 WhatsApp 使用批准。如需申请提前访问,请发送邮件至 lotty@ayrshare.com。
只发送你想要更改的字段。至少需要一个字段,发送此端点不识别的字段会导致整个请求被拒绝。 要清空某个字段,请将其作为空字符串发送:{"description": ""} 会移除描述,该字段随后将完全不再出现在资料中。这适用于 description、address 和 email。它不适用于 about,WhatsApp 要求该字段至少包含一个字符——要更改它,请直接覆盖。vertical 一旦设置后也无法清空。 响应字段 messaging_product 和 profile_picture_url(参见 WhatsApp 商家资料)为只读:将其中任何一个发回都会作为不识别的字段被拒绝。请使用 profilePictureUrl 设置照片。
string
显示在资料图片下方的文字。1-139 个字符。这是 WhatsApp 唯一不允许清空的文本字段—— 请改为覆盖它。
string
商家描述。最多 512 个字符。发送 "" 可清空。
string
商家地址。最多 256 个字符。发送 "" 可清空。
string
联系电子邮件地址。最多 128 个字符,且必须是有效地址,除非你发送 "" 来清空它。
array
一个非空数组,最多包含 2 个 URL,每个都必须以 http:// 或 https:// 开头。
string
商家类别。WhatsApp 目前接受:OTHER、AUTO、BEAUTY、APPAREL、 EDU、ENTERTAIN、EVENT_PLAN、FINANCE、GROCERY、GOVT、HOTEL、HEALTH、 NONPROFIT、PROF_SERVICES、RETAIL、TRAVEL、RESTAURANT、ALCOHOL、 ONLINE_GAMBLING、PHYSICAL_GAMBLING、OTC_DRUGS、MATRIMONY_SERVICE。这份列表由 WhatsApp 维护,可能会随时间增加——Ayrshare 不限制该值,因此任何 WhatsApp 接受的类别 都可以使用。值会被规范化为大写,例如以 retail 发送的值会以 RETAIL 返回。WhatsApp 不允许在类别设置后将其清空,并且会拒绝其不接受的值——该拒绝会以 101 返回,并附带 WhatsApp 自己的消息,其中列出当前接受的值。
string
可公开访问的 JPEG 或 PNG,大小不超过 5 MB。图片必须为正方形且至少为 192×192——推荐 640×640。没有最大分辨率限制:更大的图片会被接受并由 WhatsApp 缩小。 非正方形或小于 192×192 的图片会在任何内容发送到 WhatsApp 之前被拒绝,并返回一个 说明问题的 400。完整要求请参见 WhatsApp 媒体指南。