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

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

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

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

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

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

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

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

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

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

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

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

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

لمزيد من المعلومات، اطّلع على نبذة عن سجلات تدقيق Canva.

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

أمور عليك معرفتها

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

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

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

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

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

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

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

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

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

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

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

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

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