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