إعداد مواقع جغرافية من "الملف التجاري"

الملف التجاري هو أداة مجانية وسهلة الاستخدام تتيح للأنشطة التجارية والمؤسسات إدارة تواجدها على الإنترنت، بما في ذلك "بحث Google" و"خرائط Google".

توفّر Google Business Profile API واجهة لإدارة معلومات الموقع الجغرافي للنشاط التجاري على Google. يمكن للنشاط التجاري منح إمكانية الوصول من خلال موافقة OAuth إلى نشاط تجاري آخر لإدارة ملفه التجاري نيابةً عنه.

سبق أن تم إثبات ملكية الأنشطة التجارية المُدارة في "الملف التجاري" من خلال عملية إثبات ملكية الملف التجاري. يمكنك تمديد فترة الموافقة على بروتوكول OAuth في "الملف التجاري على Google" لإعداد هذه الأنشطة التجارية إلى "الرسائل التجارية" وإثبات ملكيتها تلقائيًا لإطلاقها في "الرسائل التجارية".

إنها طريقة أكثر تطوّرًا وسرعةً لإطلاق "الرسائل التجارية"، وهي الطريقة المقترَحة لتفعيل المراسلة لموقع في الملف التجاري.

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

يجب أن تكون شريكًا حاليًا في "الملف التجاري على Google" ولديك حق الوصول إلى واجهات برمجة تطبيقات "الملف التجاري على Google". وإذا لم تكن كذلك، يُرجى اتّباع المتطلبات الأساسية للملف التجاري للتقدّم بطلب للوصول.

بعد منحك إذن الوصول إلى واجهة برمجة تطبيقات "الملف التجاري على Google"، اتّبِع دليلَي الإعداد الأساسي وإعداد OAuth قبل المتابعة.

تفعيل "الرسائل التجارية" لموقع جغرافي تم إثبات ملكيته في "الملف التجاري"

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

1. في تدفق الموافقة الحالي على بروتوكول OAuth حيث يمنحك مالك حساب "الملف التجاري" إمكانية الوصول إلى واجهات برمجة تطبيقات "الملف التجاري على Google" نيابةً عنه، يُرجى تعديل نطاقات واجهة برمجة التطبيقات لتضمين

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   يكون النطاقان مطلوبين لإثبات ملكية مواقع الوكيل والأنشطة التجارية تلقائيًا بنجاح.

2. إنشاء وكيل باستخدام displayName يتطابق مع اسم واحدة على الأقل من بطاقات بيانات "الملف التجاري على Google" المملوكة لبيانات اعتماد OAuth التي حصلت عليها في الخطوة السابقة. ابحث عن المواقع الجغرافية باستخدام واجهة برمجة تطبيقات "الملف التجاري على Google" للعثور على أسماء الأنشطة التجارية.

   لمطابقة الأسماء،

   • حالة الأحرف غير حساسة.
   • يجب أن يتطابق الاسم الكامل للوكيل تمامًا مع الكلمة الأولى أو الكلمات الواردة في اسم الموقع الجغرافي للملف التجاري. على سبيل المثال، هناك وكيل يُدعى "مخبز لبنان" يطابق "مخبز الجيزة،" و"مخبز الجيزة"، و"مخبز الزمالك"، ولكنه لا يطابق "مخبز الزمالك في القاهرة".

3. لكل موقع جغرافي في الملف التجاري، أنشئ موقعًا جغرافيًا باستخدام placeId نفسه. يتم تضمين placeId لموقع جغرافي على "الملف التجاري" في الكائن LocationKey عند استرداد موقع جغرافي من واجهة برمجة تطبيقات "الملف التجاري على Google".

4. باستخدام الوكيل الذي أنشأته والرمز المميز الذي تم الحصول عليه لبروتوكول OAuth، يمكنك طلب التحقق من الوكيل.

   ملاحظة: عليك استخدام الرمز المميز لبروتوكول OAuth الثنائي الذي تم الحصول عليه، وليس مفتاح حساب الخدمة لمشروعك.

   يتطلب طلب التحقق معلومات الاتصال بالعلامة التجارية. ولن ترسل عملية إثبات الملكية رسالة إلكترونية إلى العلامة التجارية إذا كان اسم الوكيل يتطابق مع اسم الملف التجاري وإذا حصلت على رمز OAuth المميّز مع النطاقات الصحيحة.

   إذا نفذت هذا الإجراء بشكل صحيح، يجب أن تعرض المخرجات الناتجة عن طلب إثبات الملكية verificationState من VERIFICATION_STATE_VERIFIED على الفور. وإذا عرضت verificationState قيمة مختلفة، من المحتمل أنك لم تستخدِم رمز OAuth المميّز الصحيح عند تقديم الطلب أو تعذّر مطابقة الوكيل مع الموقع الجغرافي للملف التجاري.

5. باستخدام رمز OAuth المميز نفسه، يمكنك طلب إثبات ملكية الموقع الجغرافي لجميع المواقع الجغرافية التي يملكها النشاط التجاري في الملف التجاري.

   كما هو الحال مع عملية التحقّق من صحة معلومات الوكيل، إذا نفّذت هذا الإجراء بشكل صحيح، يجب أن تعرض المخرجات الناتجة عن طلب إثبات الملكية verificationState من VERIFICATION_STATE_VERIFIED على الفور. إذا عرضت verificationState قيمة مختلفة، من المرجّح أنك لم تستخدم رمز OAuth المميّز الصحيح عند تقديم الطلب، أو أنّ الموقع الجغرافي على "الملف التجاري" ليس نشاطًا تجاريًا تمت المطالبة به وتم إثبات ملكيته.

6. تشغيل الوكيل باستخدام نقطة الإدخال LOCATION.

7. مكّن المراسلة لمواقع معينة من خلال إطلاق المواقع التي تريد إتاحتها من خلال البحث والخرائط. وبعد بدء عملية الإطلاق، تصبح الرسائل لكل موقع جغرافي مُطلق متاحة للمستخدمين في غضون ساعات قليلة.

بعد اتّباع هذه الخطوات، يتم نشر جميع رسائل المستهلكين في الرد التلقائي على الويب لرسائل الأنشطة التجارية، ويجب عليك إرسال الردود إلى المستهلكين باستخدام واجهة برمجة تطبيقات Business Messages.