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

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

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

قبل إعداد Admin API، تأكّد من استيفاء مؤسستك للمتطلبات دي:

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

يوفّر Admin API نقاط نهاية لإدارة:

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

ينشئ مشرف المؤسسة عميل Admin API ويستخدمه لإرسال طلبات إلى API.

اتّبع وثائـق Canva Admin APIـ لاستبدال بيانات اعتماد العميل برمز وصول وبدء إرسال طلبات API.

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

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

في سجلات التدقيق، يعرض حقل «المنفّذ» اسم عميل Admin API ومعرّف العميل. وده بيساعدك تعرف أي تكامل نفّذ الإجراء.

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

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

يقدر مشرفو المؤسسة استخدام Admin API لدعوة أعضاء إلى فريق، بما فيهم المتعاونون الخارجيون من خارج المؤسسة.

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

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

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

يدعم كل من Admin API وSCIM توفير المستخدمين.

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

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

هل تحتاج مؤسستي إلى مطوّر لاستخدام Admin API؟

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

هل يحتاج كل أفراد مؤسستي إلى MFA أو SSO لاستخدام Admin API؟

لأ. لازم يكون لدى مشرف المؤسسة الذي يضبط Admin API حساب مفعّل عليه MFA أو حساب مُدار عبر SSO. ولازم تكون المؤسسة التي يعمل المشرف بالنيابة عنها هي التي تدير الحساب أو تملكه. مش لازم أفراد المؤسسة التانيين يستخدموا MFA أو SSO عشان Admin API يشتغل.

هل تقدر مؤسستي تدعو متعاونين خارجيين باستخدام Admin API؟

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

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

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