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

إنشاء حدث

إذا كان لديك إذن وصول للكتابة إلى "تقويم 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 ولم يسبق له التفاعل مع العنوان أو تسجيله كما يعرفه، لا تتم إضافة الدعوة إلى التقويم حتى ينقر على أعرف هذا المُرسِل أو يرد على الدعوة.

ملاحظة: يجب عدم استخدام عنوان بريد إلكتروني عام (على سبيل المثال: [e-mail]) لإرسال دعوات، لأنّ أي إساءة استخدام قد تؤثّر في جميع المستخدمين الذين يرسلون دعوات من هذا العنوان. في حال لم تتمكّن من استخدام عنوان البريد الإلكتروني الخاص بالمنظِّم، ننصحك باستخدام عنوان بريد إلكتروني فريد وثابت لكل منظِّم.

توفير رابط للمستخدمين لإضافة الحدث

بدلاً من ذلك، إذا كنت تريد أن تسهّل على مستخدمي "تقويم 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" وفقًا لإعدادات الإشعارات لديهم.

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

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

نشر الحدث

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

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

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

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

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

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

إنّ التغيير الوحيد في الحدث الذي يتم نشره من قِبل الضيوف في المنظِّم هو حالة ردّ الضيف المحفوظة في السمة attendees[].responseStatus.