قم بإعداد واستخدام واجهة برمجة تطبيقات إدارة Canva

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

• متاحة لخطط Canva للمؤسسات وCanva للمناطق التعليمية وCanva للجامعات.
• يمكن لمشرفي المؤسسة الوصول إليها.
• متاحة للمؤسسات التي تضم فريقًا واحدًا أو عدة فرق.

قبل إعداد واجهة برمجة تطبيقات المشرف، تأكّد من استيفاء مؤسستك لهذه المتطلبات:

• طبقة المؤسسة: واجهة برمجة تطبيقات المشرف مرتبطة بالمؤسسة. وهي متاحة للمؤسسات التي تضم فريقًا واحدًا أو عدة فرق ضمن خطط Canva للمؤسسات وCanva للمناطق التعليمية وCanva للجامعات.
• حساب مشرف المؤسسة: يمكن لمشرفي المؤسسة فقط إنشاء عملاء واجهة برمجة تطبيقات المشرف وإدارتهم من إعدادات Canva.
• خبرات هندسية داخلية أو خارجية: تحتاج مؤسستك إلى موارد هندسية لإنشاء التكامل وصيانته. لا تقدّم Canva دعمًا للتنفيذ.
  • إذا لم يتمكن فريقك من إنشاء تكامل باستخدام واجهة برمجة التطبيقات، فإن توفير المستخدمين عبر SCIM أنسب لأتمتة إدارة المستخدمين في مؤسستك.
• الإلمام ببنية Canva لديك: احرص على فهم كيفية إعداد مؤسستك وفرقك ومجموعاتك في Canva قبل إنشاء التكامل.
• حساب مُدار عبر المصادقة متعددة العوامل (MFA) أو تسجيل الدخول الأحادي (SSO): يجب أن يكون لدى مشرف المؤسسة الذي يضبط واجهة برمجة تطبيقات المشرف حساب مفعّل عليه MFA أو حساب مُدار عبر SSO. ويجب أن تدير المؤسسة التي يتصرف المشرف نيابةً عنها هذا الحساب أو تملكه.

توفّر واجهة برمجة تطبيقات المشرف نقاط نهاية لإجراء ما يلي:

• المستخدمون والفرق والمجموعات: الإنشاء والاطّلاع والتحديث والحذف.
• العضويات: إضافة أشخاص إلى الفرق والمجموعات أو إزالتهم منها، وتعيين أدوارهم.
• سجلات التدقيق: استرجاع أحداث سجل التدقيق وفق جدول زمني.
• دعوات الفرق: دعوة أشخاص إلى فريق (بمن فيهم أشخاص من خارج مؤسستك)، والاطّلاع على الدعوات المعلّقة، واسترجاع رابط دعوة موجود باستخدام عنوان البريد الإلكتروني المحدد، وإلغاء الدعوات.

ينشئ مشرف المؤسسة عميلًا لواجهة برمجة تطبيقات المشرف ويستخدمه لاستدعاء الواجهة.

اتبع وثائق واجهة برمجة تطبيقات المشرف من Canvaا لاستبدال بيانات اعتماد العميل برمز وصول وبدء إرسال طلبات إلى واجهة برمجة التطبيقات.

للاطّلاع على التفاصيل التقنية الخاصة بمصادقة طلبات واجهة برمجة التطبيقات واستخدام رموز الحامل OAuth 2.0، شارك وثائق المصادقة لواجهة برمجة تطبيقات المشرف من Canva مع فريقك الهندسي.

تُسجّل الإجراءات التي تُنفّذ عبر واجهة برمجة تطبيقات المشرف باسم عميل الواجهة، لا باسم المشرف الذي استدعاه.

يعرض حقل «الجهة المنفذة» في سجلات التدقيق اسم عميل واجهة برمجة تطبيقات المشرف ومعرّف العميل. وهذا يساعدك على تحديد التكامل الذي نفّذ الإجراء.

يمكنك أيضًا تحديد مشرف المؤسسة الذي أنشأ عميلًا معيّنًا لواجهة برمجة التطبيقات أو حدّثه أو حذفه.

لمزيد من المعلومات، راجع نبذة عن سجلات التدقيق في Canva.

يمكن لمشرفي المؤسسة استخدام واجهة برمجة تطبيقات المشرف لدعوة أشخاص إلى فريق، بمن فيهم المتعاونون الخارجيون من خارج مؤسستك.

معلومات مهمّة

• كل دعوة تنشئها مخصّصة لفريق واحد وعنوان بريد إلكتروني واحد.
• يمكن استخدام كل دعوة مرة واحدة، وتنتهي صلاحيتها بعد 30 يومًا.
• قد لا ترسل Canva الدعوة بالبريد الإلكتروني إلى المدعو تلقائيًا، وذلك بحسب إعداداتك. عند الحاجة، شارك رابط الدعوة مع المدعو مباشرةً.
• حافظ على خصوصية روابط الدعوة. لا يعمل رابط الدعوة إلا مع عنوان البريد الإلكتروني الذي أُنشئ له.
• تظل إعدادات الدعوات والنطاق الحالية لفريقك سارية على الأشخاص الذين تدعوهم.
• إذا كانت هناك دعوة معلّقة للمدعو، فسيؤدي إنشاء دعوة جديدة إلى إرجاع سجل الدعوة نفسه، مع إعادة ضبط انتهاء الصلاحية لتكون بعد 30 يومًا من الطلب، وتحديث دور الدعوة إلى الدور المطلوب.

للاطّلاع على تفاصيل نقاط النهاية، راجع وثائق واجهة برمجة تطبيقات المشرف من Canva.

يمكن استخدام كل من واجهة برمجة تطبيقات المشرف وSCIM لتوفير المستخدمين.

تدعم واجهة برمجة تطبيقات المشرف إدارة مؤسسة Canva بما يتجاوز توفير المستخدمين، بما في ذلك الفرق والمجموعات والعضويات وسجلات التدقيق.

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

هل تحتاج مؤسستي إلى مطوّر لاستخدام واجهة برمجة تطبيقات المشرف؟

نعم. يتطلب استخدام واجهة برمجة تطبيقات المشرف أن تتوفر لدى مؤسستك موارد هندسية داخلية أو خارجية لإنشاء التكامل وصيانته. لا تقدّم Canva دعمًا للتنفيذ. إذا لم يتمكن فريقك من إنشاء تكامل باستخدام واجهة برمجة التطبيقات، فإن توفير المستخدمين عبر SCIM أنسب لأتمتة إدارة المستخدمين في مؤسستك.

هل يحتاج جميع أفراد مؤسستي إلى MFA أو SSO لاستخدام واجهة برمجة تطبيقات المشرف؟

لا. يجب أن يكون لدى مشرف المؤسسة الذي يضبط واجهة برمجة تطبيقات المشرف حساب مفعّل عليه MFA أو حساب مُدار عبر SSO. ويجب أن تدير المؤسسة التي يتصرف المشرف نيابةً عنها هذا الحساب أو تملكه. ولا يحتاج أفراد المؤسسة الآخرون إلى MFA أو SSO تحديدًا لكي تعمل واجهة برمجة تطبيقات المشرف.

هل يمكن لمؤسستي دعوة متعاونين خارجيين باستخدام واجهة برمجة تطبيقات المشرف؟

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

هل يمكننا استرجاع رابط دعوة موجود مرة أخرى من دون إنشاء دعوة جديدة؟

نعم. يمكنك استرجاع رابط دعوة موجود باستخدام عنوان البريد الإلكتروني المحدد للمدعو، من دون إنشاء دعوة جديدة.