دعوة المستخدمين إلى حدث

إنشاء حدث

إذا كان لديك إذن بالكتابة في تقويم Google الخاص بالمنظِّم، يمكنك إضافة حدث باستخدام طريقة Events: insert.

تضيف هذه الطريقة الحدث مباشرةً إلى تقويم المنظِّم، بغض النظر عن إعداداته المتعلقة بإضافة الدعوات.

إضافة ضيوف

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

يتلقّى الضيوف الدعوة من عنوان البريد الإلكتروني للمنظِّم. يتلقّى مستخدمو "تقويم Google" الدعوة في بريدهم الإلكتروني أو في تقويمهم، وذلك استنادًا إلى إعدادات الحدث في "تقويم Google":

  • إذا كان لديهم الإعداد From everyone، تتم إضافة الحدث مباشرةً إلى تقويمهم.
  • إذا كان لديهم الإعداد Only if the sender is known، تتم إضافة الحدث مباشرةً إلى تقويمهم إذا سبق لهم التفاعل مع المنظِّم، أو إذا كان المنظِّم في المؤسسة نفسها، أو إذا كان المنظِّم في جهات اتصال Google. إذا لم يكن المنظِّم معروفًا للمدعوين، يمكنهم النقر على إضافة إلى التقويم أو الرد على الدعوة من خلال النقر على نعم أو ربما في دعوة بالبريد الإلكتروني. بعد ذلك، تتم إضافة الحدث إلى تقويمهم.
  • إذا فعّل المستخدمون الإعداد When I respond in email، لن تتم إضافة أي دعوات إلى تقويمهم إلى أن يردّوا عليها بالنقر على نعم أو ربما أو لا في دعوة بالبريد الإلكتروني.

لمزيد من المعلومات حول كيفية إضافة الدعوات إلى "تقويم Google"، يُرجى الاطّلاع على إدارة الدعوات في "تقويم Google".

عرض الحدث مباشرةً في تقاويم الضيوف

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

ضبط ردّ الضيف على الدعوة

لضبط حالة الردّ على دعوة أحد الضيوف لحضور فعالية، اتّبِع الخطوات التالية:

  1. أنشئ الحدث في تقويم منظّم الحدث وأضِف المشاركين (راجِع إضافة مشاركين).
  2. استخدِم طريقة Events: update لضبط ردّ المدعو على الدعوة على accepted أو tentative. يجب أن يكون لديك إذن بالكتابة في تقويم الضيف. قد يحدث تأخير لفترة وجيزة قبل أن يظهر الحدث في تقويم الضيف. مزيد من المعلومات حول كيفية استخدام طريقة Events: update

تضيف هذه الطريقة الحدث إلى تقويم المشارِك، ولكن قد يظل المشارِك يرى البانر في رسالته الإلكترونية التي تم إرسال الدعوة منها من عنوان إلكتروني غير معروف له سابقًا.

استيراد نسخة من الحدث مباشرةً في تقويم الضيف

لاستيراد نسخة من حدث إلى تقويم أحد الضيوف، اتّبِع الخطوات التالية:

  1. إذا كان لديك إذن بالكتابة في تقويم المنظِّم، استورِد نسخة من الحدث باستخدام الطريقة Events: import.
  2. استورِد نسخة أخرى من الحدث نفسه إلى تقويم الضيف باستخدام Events: import. يجب أن يكون لديك إذن بالكتابة في تقويم الضيف. استخدِم رقم تعريف الحدث نفسه (iCalUID) لنسختَي المنظّم والضيف، وتأكَّد من تحديد المنظّم في نسخة الضيف.

باستخدام هذه الطريقة، يمكن للمدعو رؤية الحدث في تقويمه، ولكن لن يتلقّى رسالة إلكترونية تتضمّن دعوة من "تقويم Google".

إضافة المنظِّم إلى جهات اتصال الضيف

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

  • اطلب من مستخدم "تقويم Google" إضافة المنظّم إلى "جهات اتصال Google".
  • إذا كان الضيوف ينتمون إلى مؤسسة، يمكنك أن تطلب من مشرف المؤسسة إضافة عناوين البريد الإلكتروني إلى جهات اتصال المستخدمين آليًا. اطلب من المشرف تفعيل تفويض على مستوى النطاق، وانتحال هوية المستخدمين واستخدام طريقة People: createContact لإنشاء جهات اتصال لكل مستخدم، وذلك لضمان ظهور الدعوات المستقبلية من عناوين البريد الإلكتروني هذه تلقائيًا في تقاويم المستخدمين.
  • إذا كان بإمكانك الوصول إلى جهات اتصال الضيف، يمكنك أيضًا إضافة عنوان البريد الإلكتروني الخاص بالمنظِّم إلى جهات اتصال الضيف باستخدام طريقة People: createContact.

دعوة المستخدمين عبر البريد الإلكتروني

إذا لم يكن لديك إذن بالكتابة في تقويم المنظِّم، أو إذا كنت لا تريد الكشف عن عنوان البريد الإلكتروني للمنظِّم، استخدِم بروتوكول iCalendar (RFC-5545) لدعوة المستخدمين عبر البريد الإلكتروني باستخدام ملف ‎ .ICS.

إذا كان الضيف يستخدم "تقويم Google" مع تفعيل الإعداد Only if the sender is known ولم يسبق له التفاعل مع العنوان أو تسجيله كعنوان معروف لديه، لن تتم إضافة الدعوة إلى تقويمه إلى أن ينقر على إضافة إلى التقويم أو يردّ على الدعوة إلى الحدث.

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

استخدِم نموذج الرابط التالي:


https://calendar.google.com/calendar/r/eventedit?action=TEMPLATE&dates=20230325T224500Z%2F20230326T001500Z&stz=Europe/Brussels&etz=Europe/Brussels&details=EVENT_DESCRIPTION_HERE&location=EVENT_LOCATION_HERE&text=EVENT_TITLE_HERE

من خلال تعديل المعلومات التالية:

  • تاريخا البدء والانتهاء وأوقاتهما: استخدِم تنسيق ISO 8601. في المثال أعلاه، استبدِل 20230325T224500Z و20230326T001500Z.
  • المناطق الزمنية لوقت البدء ووقت الانتهاء: يجب أن يكون التنسيق على شكل اسم من قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA). ضَع المناطق الزمنية في الحقلَين stz وetz.
  • وصف الحدث: يجب أن يكون مرمّزًا باستخدام ترميز URL.
  • الموقع الجغرافي للفعالية: يجب أن يكون عنوان URL مشفَّرًا.
  • عنوان الحدث: يجب أن يكون عنوان URL مشفّرًا.

مثال

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

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

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

إذا كان النشاط التجاري لا يريد الكشف عن عنوان بريده الإلكتروني، استخدِم عنوان بريد إلكتروني خاصًا بالمستخدم لإرسال الحدث إلى الشخص الذي حجز الموعد من خلال البريد الإلكتروني (دعوة مستخدم من عنوان بريد إلكتروني).

انتشار الحدث

يوضّح المخطّط البياني التالي هذه الديناميكية. أولاً، ينشئ جاك حدثًا في تقويمه الأساسي (وبالتالي يملك نسخة المنظِّم). بعد ذلك، يدعو تقويم مجموعة دروس التشيلو الثانوي و"سوزان" التي لديها إعداد الحدث Only if the sender is known. يتم إنشاء نُسخ من الحدث في التقويم الثانوي لمجموعة دروس Cello، وفي تقويم سوزان إذا كانت تعرف جاك، أو عندما تردّ على الدعوة أو تشير إلى أنّها تعرف جاك. عندما تردّ سوزان، يتم إرسال التغيير في الرد على الدعوة إلى المنظّم، ويتم تعديل نسخة المنظّم لتتضمّن ردّ سوزان. بعد ذلك، يتم نقل هذه التغييرات التي تم إجراؤها على نسخة الحدث الخاصة بالمنظِّم إلى الضيوف الآخرين.

مخطّط يوضّح ديناميكيات الحدث/الضيوف

سمات الأحداث المشترَكة

التقويم الذي يتم فيه إنشاء الحدث هو تقويم المنظِّم. يملك هذا التقويم معلومات الحدث المشترَك، بما في ذلك المعرّف ووقت البدء والانتهاء والملخّص والوصف. عند تعديل هذه المعلومات في تقويم المنظِّم، يتم نقل التغييرات إلى نُسخ المدعوّين.

سمات الأحداث الخاصة

لا تتم مشاركة جميع المعلومات بين جميع نُسخ الحدث. بعض الخصائص خاصة، مثل التذكيرات أو colorId أو الشفافية أو الخاصية extendedProperties.private. يتم التحكّم في هذه الخصائص من خلال إعدادات الضيف وليس من خلال تقويم المنظّم.

يمكن للمدعوين أيضًا تغيير الخصائص المشترَكة للحدث. ومع ذلك، لا تنعكس هذه التغييرات إلا على نسختك الخاصة، وقد تُفقد إذا أجرى المُنظِّم تغييرًا.

التغيير الوحيد الذي يتم نقله من الضيوف إلى المنظّم هو حالة الرد الخاصة بالضيف، ويتم تخزينها في السمة attendees[].responseStatus.