إنشاء مفتاح API لتقويم Google
يشرح هذا الدليل كيفية إنشاء مفتاح واجهة برمجة تطبيقات تقويم جوجل يستخدم ال واجهة وحدة تحكم Google Cloud الحالية وربطه بـ Modern Events Calendar (ميك).
لا يشترط وجود خبرة سابقة في استخدام واجهات برمجة تطبيقات جوجل.
الخطوة 1: تسجيل الدخول إلى وحدة تحكم Google Cloud
- افتح وحدة تحكم Google Cloud:
https://console.cloud.google.com/ - قم بتسجيل الدخول باستخدام حساب Google الخاص بك.
إذا كانت هذه هي المرة الأولى التي تستخدم فيها Google Cloud، فقد تطلب منك Google الموافقة على شروط الخدمة أو تحديد بلد. أكمل هذه الخطوات قبل المتابعة.
الخطوة الثانية: إنشاء مشروع أو تحديد مشروع
يجب أن تنتمي جميع واجهات برمجة تطبيقات جوجل إلى مشروع.
- انقر في أعلى وحدة التحكم اختر مشروعًا.
- إذا كان لديك مشروع بالفعل، فاختره.
- إذا لم يكن كذلك ، انقر فوق مشروع جديد.
- إدخال اسم المشروع (أي اسم مناسب).
- انقر إنشاء.
- تأكد من تحديد المشروع الذي تم إنشاؤه حديثًا.
كل مفتاح API، وصلاحية، وإعداد تقوم بإنشائه ستكون تابعة لهذا المشروع.
الخطوة 3: تفعيل واجهة برمجة تطبيقات تقويم جوجل
يجب تفعيل واجهة برمجة التطبيقات (API) بشكل صريح قبل استخدامها.
- افتح القائمة الرئيسية (☰).
- انتقل إلى البرنامج المساعد في التأليف واجهات برمجة التطبيقات والخدمات ← المكتبة.
- في مربع البحث ، اكتب واجهة برمجة تطبيقات تقويم Google.
- انقر على واجهة برمجة تطبيقات تقويم Google.
- انقر تفعيل.
بدون هذه الخطوة، لن يعمل مفتاح API حتى لو تم إنشاؤه بنجاح.
الخطوة الرابعة: إنشاء مفتاح API وتكوينه
في هذه الخطوة، ستقوم بإنشاء مفتاح API الذي يستخدمه MEC للتواصل مع تقويم جوجل.
تجمع جوجل الآن بين إنشاء مفتاح واجهة برمجة التطبيقات (API) وتطبيق القيود في خطوة واحدة :
- انتقل إلى البرنامج المساعد في التأليف واجهات برمجة التطبيقات والخدمات ← بيانات الاعتماد.
- انقر إنشاء بيانات الاعتماد ← مفتاح API.
- تظهر نافذة منبثقة:
- قم بتسمية مفتاح API الخاص بك (أي اسم وصفي، على سبيل المثال، "مفتاح تقويم MEC")
- اختياريًا، تحت قم بتقييد مفتاحك لتقليل المخاطر الأمنية:
- بكج قيود واجهة برمجة التطبيقات → حدد واجهة برمجة تطبيقات تقويم Google
- بكج قيود التطبيق → على سبيل المثال، محيل HTTP (أضف اسم نطاق موقعك الإلكتروني)
- انقر إنشاء.
- سيظهر مفتاح API الجديد الخاص بك الآن. انسخه واحفظه في مكان آمن.
تدمج هذه العملية إنشاء المفتاح وإعداد القيود. لم تعد بحاجة إلى خطوات منفصلة لتقييد المفتاح.
الخطوة 5: إعداد OAuth - للتقاويم الخاصة فقط
⚠️ تخط هذه الخطوة إذا كنت تحتاج فقط إلى الوصول إلى التقاويم العامة.
معظم المستخدمين الذين يرغبون فقط في استيراد التقاويم العامة لا يحتاجون إلى إكمال هذه الخطوة.
إذا كنت بحاجة إلى الوصول إلى التقاويم الخاصة ، فإن جوجل تتطلب تفويض المستخدم عبر OAuth.
تهيئة شاشة الموافقة على OAuth
- انتقل إلى البرنامج المساعد في التأليف واجهات برمجة التطبيقات والخدمات ← شاشة موافقة OAuth.
- انقر على إبداء الأن .
- استكمال معلومات التطبيق القسم:
- اسم التطبيق
- البريد الإلكتروني لدعم المستخدم
- انقر لتالي، ثم في الجمهور القسم، حدد خارجي.
- انقر لتالي، ثم في معلومات الإتصالأدخل عنوان (عناوين) بريدك الإلكتروني.
- انقر لتاليثم ضع علامة في المربع:
- أوافق على سياسة بيانات المستخدم الخاصة بخدمات واجهة برمجة تطبيقات جوجل
- انقر اتبع الدورة، ثم اضغط إنشاء.
إنشاء معرّف عميل OAuth
بعد إكمال إعداد شاشة الموافقة على OAuth:
- في الصفحة التالية بعد الانتهاء من إعداد موافقة OAuth، يمكنك النقر على إنشاء عميل OAuth .
- بدلا من ذلك ، يمكنك الذهاب إلى واجهات برمجة التطبيقات والخدمات ← بيانات الاعتماد ثم انقر إنشاء بيانات الاعتماد ← معرّف عميل OAuth.
ثم:
- اختر تطبيق ويب.
- أدخل اسمًا لعميلك (أي اسم وصفي).
- إضافة عناوين إعادة التوجيه المعتمدة إذا تطلب ذلك عملية التكامل الخاصة بك.
- انقر إنشاء.
تُحقق كلتا الطريقتين (عبر زر إنشاء عميل OAuth أو قائمة بيانات الاعتماد ) النتيجة نفسها. استخدم الطريقة الأنسب لك.
بيانات اعتماد OAuth منفصلة عن مفتاح API ولا يلزم استخدامها إلا عند الوصول إلى بيانات التقويم الخاصة.
الخطوة 6: احصل على معرّف تقويم جوجل الخاص بك
- ساعات العمل مفكرة.
- انقر الإعدادات.
- تحت إعدادات التقويمات الخاصة بياختر التقويم الذي تريد استخدامه.
- ابحث عن ونسخ معرف التقويم.
الخطوة 7: إعداد تقويم جوجل في Modern Events Calendar
يستخدم تكامل تقويم جوجل في MEC بيانات اعتماد مختلفة حسب الإجراء الذي تريد تنفيذه.
استيراد الأحداث من تقويم جوجل (إلى MEC)
لاستيراد الأحداث من تقويم جوجل إلى MEC، يلزم فقط ما يلي:
- مفتاح API
- معرف التقويم
لضبط هذا:
- انتقل إلى لوحة معلومات WordPress الخاصة بك.
- انتقل إلى MEC → استيراد / تصدير → استيراد بيانات جوجل علامة التبويب.
- ادخل مفتاح API.
- أدخل معرف التقويم.
تستخدم هذه الطريقة بواسطة ميزة الاستيراد / التصدير المدمجة في MEC لجلب الأحداث من تقويم جوجل ولا تتطلب مصادقة OAuth.
تصدير الأحداث إلى تقويم جوجل (من MEC)
في عمل تصدير الأحداث من MEC إلى تقويم جوجل، يتطلب جوجل الوصول المصادق عليه.
هذا يعني أنه يجب عليك استخدام بيانات اعتماد OAuth، وليس مجرد مفتاح API.
للتصدير، أنت بحاجة إلى:
- معرف العميل
- سر العميل
- معرف التقويم
لضبط هذا:
- انتقل إلى MEC → استيراد / تصديرت → تصدير جوجل كال علامة التبويب.
- أدخل معرف العميل, سر العميلو معرف التقويم.
- انقر مصادقة.
بعد المصادقة، قد تتم إعادة توجيهك إلى شاشة تسجيل الدخول والأذونات في جوجل.
هذا سلوك متوقع ويعني أن جوجل تطلب منك ما يلي:
- حدد حساب Google الخاص بك
- الموافقة على أذونات الوصول المطلوبة
بمجرد الموافقة، سيتم تفويض MEC لتصدير الأحداث إلى تقويم جوجل الخاص بك.
باستخدام Advanced Importer الملحق
إذا كنت تستخدم Advanced Importer الملحقلاحظ أنه يستخدم مصادقة OAuth كذلك.
في هذه الحالة:
- معرف العميل و سر العميل يجب ضبطها داخل Advanced Importer إعدادات
- استخدم Advanced Importer يقوم بإنشاء وإدارة مصادقة جوجل الخاصة بها
- إعداد OAuth الخاص به هو منفصل عن إعدادات استيراد/تصدير جوجل الخاصة بـ MEC
استخدم Advanced Importer لا يتعامل إلا مع عمليات الاستيراد و اعمل لا يُعاد استخدامه إعدادات OAuth من ملف تصدير تقويم جوجل الخاص بـ MEC.
ملاحظات هامة
• يتم استخدام مفتاح API ومعرف التقويم لاستيراد الأحداث عبر MEC core.
• يتم استخدام معرف العميل + سر العميل + معرف التقويم لتصدير الأحداث من MEC.
• Advanced Importer يستخدم تكوين OAuth الخاص وتدفق المصادقة ولا يستخدم مفتاح API.
• مفتاح API مطلوب فقط لميزة استيراد/تصدير تقويم جوجل في MEC.
• لا يعني إعادة توجيهك إلى جوجل للمصادقة أن مفتاح API قد انتهت صلاحيته.
• هذا يعني ببساطة أن جوجل تتطلب موافقة على الإجراءات القائمة على OAuth.