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

إنشاء حدث

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

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

إضافة ضيوف

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

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

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

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

لا تضبط رد الضيف باستخدام سمة attendees[].responseStatus على أي خيار بخلاف needsAction. لا تؤدي التعبئة التلقائية لردّ الضيف إلى إضافة الحدث تلقائيًا إلى تقاويم المستخدمين.

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

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

إعداد الرد على دعوة الضيف

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

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

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

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

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

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

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

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

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

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

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

إذا لم يكن لديك إذن الوصول للكتابة إلى "تقويم Google" الخاص بالمنظِّم أو لا تريد عرض عنوان البريد الإلكتروني للمنظِّم، استخدِم بروتوكول iتقويم (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. يتم إنشاء نسخ الحاضرين في التقويم الثانوي لمجموعة دروس التشيلو، وفي تقويم سوزان إذا كانت تعرف جاك، وبخلاف ذلك، عندما ترد على الدعوة أو تشير إلى أنها تعرف جاك. عندما تستجيب سوزان، يتم نشر تغيير الرد على الدعوة مرة أخرى إلى المنظم، مع تحديث نسخة المنظم برد سوزان. هذه التغييرات التي تم إجراؤها على نسخة المنظّم من الحدث ثم يتم نشرها على الضيوف الآخرين.

خصائص الأحداث المشتركة

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

خصائص الأحداث الخاصة

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

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

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