كيفية الحصول على واجهات برمجة تطبيقات Google Business الخاصة بي

أسئلة
1

كيفية الحصول على واجهات برمجة تطبيقات Google Business الخاصة بي

2

@Rohit_Kulkarni

هل قمت بهذا؟

  1. انتقل إلى نموذج طلب Google Business Profile API.
  2. املأ الطلب. تحتاج Google إلى معرفة السبب في رغبتك في الوصول إلى API.
  3. انتظر الموافقة. ستتلقى بريداً إلكترونياً بمجرد إدراج مشروعك في القائمة البيضاء. لا يمكنك المتابعة مع استدعاءات API في n8n حتى يتم الموافقة على هذا.

هذا فقط للمرحلة الأولى. بعد الموافقة، قم بإعداد مشروعك للمرحلة الثانية:

  1. إنشاء مشروع:

    • انتقل إلى Google Cloud Console.
    • أنشئ مشروعاً جديداً (مثل “n8n-Business-Automation”).

  2. تفعيل واجهات برمجية الطلبات:

    • انتقل إلى APIs & Services > Library.
    • ابحث عن الخيارات التالية وفعّلها:
      • Google Business Profile Management API
      • My Business Business Information API
      • My Business Account Management API

  3. تكوين شاشة موافقة OAuth:

    • انتقل إلى APIs & Services > OAuth consent screen.
    • اختر External (إلا إذا كان لديك مؤسسة Google Workspace وتريد الاستخدام الداخلي فقط).
    • املأ اسم التطبيق والبريد الإلكتروني للمطور المطلوبين.
    • Scopes: أضف النطاقات المطلوبة لـ Business Profile API (عادةً ما تكون موجودة في توثيق API، مثل https://www.googleapis.com/auth/business.manage).
    • مستخدمو الاختبار: بينما يكون تطبيقك في وضع “Testing”، يجب أن تضيف عنوان بريدك الإلكتروني من Google كمستخدم اختبار، وإلا ستحصل على خطأ “403 Access Denied”.

  4. إنشاء بيانات اعتماد:

    • انتقل إلى APIs & Services > Credentials.
    • انقر على Create Credentials → OAuth client ID.
    • نوع التطبيق: Web application.
    • Authorized Redirect URIs: هذا أمر بالغ الأهمية. انتقل إلى مثيل n8n الخاص بك، وافتح عقدة Google Business Profile، وأنشئ بيانات اعتماد جديدة، وانسخ OAuth Redirect URL التي يوفرها n8n. الصق هذا العنوان هنا.
    • انقر على Create وانسخ Client ID و Client Secret الخاصين بك.

للاتصال بـ n8n:

  1. افتح سير عمل n8n الخاص بك.
  2. أضف عقدة Google Business Profile.
  3. في قسم Credential، اختر “Create New Credential”.
  4. الصق Client ID و Client Secret اللذين حصلت عليهما من Google Cloud Console.
  5. انقر على Sign in with Google.
  6. ستظهر نافذة منبثقة. اختر حسابك وانقر على “Continue” (قد ترى تحذيراً بأن التطبيق لم يتم التحقق منه؛ انقر على “Advanced” → “Go to [Your App Name] (unsafe)” للمتابعة).
  7. بعد التفويض، يجب أن تتغير الحالة في n8n إلى Connected.
3

1. تحقق من استحقاقك أولاً
تتطلب Google إدارة ملف تعريف للنشاط التجاري تم التحقق من صحته وهو نشط لمدة 60+ يوماً قبل أن تتمكن حتى من التقديم. إذا كان إدراجك أحدث من ذلك، فسيتم رفضك.

2. أنشئ مشروع Google Cloud
انتقل إلى Google Cloud Console، انقر فوق إنشاء مشروع، وأعطها اسماً، وأنشئها. استخدم مشروعاً مخصصاً بدلاً من صندوق حماية موجود، فهذا يحافظ على الموافقة والحصة أنظف.

3. قدّم طلب الوصول
اطلب الوصول إلى واجهة برمجة تطبيقات Business Profile عبر نموذج الاتصال بـ GBP API وانتظر الموافقة. الموافقة ليست فورية، وعادة ما تستغرق عدة أيام إلى بضعة أسابيع، والرفض شائع إذا لم يشرح النموذج بوضوح ما تقوم بإنشاؤه ولماذا تحتاجه.

4. فعّل واجهات البرمجة بعد الموافقة
قسمت Google واجهة برمجة التطبيقات “My Business API” الموحدة القديمة إلى واجهات برمجة تطبيقات منفصلة مخصصة الغرض في عام 2022، وأصبح هناك الآن ثماني واجهات برمجة، تغطي أشياء مثل إدارة الحساب ومعلومات النشاط التجاري والتقييمات والمنشورات وبيانات الأداء. في مكتبة API في Cloud Console، فعّل الواجهات المحددة التي تحتاجها فعلاً بدلاً من جميع الثماني، فالواجهات المفعلة الأقل تعني مراجعة موافقة أنظف إذا احتجت يوماً ما إلى مزيد من الوصول.

5. إعداد بيانات اعتماد OAuth 2.0
بما أن واجهات برمجة التطبيقات هذه تتعامل مع بيانات النشاط التجاري الخاصة، فأنت بحاجة إلى معرّف عميل OAuth 2.0: انتقل إلى Credentials في Cloud Console، انقر فوق إنشاء بيانات اعتماد → معرّف عميل OAuth، واحفظ معرّف العميل + السر. هذا ما ستستخدمه أداة الأتمتة الخاصة بك للمصادقة.

4

بالنسبة إلى ملف تعريف نشاطك التجاري على Google، الجزء المهم هو أن الوصول عبر واجهة برمجة التطبيقات (API) ليس مجرد تسجيل دخول عادي على Google. عادةً تحتاج إلى كليهما:

1. حساب Google له وصول إلى موقع ملف تعريف نشاطك التجاري.

2. موافقة على وصول واجهة برمجة تطبيقات ملف تعريف نشاطك التجاري على Google لمشروع Google Cloud.

المسار العملي هو:

- إنشاء أو اختيار مشروع Google Cloud.

- تفعيل واجهات برمجة التطبيقات ذات الصلة بملف تعريف نشاطك التجاري.

- تكوين موافقة OAuth والبيانات الاعتمادية.

- تقديم طلب الوصول إلى واجهة برمجة تطبيقات ملف تعريف نشاطك التجاري من Google إذا كان مشروعك لا يتمتع بالوصول بالفعل.

- بعد الموافقة، أعد توصيل بيانات اعتماد OAuth في n8n.

في n8n، كنت سأقوم أولاً بإنشاء سير عمل اختبار للقراءة فقط يجلب بيانات الموقع والمراجعات ويكتب النتيجة في جدول أو ورقة عمل. بمجرد أن يعمل ذلك، أضف خطوة المسودة بالذكاء الاصطناعي. بالنسبة إلى الردود العامة على المراجعات، احتفظ بخطوة موافقة بشرية قبل نشر أي شيء.