Class EventGuest
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ضيفالفعالية
يمثّل مدعوًا إلى حدث.
الطرق المتوقّفة
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getStatus() | String | الحصول على حالة الضيف للحدث |
مستندات تفصيلية
getAdditionalGuests()
تحصل على عدد الأشخاص الإضافيِين الذين قال هذا الضيف إنّهم سيحضرون.
الإرجاع
Integer: عدد الأشخاص الإضافيين الذين قال هذا الضيف إنّهم سيحضرون
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEmail()
تحصل على عنوان البريد الإلكتروني للضيف.
الإرجاع
String: عنوان البريد الإلكتروني للضيف
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getGuestStatus()
الحصول على حالة المدعو للحدث
الإرجاع
GuestStatus: حالة هذا الضيف
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getName()
الحصول على اسم الضيف إذا لم يكن اسم الضيف متاحًا، تعرض هذه الطريقة
عنوان البريد الإلكتروني للضيف.
الإرجاع
String: اسم الضيف أو عنوان بريده الإلكتروني إذا لم يكن الاسم متاحًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
الطرق المتوقّفة
getStatus()
تمّ إيقاف هذا العمود نهائيًا. هذه الدالة متوقّفة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على حالة المدعو للحدث
الإرجاع
String: حالة هذا الضيف
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eEventGuest\u003c/code\u003e represents an event guest and provides methods to access their information.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve guest details such as the number of additional guests, email address, status, and name using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eAll methods require authorization with specific scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/calendar\u003c/code\u003e or \u003ccode\u003ehttps://www.google.com/calendar/feeds\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetStatus()\u003c/code\u003e method is deprecated and \u003ccode\u003egetGuestStatus()\u003c/code\u003e should be used instead to get the guest's status.\u003c/p\u003e\n"]]],[],null,["# Class EventGuest\n\nEventGuest\n\nRepresents a guest of an event. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------|-------------------------------------------------------------|------------------------------------------------------------------------------|\n| [getAdditionalGuests()](#getAdditionalGuests()) | `Integer` | Gets the number of additional people that this guest has said are attending. |\n| [getEmail()](#getEmail()) | `String` | Gets the email address of the guest. |\n| [getGuestStatus()](#getGuestStatus()) | [GuestStatus](/apps-script/reference/calendar/guest-status) | Gets the status of the guest for the event. |\n| [getName()](#getName()) | `String` | Gets the name of the guest. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|-----------------------------|-------------|---------------------------------------------|\n| [getStatus()](#getStatus()) | `String` | Gets the status of the guest for the event. |\n\nDetailed documentation\n----------------------\n\n### `get``Additional``Guests()`\n\nGets the number of additional people that this guest has said are attending.\n\n#### Return\n\n\n`Integer` --- the number of additional people this guest has said are attending\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes) or appropriate scopes from the [related REST API](/identity/protocols/googlescopes):\n\n- `https://www.googleapis.com/auth/calendar`\n- `https://www.googleapis.com/auth/calendar.readonly`\n- `https://www.google.com/calendar/feeds`\n\n*** ** * ** ***\n\n### `get``Email()`\n\nGets the email address of the guest.\n\n#### Return\n\n\n`String` --- the guest's email address\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes) or appropriate scopes from the [related REST API](/identity/protocols/googlescopes):\n\n- `https://www.googleapis.com/auth/calendar`\n- `https://www.googleapis.com/auth/calendar.readonly`\n- `https://www.google.com/calendar/feeds`\n\n*** ** * ** ***\n\n### `get``Guest``Status()`\n\nGets the status of the guest for the event.\n\n#### Return\n\n\n[GuestStatus](/apps-script/reference/calendar/guest-status) --- the status of this guest\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes) or appropriate scopes from the [related REST API](/identity/protocols/googlescopes):\n\n- `https://www.googleapis.com/auth/calendar`\n- `https://www.googleapis.com/auth/calendar.readonly`\n- `https://www.google.com/calendar/feeds`\n\n*** ** * ** ***\n\n### `get``Name()`\n\nGets the name of the guest. If the name of the guest is not available, this method returns the\nguest's email address.\n\n#### Return\n\n\n`String` --- the guest's name, or the guest's email address if the name is not available\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes) or appropriate scopes from the [related REST API](/identity/protocols/googlescopes):\n\n- `https://www.googleapis.com/auth/calendar`\n- `https://www.googleapis.com/auth/calendar.readonly`\n- `https://www.google.com/calendar/feeds`\n\nDeprecated methods\n------------------\n\n### `get``Status()`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nGets the status of the guest for the event.\n\n#### Return\n\n\n`String` --- the status of this guest\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes) or appropriate scopes from the [related REST API](/identity/protocols/googlescopes):\n\n- `https://www.googleapis.com/auth/calendar`\n- `https://www.googleapis.com/auth/calendar.readonly`\n- `https://www.google.com/calendar/feeds`"]]
