قم بإعداد واستخدام واجهة برمجة تطبيقات إدارة Canva
ملاحظة: أنت بحاجة إلى مؤسسة في Canva لاستخدام واجهة برمجة تطبيقات الإدارة. تعمل واجهة برمجة تطبيقات الإدارة على مستوى المؤسسة.
يمكنك استخدام Canva Admin API لأتمتة إدارة مؤسستك من خلال أنظمتك الخاصة. أدر المستخدمين والفرق والمجموعات والعضويات، واسترجع أحداث سجل التدقيق من دون تنفيذ هذه المهام يدويًا في Canva.
تحقّق من التوفّر
- متاح لخطط Canva Enterprise وCanva Districts وCanva Campus.
- يمكن لمسؤولي المؤسسات الوصول إليه.
- متاح للمؤسسات التي تضم فريقًا واحدًا أو عدة فرق.
تحقّق من المتطلبات
قبل إعداد Admin API، تأكّد من استيفاء مؤسستك للمتطلبات التالية:
- نطاق المؤسسة: يعمل Admin API على مستوى المؤسسة. وهو متاح للمؤسسات التي تضم فريقًا واحدًا أو عدة فرق ضمن خطط Canva Enterprise وCanva Districts وCanva Campus.
- حساب مسؤول المؤسسة: يمكن لمسؤولي المؤسسات فقط إنشاء عملاء Admin API وإدارتهم في إعدادات Canva.
- خبرات هندسية داخلية أو بالاستعانة بمصادر خارجية: تحتاج مؤسستك إلى موارد هندسية لإنشاء التكامل وصيانته. لا توفّر Canva دعمًا للتنفيذ.
- إذا لم يتمكّن فريقك من إنشاء تكامل باستخدام API، فإن توفير المستخدمين عبر SCIM أنسب لأتمتة إدارة المستخدمين في مؤسستك.
- الإلمام ببنية Canva لديك: احرص على فهم كيفية إعداد مؤسستك وفرقك ومجموعاتك في Canva قبل إنشاء التكامل.
- المصادقة متعددة العوامل (MFA) أو حساب مُدار عبر تسجيل الدخول الأحادي (SSO): يجب أن يكون MFA مفعّلًا لدى مسؤول المؤسسة الذي يضبط Admin API، أو أن يستخدم حسابًا مُدارًا عبر SSO. ويجب أن يكون الحساب مُدارًا من المؤسسة التي يتصرف المسؤول نيابةً عنها أو مملوكًا لها.
تعرّف على ما يمكنك إدارته
يوفّر Admin API نقاط نهاية لإدارة ما يلي:
- المستخدمون والفرق والمجموعات: الإنشاء والقراءة والتحديث والحذف.
- العضويات: إضافة الأشخاص إلى الفرق والمجموعات أو إزالتهم منها، وتحديد أدوارهم.
- سجلات التدقيق: استرجاع أحداث سجل التدقيق وفق جدول زمني.
- دعوات الفرق: دعوة أشخاص إلى فريق، بمن فيهم أشخاص من خارج مؤسستك، وعرض الدعوات المعلّقة، واسترجاع رابط دعوة قائم باستخدام عنوان البريد الإلكتروني المطابق تمامًا، وإلغاء الدعوات.
إعداد Admin API
ينشئ مسؤول المؤسسة عميل Admin API ويستخدمه لاستدعاء API.
قم بإعداد واجهة برمجة تطبيقات الإدارة
- انتقل إلى الإعدادات.
- حدد Admin API، ثم حدد إنشاء عميل API.
- سمِّ العميل وحدد النطاقات التي تحدد ما يمكن للعميل الوصول إليه.
- حدد متابعة.
- انسخ معرّف العميل وسر العميل، ثم حدد تم.
- استبدل بيانات الاعتماد برمز وصول، وهو صالح لمدة أربع ساعات.
- استخدم رمز الوصول لاستدعاء Admin API.
اتبع وثائق Canva Admin APIة لاستبدال بيانات اعتماد العميل برمز وصول والبدء بإرسال طلبات API.
للاطّلاع على التفاصيل التقنية الخاصة بمصادقة طلبات API واستخدام رموز الوصول لحامل OAuth 2.0، شارك وثائق المصادقة لـ Canva Admin API مع فريقك الهندسي.
تعرّف على سجلات تدقيق Admin API
تُسجَّل الإجراءات المنفّذة عبر Admin API باسم عميل Admin API، وليس باسم المسؤول الذي استدعاه.
يعرض حقل «المنفّذ» في سجلات التدقيق اسم عميل Admin API ومعرّف العميل. ويساعدك ذلك على معرفة التكامل الذي نفّذ الإجراء.
يمكنك أيضًا معرفة مسؤول المؤسسة الذي أنشأ عميل API معيّنًا أو حدّثه أو حذفه.
لمزيد من المعلومات، اطّلع على نبذة عن سجلات تدقيق Canva.
دعوة أشخاص إلى الفرق
يمكن لمسؤولي المؤسسات استخدام Admin API لدعوة أشخاص إلى فريق، بمن فيهم المتعاونون الخارجيون من خارج مؤسستك.
أمور يجب معرفتها
- كل دعوة تنشئها مخصّصة لفريق واحد وعنوان بريد إلكتروني واحد.
- يمكن استخدام كل دعوة مرة واحدة، وتنتهي صلاحيتها بعد 30 يومًا.
- قد لا ترسل Canva رسالة بالبريد الإلكتروني إلى المدعو تلقائيًا، وذلك بحسب إعداداتك. عند الحاجة، شارك رابط الدعوة معه مباشرةً.
- حافظ على خصوصية روابط الدعوة. لا يعمل رابط الدعوة إلا مع عنوان البريد الإلكتروني الذي أُنشئ له.
- تظل إعدادات الدعوات والنطاق الحالية لفريقك سارية على الأشخاص الذين تدعوهم.
- إذا كانت هناك دعوة معلّقة للمدعو، فسيؤدي إنشاء دعوة جديدة إلى إرجاع سجل الدعوة نفسه، مع إعادة ضبط تاريخ انتهاء الصلاحية ليكون بعد 30 يومًا من الطلب، وتحديث دور المدعو إلى الدور المطلوب.
للاطّلاع على تفاصيل نقاط النهاية، راجع وثائق Canva Admin API.
الاختيار بين Admin API وSCIM
يمكن لكل من Admin API وSCIM دعم توفير المستخدمين.
تدعم Admin API إدارة مؤسستك في Canva بما يتجاوز توفير المستخدمين، ويشمل ذلك الفرق والمجموعات والعضويات وسجلات التدقيق.
يدعم SCIM توفير المستخدمين وإلغاء توفيرهم وفق المعايير المعتادة. إذا كنت تحتاج فقط إلى توفير المستخدمين بالطريقة المعتادة، أو لم يتمكّن فريقك من إنشاء تكامل API مخصّص، فإن SCIM أنسب لاحتياجاتك.
الأسئلة الشائعة
هل تحتاج مؤسستي إلى مطوّر لاستخدام Admin API؟
نعم. يتطلب Admin API توفّر موارد هندسية داخل مؤسستك أو بالاستعانة بمصادر خارجية لإنشاء التكامل وصيانته. لا توفّر Canva دعمًا للتنفيذ. إذا لم يتمكّن فريقك من إنشاء تكامل باستخدام API، فإن توفير المستخدمين عبر SCIM أنسب لأتمتة إدارة المستخدمين في مؤسستك.
هل يحتاج الجميع في مؤسستي إلى MFA أو SSO لاستخدام Admin API؟
لا. يجب أن يكون MFA مفعّلًا لدى مسؤول المؤسسة الذي يضبط Admin API، أو أن يستخدم حسابًا مُدارًا عبر SSO. ويجب أن يكون الحساب مُدارًا من المؤسسة التي يتصرف المسؤول نيابةً عنها أو مملوكًا لها. لا يحتاج أعضاء المؤسسة الآخرون إلى MFA أو SSO تحديدًا لكي يعمل Admin API.
هل يمكن لمؤسستي دعوة متعاونين خارجيين باستخدام Admin API؟
نعم. يمكن لمسؤولي المؤسسات استخدام Admin API لدعوة أشخاص إلى الفرق، بمن فيهم المتعاونون الخارجيون. وتظل إعدادات الدعوات والنطاق الحالية لفريقك سارية على الأشخاص الذين تدعوهم.
هل يمكننا استرجاع رابط دعوة قائم مرة أخرى من دون إنشاء دعوة جديدة؟
نعم. يمكنك استرجاع رابط دعوة قائم باستخدام عنوان البريد الإلكتروني المطابق تمامًا للمدعو، من دون إنشاء دعوة جديدة.
هل كانت المقالة مفيدة؟
مفيد
غير مفيدة