# نقاط نهاية تقويم Zoom ### خدمة تقويم الويب تُعد خدمة تقويم الويب جوهر قدرة Zoom على تقديم معلومات التقويم إلى جميع تطبيقات Zoom. #### ما المعلومات التي يخزنها Zoom؟ ### تطبيقات سطح المكتب والهواتف المحمولة #### هل تخزن تطبيقات Zoom أي بيانات تقويم أو جهة اتصال؟ تحتفظ تطبيقات Zoom بمعلومات التقويم في الذاكرة المؤقتة (RAM) ولا تحتفظ بأي عناصر على القرص المحلي. ويشمل ذلك رموز المصادقة المميزة، وبيانات الاعتماد، ومعلومات فعالية التقويم، وبيانات جهة الاتصال. لم تعد هذه البيانات متاحة بمجرد خروج العميل. #### ماذا يحدث عند تسجيل الدخول؟ تبدأ تطبيقات Zoom تحديثًا كاملاً عند كل تسجيل دخول لجمع قائمة الفعاليات القادمة. ويتضمن ذلك تلقي رمز الوصول OAuth الخاص بها أو بيانات الاعتماد المخزنة من خدمة تقويم الويب الخاصة بـ Zoom، ثم استخدام ذلك الكائن لتحديث بيانات الفعالية مباشرةً من مزود التقويم. إذا كان رمز الوصول غير صالح، فستستخدم خدمة تقويم الويب الخاصة بـ Zoom رمز التحديث لطلب رمز وصول جديد وتمريره إلى العميل. #### كيف يعرف العميل أنه يجب عليه تحديث قائمة الفعاليات القادمة لديه؟ تشترك خدمة تقويم الويب الخاصة بـ Zoom في خطاف الويب لمزود التقويم لكل مستخدم بعد اتصال التقويم في بوابة الويب. تُخطِر خطافات الويب هذه خدمة تقويم الويب بأي تغييرات حتى تتمكن بعد ذلك من إخطار Zoom Client بأن التحديث مطلوب. وأخيرًا، سيطلب Zoom Client التحديث مباشرةً من مزود التقويم. ستُحدّث التطبيقات التي لا تتلقى إشعار تحديث قائمة الفعاليات الخاصة بها كل 30 دقيقة. #### ما تفاصيل الاجتماع المتاحة للعميل؟ تعرض Zoom Apps بيانات الاجتماع بعد تنقية الفعاليات التي تحللها، مما يعني أنها تخلّت عن جميع السمات التي لا تستخدمها. تُوضَّح سمات الفعالية المحفوظة للاستخدام والمستبعَدة في الجدول أدناه. | محفوظة للعرض في العميل | مستبعَدة وغير محتفظ بها | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | | | | \*فقط عند تمكين التقاط فعالية المدعوم بواسطة AI Companion 2.0 | | #### هل يتم تخزين أي بيانات خاصة بالتقويم في سجلات العميل؟ لن تقوم تطبيقات Zoom بطباعة بيانات التقويم الحساسة مثل الرموز المميزة أو بيانات الاعتماد أو الفعاليات في أي من سجلات العميل. ### أدوات الجدولة تقدم Zoom مجموعة متنوعة من الأدوات لتبسيط تجربة جدولة اجتماع Zoom مع منتجات Microsoft وGoogle. تتضمن هذه المنتجات عمليات تكامل جدولة أصلية لـ Google مساحة العمل وMicrosoft 365، أو امتدادات برمجية للاستخدام مع متصفحات يحدد وOutlook. #### كيف تعمل أدوات الجدولة؟ تُرسِل جميع أدوات الجدولة، باستثناء مكون إضافي Outlook، طلبات واجهة برمجة التطبيقات مباشرةً إلى كلٍّ من مزوّد التقويم وخدمة تقويم الويب الخاصة بـ Zoom. ويتميّز مكون إضافي Outlook بأنه يُجدول اجتماعًا عبر تطبيق سطح المكتب Zoom Client، الذي يُرسِل طلب واجهة برمجة التطبيقات إلى خدمة تقويم الويب الخاصة بـ Zoom نيابةً عن المكون الإضافي. #### ما المعلومات التي يتم إرسالها إلى Zoom عند الجدولة باستخدام أداة؟ البيانات الوحيدة التي يتم الاحتفاظ بها عند استخدام أداة جدولة هي المعلومات المطلوبة لجدولة اجتماع. على سبيل المثال، عندما يقوم مستخدم بجدولة اجتماع Zoom باستخدام الوظيفة الإضافية Microsoft 365، ستستخدم الوظيفة الإضافية موضوع الفعالية والتاريخ والوقت والمنطقة الزمنية وعلامة التكرار لجدولة اجتماع Zoom. لا تطلب الوظيفة الإضافية Zoom تفاصيل إضافية مثل النص أو قائمة الحضور ولا تستخدمها. #### هل توجد أي متطلبات لجدار حماية أو متطلبات أمنية؟ لا تتطلب أدوات الجدولة أي تغييرات إضافية في جدار الحماية أو الأمان beyond what is already necessary for تكاملات التقويم. القائمة الكاملة للمتطلبات موثقة في [قواعد الشبكة وجدار الحماية لـ Zoom](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### ما الفرق بين مكون إضافي Outlook و إضافة Outlook؟ يتم تثبيت مكون إضافي Outlook على جهاز المستخدم النهائي ويساعد المستخدمين على جدولة اجتماعات Zoom من خلال عميل Outlook الخاص بهم. يتواصل المكون الإضافي مع عميل سطح المكتب Zoom Workplace عبر قناة اتصال بين العمليات (IPC). باستخدام IPC هذا، يرسل المكون الإضافي جداول إلى خدمة التقويم عبر الويب الخاصة بـ Zoom من خلال موارد العميل. لتوفير أفضل تجربة لمستخدمينا مع الالتزام بالسياسات والإرشادات التي تضعها Apple وMicrosoft، توصي Zoom بشدة بنشر واستخدام الإضافة Zoom for Outlook. توفر لك الإضافة سهولة أكبر في النشر وحلول إدارة إدارية أكثر قوة، وتحظى بدعم نشط من Microsoft، كما أنها تلبي بشكل أفضل متطلبات الأمان المعززة مؤخرًا من قبل جهات مثل Apple. {% hint style="danger" %} **تحذير** لن يتم تنفيذ تحسينات ميزات جديدة لـ Zoom for Outlook مكون إضافي. يُنصح بشدة بالانتقال إلى Zoom for Outlook إضافة. {% endhint %} إضافة Outlook هي تطبيق مستند إلى الويب لا يتطلب تثبيتًا محليًا على أجهزة المستخدمين، بل يظهر كتطبيق ويب مدمج، متاحًا في كلٍّ من العميل المحلي وOutlook على الويب. تعمل الإضافة من خلال واجهات برمجة تطبيقات الويب التي تتواصل مباشرةً مع خدمة الويب الخاصة بالتقويم من Zoom. يوفر المكون الإضافي والإضافة وظائف متشابهة، ولكن تتطلب الإضافة أن تكون مجموعة متطلبات واجهة برمجة التطبيقات JavaScript الخاصة بـ Outlook الإصدار v1.8 — وهو إصدار لا يوجد إلا في الإصدارات الحديثة من Outlook وليس متاحًا لخادم Exchange المحلي على الإطلاق — متاحة. وهذا يعني: * لا يمكن استخدام الوظيفة الإضافية في Outlook لجدولة التفويض مع خادم Exchange المحلي. * يجب على المندوبين استخدام عميل Microsoft 365 Outlook، أو Outlook 2021 أو أحدث على جهاز Mac/PC، أو Outlook على الويب لجدولة الاجتماعات نيابةً عن مستخدم آخر. #### كيف يمكنني تحديد تطبيق الإضافة الرسمي لـ Zoom؟ تطبيق Zoom for Outlook الرسمي المتاح من ال [متجر Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) يتم تثبيته في دليل تطبيقات خطة Enterprise لـ Entra ID الخاص بك تحت اسم “Zoom-Office-add-in-SSO” مع رقم التطبيق ce63c970-e2d7-45e6-bee1-80c330b0800b. #### هل أحتاج إلى تحديث مكون Outlook الإضافي أو الإضافة؟ اعتبارًا من يناير 2025، بدأت Microsoft في استبدال رموز Exchange Online القديمة بـ المصادقة المتداخلة للتطبيق (NAA). ينبغي لمديري Zoom، بالتعاون مع مديري Entra، أن كوَّن NAA داخل بوابة Zoom على الويب باتباع التعليمات الواردة في مقالة الدعم [تكوين المصادقة المتداخلة للتطبيق لإضافات Office](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **ملاحظة** لا يتم دعم المصادقة المتداخلة للتطبيق (NAA) إلا مع Exchange Online. ستحتاج المؤسسات التي تستخدم Exchange 2019 (أو إصدارات Exchange المحلية الأخرى) إلى متابعة استخدام رموز هوية مستخدم لـ Exchange ورموز رد النداء القديمة، إذ لا يتم حظرها في البيئات المحلية. {% endhint %} بخلاف ذلك، فإن الوظيفة الإضافية Zoom for Outlook هي تطبيق قائم على الويب ولا يتطلب تثبيتًا محليًا على أجهزة المستخدمين، وبدلًا من ذلك يظهر كتطبيق ويب مدمج يعمل من خلال واجهات برمجة تطبيقات الويب للتواصل مع خدمة التقويم عبر الويب من Zoom. الوظيفة الإضافية متاحة لتطبيقات Outlook على Windows وmacOS، وتطبيقات Outlook على Android وiOS، وOutlook على الويب. ويمكن تكوين الوظيفة الإضافية ونشرها على نطاق واسع بواسطة مسؤولي Outlook أو تثبيتها بواسطة المستخدمين الأفراد. يعمل مكون Outlook الإضافي كجزء برمجي مُثبّت، وهو ما يخضع لتحديثات وتحسينات من وقت لآخر. وبالتالي، يتطلب المكون الإضافي إدارة للإصدارات وترقيات بمرور الوقت. {% hint style="info" %} **ملاحظة** المصادقة المتداخلة للتطبيق غير مطلوبة لمكون Outlook الإضافي. {% endhint %} #### ما أداة جدولة الأنسب لبيئتي؟ **Google مساحة العمل** يمكن للمؤسسات التي تستخدم Google مساحة العمل تمكين جميع المستخدمين بسهولة من جدولة اجتماعات Zoom من خلال تقويم Google عبر تثبيت تطبيق Zoom for GSuite من سوق التطبيق الخاص بـ Google مساحة العمل. ويُدار التطبيق مركزيًا ويتحدّث تلقائيًا عندما يقدّم Zoom تحسينات إلى Google. بدلاً من ذلك، تتوفر أيضًا الإضافات المستندة إلى المتصفح للاستخدام، لكنها تكون عمومًا أنسب لمستخدمي الحساب الشخصي لأنها تتطلب تثبيتًا محليًا وتحديثات دورية ولا تتم إدارتها مركزيًا. **Microsoft** بالنسبة إلى المؤسسات التي تستخدم Microsoft 365 أو Exchange Server المحلي، فإن الخيار الأفضل يعتمد على كلٍ من البيئة وكيفية تكوين تكامل التقويم. الإضافة Zoom for Outlook هي الأداة المفضلة لبيئات Microsoft 365—سواء كنت تستخدم إصدارات سطح المكتب أو الويب أو الأجهزة المحمولة من Outlook. تتطلب الإضافة Outlook for Microsoft 365 أو Outlook 2013 أو إصدارًا أحدث لنظام Windows أو Outlook 2016 أو إصدارًا أحدث على جهاز Mac. تضمن المزامنة ثنائية الاتجاه للتقويم تحديثات سلسة للتقويم، ويتم تمكينها افتراضيًا عند دمج التقويمات. يتيح ذلك لـ Zoom عكس التغييرات المُجراة على أحداث تقويم Outlook تلقائيًا — مثل إعادة جدولة الأوقات أو الإلغاء — دون الحاجة إلى أن يقوم المستخدمون بتحديث الاجتماعات أو إزالتها يدويًا عبر الإضافة. وهذا مهم بشكل خاص لأن روابط اجتماع Zoom يمكن أن تنتهي صلاحيتها إذا لم يتم التقاط التغييرات، لا سيما عندما يتم نقل اجتماع لأكثر من 30 يومًا بعد تاريخه الأصلي. تنتهي صلاحية معرّفات الاجتماع عادةً بعد 30 يومًا ما لم تكن جزءًا من سلسلة متكررة. واجهة برمجة التطبيقات الحديثة في JavaScript (v1.8)، والتي تشغّل أتمتة قائمة على الفعاليات مثل OnAppointmentSend، غير مدعومة في البيئات والتطبيقات التالية: * بيئات Exchange المحلية * Outlook الكلاسيكي متصل بـ M365 * Outlook على الأجهزة المحمولة على iOS وAndroid نتيجةً لذلك، لا يمكن لـ Zoom اكتشاف الاجتماعات أو تحديثها تلقائيًا عبر الإضافة في هذه الإعدادات. وبدون المزامنة ثنائية الاتجاه أو الأتمتة المستندة إلى واجهة برمجة التطبيقات، قد لا تعكس حتى الاجتماعات المتكررة التغييرات — مما يؤدي إلى روابط Zoom منتهية الصلاحية أو غير صالحة. يُدعَم مكون إضافي Zoom Outlook فقط على أنظمة Windows. وهو يوفّر مزامنة اجتماع محسّنة من خلال التكامل المباشر مع تطبيق Zoom Workplace، متجاوزًا قيود واجهة برمجة التطبيقات الخاصة بـ Microsoft. وعلى الرغم من أنه يُوصى به لأنظمة Windows التي لا تحتوي على المزامنة ثنائية الاتجاه، فإنه يفرض قيودًا ملحوظة: * يتطلب تحديثات MSI المُدارة من قِبل قسم تقنية المعلومات * جدولة اجتماع أبطأ * لا يوجد دعم لنظام macOS أو للأجهزة المحمولة ### غرف زووم يتم تنفيذ تكامل Zoom Rooms الخاص بالتقويم بشكل مستقل عن تكامل عميل سطح المكتب أو العميل المحمول الخاص بالمستخدم. بعد الإعداد، تظهر أحداث التقويم على شاشات Zoom Rooms، بما في ذلك شاشات التلفزيون وواجهات الجدولة ولوحات التحكم. يمكن للمستخدمين بدء الاجتماعات أو انضمام إليها بلمسة واحدة على جهاز التحكم في الغرفة. الخطوات التالية هي مخطط عام لعملية الإعداد: 1. كوِّن Microsoft Exchange Online وحدّث برامج PowerShell النصية لإعدادات Zoom Rooms لصندوق البريد 2. إعداد أذونات Microsoft Graph واجهة برمجة التطبيقات لتمكين الوصول إلى بيانات التقويم توصي Zoom باستخدام Microsoft Graph واجهة برمجة التطبيقات مع أذونات التطبيق كطريقة التكامل المعياري. تتماشى هذه التوصية مع خطة Microsoft لإزالة بروتوكولات Exchange Web Services (EWS). توفر طريقة Graph واجهة برمجة التطبيقات الاتصال الأكثر استقرارًا بين Zoom Rooms وتقويمات Microsoft 365. {% hint style="info" %} **ملاحظة** يجب على المؤسسات التي تستخدم أنظمة غرفة المؤتمر التابعة لجهات خارجية (مثل Cisco وPoly وLifesize) إكمال خطوات إضافية من خلال Zoom Enhanced واجهة برمجة التطبيقات الموصل لضمان وظائف التقويم واجتماع بشكل صحيح. يُرجى الاطلاع على مستند دليل M365 الميداني للتقويم لمزيد من المعلومات حول تكوين وصول التقويم لـ Zoom Rooms. {% endhint %} #### ما الطرق التي يمكنني استخدامها لمنح الوصول إلى صناديق بريد الغرف؟ يعتمد تكامل التقويم في Zoom Rooms على واجهة برمجة التطبيقات Microsoft Graph (MGAPI). وقد بدأت Microsoft [التخلص التدريجي من طرق خدمات الويب في Exchange (EWS)](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) التي كانت متاحة سابقًا للربط بين بيانات Microsoft 365 و خدمات Zoom. وتعتبر Zoom طرق EWS هذه خيارات قديمة. لا تملك Google مساحة العمل سوى طريقة واحدة لتطبيق الأذونات. #### ما الأذونات المطلوبة لحساب الخدمة؟ سيختلف الإذن المحدد حسب الطريقة المختارة. يتم توضيح كل خيار والأذونات المطلوبة في الجدول أدناه: | المزوّد | الطريقة | الأذونات المطلوبة | | ------------------------------------- | ------------------------------------------------------------ | -------------------------------------------- | | Microsoft 365/خادم Microsoft Exchange | أذونات التطبيق (Microsoft Graph واجهة برمجة التطبيقات) | مسؤول الحساب: إدارة المؤسسة وإدارة المستلمين | | Microsoft 365/خادم Microsoft Exchange | وصول المفوَّض الكامل (Microsoft Graph واجهة برمجة التطبيقات) | إرسال كصلاحية وصول كاملة | | Google مساحة العمل | - | إجراء تغييرات وإدارة المشاركة | {% hint style="info" %} **توصية Zoom** توصي Zoom باستخدام طريقة أذونات التطبيق لتكاملات التقويم. تتطلب هذه الإعدادات مجهودًا أقل من مسؤول، ولا تتطلب حساب خدمة مخصصًا. كما أنها الطريقة الموصى بها من Microsoft لتطبيقات خطة Enterprise التي تعمل كخدمات في الخلفية. {% endhint %} ### الموصل المُحسّن لواجهة برمجة التطبيقات يتم تنفيذ التكامل مع التقويم لأنظمة الغرف H.323 وSIP القائمة على المعايير من خلال الموصل المحسن لواجهة برمجة التطبيقات (أُصدر في أوائل عام 2021) بشكل مستقل عن عميل المستخدم وتكوين Zoom Rooms. إن منهجية حساب الخدمة والأذونات مماثلة لقسم Zoom Rooms الذي تم تناوله سابقًا. #### ما المختلف في تدفق بيانات الموصل المحسن لواجهة برمجة التطبيقات؟ لن تتواصل أنظمة الغرف المتصلة عبر الموصل لواجهة برمجة التطبيقات المُحسَّنة مع موفري التقويم مباشرةً، وهو ما يختلف عن تدفقات اتصال Zoom Client وZoom Room. تعمل خدمة الويب الخاصة بـ Zoom كعميل لهذه الأنظمة وستدفع بيانات التقويم مباشرةً إلى نقاط النهاية، مع استثناء أجهزة Poly. ستستعلم أجهزة Poly أولاً خدمة الويب الخاصة بـ Zoom عن تحديثات التقويم، ثم تنقل خدمة الويب بيانات التقويم إلى الجهاز. #### كم عدد أيام أحداث التقويم التي يتم استرجاعها؟ يسترجع الموصل لواجهة برمجة التطبيقات المُحسَّنة بيانات الاجتماع المقبل للأيام الـ30 التالية، ويزيل الاجتماعات المكتملة من التخزين بعد 30 يومًا. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://library.zoom.com/technical-library/technical-library-ar/rkn-almsuwl/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.