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

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

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

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

هذه طريقة أسرع وأكثر اتّساعًا لإطلاق ميزة "الرسائل التجارية"، وهي المخطّط المقترَح لتفعيل المراسلة لموقع جغرافي في "الملف التجاري على Google".

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

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

بعد منحك إذن الوصول إلى Google Business Profile API، اتّبِع إرشادات الإعداد الأساسي وإعداد OAuth قبل المتابعة.

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

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

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

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

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

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

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

   • تكون حالة الأحرف غير حسّاسة.
   • يجب أن يتطابق الاسم الكامل للموظف تمامًا مع الكلمة أو الكلمات الأولى في اسم الموقع الجغرافي للملف التجاري. على سبيل المثال، يتطابق موظّف الدعم الذي يحمل الاسم "GBP Bakery" مع "Gbp Bakery Mountain View" و"Gbp Bakery" و"gbp bakery sunnyvale"، ولكنّه لا يتطابق مع "Bakery San Francisco".

3. لكل موقع جغرافي في "الملف التجاري"، أنشئ موقعًا جغرافيًا باستخدام placeId نفسه. يكون العنصر placeId لموقع جغرافي في "الملف التجاري" مضمّنًا في العنصر LocationKey عند استرداد موقع جغرافي من Google Business Profile API.

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

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

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

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

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

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

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

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

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