عمليات ربط واجهة برمجة تطبيقات Notion

في مستند المساعدة هذا

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


يمكنك إدارة رموز الوصول الشخصية من Notion. قم بتفعيل وضع المطور من الإعدادات، ثم افتح رموز الوصول الشخصية من قسم المطور في شريطك الجانبي. قم بزيارة مركز المطورين الخاص بنا للحصول على الوثائق والموارد وأدوات إدارة عمليات الربط.

ملاحظة: لكل عملية ربط مالك واحد أو أكثر، ويمكن لكل مالك إدارتها والحصول على رمز API الخاص بها. تحدّد خطتك وإعدادات مساحة عملك من يمكنه إنشاء عملية ربط. تعرّف على المزيد حول إعدادات عمليات الربط في الخطة المؤسسية →

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

أي رمز أحتاج؟ تستخدم Notion بضعة رموز مختلفة. الرمز الذي تنسخه لعملية ربط داخلية هو رمز واجهة برمجة التطبيقات، وهو ما تتناوله هذه المقالة. ترتبط رموز الوصول الشخصية بحسابك الخاص. يتعامل OAuth مع التطبيقات التي تسجّل الدخول إليها. إذا طلبت منصة شريكة رمزًا لعملية ربط أنشأتها، فاستخدم رمز واجهة برمجة التطبيقات.

  1. في الشريط الجانبي الأيسر، انتقل إلى الإعدادات ثم علامة التبويب عمليات ربط.

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

  3. قم بتفعيل وضع المطور، ثم افتح رموز الوصول الشخصية من قسم المطور في شريطك الجانبي.

  4. انقر على + ربط جديد.

  5. قدّم اسماً لعملية الربط الخاصة بك. اختيارياً، يمكنك أيضاً تحميل صورة لاستخدامها كـ شعار.

  6. استخدم القائمة المنسدلة لتحديد مساحة العمل المرتبطة التي تود استخدام عملية الربط هذه معها.

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

    معلومات التكامل
  7. تمت إضافة عملية الربط الداخلية الخاصة بك بنجاح! ستتمكن الآن من رؤيتها في مساحة عملك، في قائمة الإعدادات ← عمليات ربط.

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

معلومات التكامل

ملاحظة: عمليات الربط الداخلية خاصة بمساحة العمل، لذا لتغيير مساحة العمل المرتبطة، سيتعين عليك إنشاء عملية ربط جديدة.

قائمة التكامل - إنشاء

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

لإضافة مالك أو إزالته:

  1. افتح بوابة المطورين وحدد عملية الربط الخاصة بك.

  2. افتح علامة التبويب مالكو الربط.

  3. أضف عضوًا أو مجموعة بصفة مالك، أو أزل عضوًا أو مجموعة من المالكين.

ملاحظات بشأن مالكي عمليات الربط:

  • يمكن فقط للأعضاء ذوي العضوية الكاملة ومالكي مساحة العمل أن يكونوا مالكين لعملية الربط. ولا يمكن للضيوف أو الأعضاء ذوي الوصول المحدود تولّي ملكيتها.

  • تحدد إعدادات مساحة عملك بشأن من يمكنه إنشاء عمليات ربط أيضًا من يمكنك إضافته بصفة مالك.

  • يحتفظ الربط دائمًا بمالك واحد على الأقل، لذا لا يمكنك إزالة المالك الأخير.

  • إذا كنت مالكًا لمساحة العمل وتحتاج إلى تولي إدارة ربط ما، فأضف نفسك بصفة مالك أولًا.

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

يمكنك مشاركة الملكية في الخطة المميزة وخطة الأعمال والخطة المؤسسية، باستخدام Notion في متصفحك أو تطبيق سطح المكتب.

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

بعد ذلك، اتبع التعليمات الواردة في دليل المطور الخاص بنا لتحويله إلى ربط عام.

عند إنشاء عملية ربط عامة، اختر من يمكنه تثبيتها:

  • أي مساحة عمل: يمكن لأي شخص تثبيت عملية الربط الخاصة بك في مساحة عمل Notion الخاصة به.

  • مساحات عمل محددة: لا يمكن تثبيت عملية الربط الخاصة بك إلا في مساحات العمل التي تدرجها.

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

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

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

ملاحظة: تختار هذا الإعداد عند إنشاء عملية الربط. إذا احتجت إلى إعداد مختلف لاحقًا، أنشئ عملية ربط جديدة.

تظهر عملية الربط التي تمتلكها في بوابة المطورين لكل مساحة عمل يُسمح لها بتثبيتها، أو ثُبّتت فيها بالفعل، أو أنشأتها فيها.

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

  1. افتح عملية الربط الخاصة بك في بوابة المطورين.

  2. انتقل إلى إعدادات عملية الربط.

  3. اختر مساحة العمل التي تريد الإنشاء فيها.

تربط Notion عملية الربط الخاصة بك بمساحة العمل التي اخترتها. لا تحتاج إلى إنشاء عملية ربط جديدة.

أثناء عملية إعداد التطبيق، سيتمكن المطورون من اختيار مستوى الوصول المطلوب من المستخدم.

  • إمكانات المحتوى:

    • قراءة المحتوى فقط

    • كتابة المحتوى فقط

    • إدراج محتوى

  • إمكانات المستخدم

    • لا توجد معلومات مستخدم

    • قراءة معلومات المستخدم (لا تشمل عنوان البريد الإلكتروني للمستخدم)

    • قراءة معلومات المستخدم (بما في ذلك البريد الإلكتروني)

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

تُمكّن ربط خطافات الويب عمليات ربط من مراقبة التغييرات في مساحات العمل Notion والاستجابة لها في الوقت الفعلي.

عند حدوث تغييرات في الصفحات أو قواعد بيانات مشتركة مع عملية الربط الخاصة بك، يرسل Notion تلقائياً إشعارات إلى نقطة نهاية ربط خطاف الويب الخاصة بك، مما يسمح لعملية الربط الخاصة بك بتحديث الأدوات الأخرى فوراً، أو تنفيذ عمليات تشغيل آلية، أو عرض أحدث التغييرات.

للحصول على التعليمات، يرجى زيارة وثائق المطورين الخاصة بنا.

لا تدعم خطافات الويب لربط حالياً إشعارات لما يلي:

  • تغييرات المستخدم (بما في ذلك تغييرات عضوية مساحة العمل، وتحديثات البريد الإلكتروني/الاسم، وتعديلات الأذونات).

  • تغييرات إعدادات مساحة العمل ومساحة الفريق.

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

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

  • يمكنها مراقبة النشاط عبر مساحات عمل متعددة.

  • يمكنها التعامل مع عدد غير محدود من الإجراءات.

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


تقديم تعليق

هل كان هذا المورد مفيداً؟


Powered by Fruition