إضافة عناوين URL لتطبيق WhatsApp والرسائل النصية

يمكنك استخدام واجهة برمجة التطبيقات في "الملف التجاري على Google" لإضافة سمات عناوين URL الخاصة بتطبيق WhatsApp والمراسلة النصية أو تعديلها لموقع جغرافي محدّد.

من خلال تنفيذ هذه السمات، تتيح الأنشطة التجارية للعملاء التواصل معها باستخدام WhatsApp أو الرسائل القصيرة. يتيح ذلك للتجّار فتح قنوات تواصل مباشرة مع المستخدمين على GBP، بهدف تحسين تفاعل العملاء و تقديم الدعم لهم.

سنوضّح لك هنا كيفية إضافة أو تعديل أو حذف سمات عناوين URL.

المتطلبات الأساسية

قبل المتابعة، تأكَّد من توفُّر ما يلي:

  • حساب وموقع جغرافي على "الملف التجاري على Google"
  • بيانات الاعتماد اللازمة للسماح بإجراء تغييرات على الموقع الجغرافي لملفك التجاري على Google

إثبات الملكية بنجاح

لإضافة سمات أو تعديلها أو حذفها، عليك إرسال طلبات PATCH. يعرض طلب PATCH الناجح رمز الحالة HTTP 200 OK.

طلب إضافة سمة أو تعديلها

ينطبق هذا النهج على كل من WhatsApp والرسائل النصية.

لإضافة سمة واحدة أو تعديلها، استخدِم طلب HTTP PATCH يتم إرساله إلى نقطة نهاية واجهة برمجة التطبيقات Google Business Profile API الخاصة بـ location.updateattributes.

حدِّد السمة التي تستهدفها باستخدام مَعلمة طلب البحث attributeMask في عنوان URL. سيحتوي نص الطلب على بيانات السمة المعدَّلة.

بالنسبة إلى WhatsApp

يبدو الطلب على النحو التالي.

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

عند التنفيذ، استبدِل {locationId} بمعرّف الموقع الجغرافي الفعلي لملفك التجاري على Google.

سيظهر نص الطلب (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.

سيظهر نص الطلب (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_messaging3

عند التنفيذ، استبدِل {locationId} بمعرّف الموقع الجغرافي الفعلي لملفك التجاري على Google.

سيظهر نص الطلب (application/JSON) على النحو التالي.

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

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

استبدِل المثال uriValues بأقواس فارغة. يؤدي ذلك إلى إعادة ضبط القيمة و إزالتها من GBP.