میتوانید از API نمایه کسبوکار Google (GBP) برای افزودن یا بهروزرسانی ویژگیهای URL واتساپ و پیامهای متنی برای یک مکان خاص استفاده کنید.
با پیاده سازی این ویژگی ها، کسب و کارها مشتریان را قادر می سازند تا با استفاده از واتس اپ یا پیامک با آنها تماس بگیرند. این به بازرگانان اجازه میدهد تا کانالهای ارتباطی مستقیم با کاربران در GBP را با هدف بهبود تعامل و پشتیبانی مشتری باز کنند.
در اینجا نحوه افزودن، به روز رسانی یا حذف ویژگی های URL را به شما نشان می دهیم.
پیش نیازها
قبل از ادامه، مطمئن شوید که دارید
- حساب و مکان نمایه کسب و کار Google
- اعتبارنامه های مجوز لازم برای ایجاد تغییرات در مکان نمایه کسب و کار Google
موفقیت را تأیید کنید
برای افزودن، بهروزرسانی یا حذف ویژگیها، درخواستهای PATCH ارائه میکنید. یک درخواست PATCH موفق، کد وضعیت HTTP 200 OK
را برمیگرداند.
درخواست اضافه کردن یا به روز رسانی یک ویژگی
این رویکرد هم برای واتس اپ و هم برای پیامک اعمال می شود.
برای افزودن یا بهروزرسانی یک مشخصه، از یک درخواست HTTP PATCH ارسال شده به نقطه پایانی API نمایه Google Business برای location.updateattributes
استفاده کنید.
مشخصه مورد نظر خود را با استفاده از پارامتر query attributeMask
در URL مشخص کنید. بدنه درخواست حاوی داده های ویژگی به روز شده خواهد بود.
برای واتساپ
درخواست به شکل زیر است.
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp
در اجرای خود، { locationId
} را با شناسه واقعی مکان نمایه کسب و کار Google خود جایگزین کنید.
بدنه درخواست (برنامه/JSON) به شکل زیر خواهد بود.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": [
{
"uri": "https://wa.me/55555555"
}
]
}
]
}
مثال 55555555
با شماره تلفن واتساپ تجاری با فرمت بین المللی جایگزین کنید.
برای پیامک
درخواست به شرح زیر خواهد بود.
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_text_messaging
در اجرای خود، { locationId
} را با شناسه واقعی مکان نمایه کسب و کار Google خود جایگزین کنید.
بدنه درخواست (برنامه/JSON) به شکل زیر خواهد بود.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_text_messaging",
"values":[],
"uriValues": [
{
"uri": "sms:5555555555"
}
]
}
]
}
شماره تلفن کسب و کار sms:5555555555
برای پیامک جایگزین کنید.
حذف صفات
میتوانید هر دو ویژگی را در یک درخواست DELETE با گنجاندن attributes/url_whatsapp
یا attributes/url_text_messaging
در پارامتر query attributeMask
حذف کنید. بدنه درخواست شامل آرایهای از اشیاء ویژگی است، یکی برای هر ویژگی که میخواهید بهروزرسانی یا حذف کنید.
درخواست به شکل زیر است.
DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp,attributes/url_text_messaging3
در اجرای خود، { locationId
} را با شناسه واقعی مکان نمایه کسب و کار Google خود جایگزین کنید.
بدنه درخواست (برنامه/JSON) به شکل زیر خواهد بود.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": []
}
]
}
نمونه uriValues
با پرانتزهای خالی جایگزین کنید. این مقدار را بازنشانی می کند و آن را از GBP شما حذف می کند.