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

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

• متاحة لخطط Canva للمؤسسات وCanva للمناطق التعليمية وCanva للجامعات.
• متاحة لمشرفي المؤسسة.
• متاحة للمؤسسات ذات الفريق الواحد والفرق المتعددة.

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

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

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

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

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

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

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

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

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

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

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

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

معلومات لازم تعرفها

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

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

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

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

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

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

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

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

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

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

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

هل نقدر نسترجع رابط دعوة موجود تاني من غير ما ننشئ دعوة جديدة؟

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