اختيار نطاقات Gmail API

يتضمّن هذا المستند معلومات حول المصادقة والتفويض الخاصة بواجهة Gmail API. قبل قراءة هذا المستند، احرص على قراءة معلومات المصادقة والتفويض العامة في Google Workspace على مزيد من المعلومات عن المصادقة والتفويض.

إعداد OAuth 2.0 للتفويض

ضبط شاشة موافقة بروتوكول OAuth واختيار النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك كي تتمكّن من نشره لاحقًا

نطاقات Gmail API

لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات التفويض والإفصاح عنها. نطاق التفويض هو سلسلة URI لبروتوكول OAuth 2.0 تحتوي على اسم تطبيق Google Workspace ونوع البيانات التي يمكنه الوصول إليها ومستوى الوصول. النطاقات هي طلبات تطبيقك للعمل مع بيانات Google Workspace، بما في ذلك بيانات حسابات المستخدمين على Google.

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

تتيح Gmail API النطاقات التالية:

رمز النطاق الوصف الاستخدام
https://www.googleapis.com/auth/gmail.addons.current.action.compose إدارة المسودات وإرسال رسائل البريد الإلكتروني عند التفاعل مع الإضافة غير حساسة
https://www.googleapis.com/auth/gmail.addons.current.message.action عرض رسائل البريد الإلكتروني عند التفاعل مع الإضافة غير حساسة
https://www.googleapis.com/auth/gmail.addons.current.message.metadata عرض البيانات الوصفية للرسالة الإلكترونية عند تشغيل الإضافة الفئات الحساسة
https://www.googleapis.com/auth/gmail.addons.current.message.readonly عرض رسائل البريد الإلكتروني عندما تكون الإضافة مشغّلة الفئات الحساسة
https://www.googleapis.com/auth/gmail.labels إنشاء التصنيفات وقراءتها وتعديلها وحذفها فقط غير حساسة
https://www.googleapis.com/auth/gmail.send إرسال الرسائل فقط ليس لديك امتيازات القراءة أو التعديل في صندوق البريد. الفئات الحساسة
https://www.googleapis.com/auth/gmail.readonly قراءة جميع الموارد والبيانات الوصفية الخاصة بها، بدون عمليات كتابة محظور
https://www.googleapis.com/auth/gmail.compose إنشاء المسودات وقراءتها وتعديلها وحذفها إرسال الرسائل والمسودات محظور
https://www.googleapis.com/auth/gmail.insert إدراج الرسائل واستيرادها فقط محظور
https://www.googleapis.com/auth/gmail.modify جميع عمليات القراءة والكتابة باستثناء الحذف الفوري والدائم لسلاسل المحادثات والرسائل بدون المرور بالمهملات محظور
https://www.googleapis.com/auth/gmail.metadata قراءة البيانات الوصفية للمراجع، بما في ذلك التصنيفات وسجلات السجلّ وعناوين الرسائل الإلكترونية، ولكن ليس نص الرسالة أو المرفقات محظور
https://www.googleapis.com/auth/gmail.settings.basic إدارة إعدادات البريد الأساسية محظور
https://www.googleapis.com/auth/gmail.settings.sharing إدارة إعدادات البريد الحساسة، بما في ذلك قواعد إعادة التوجيه والأسماء المستعارة

ملاحظة:تقتصر العمليات التي يغطيها هذا النطاق على الاستخدام الإداري فقط. ولا تتوفّر إلا لعملاء Google Workspace الذين يستخدمون حساب خدمة مع تفويض على مستوى النطاق. 		محظور
https://mail.google.com/ إذن الوصول الكامل إلى صناديق البريد في الحساب، بما في ذلك الحذف النهائي للسلاسل والرسائل، ويجب طلب هذا النطاق فقط إذا كان تطبيقك يحتاج إلى حذف السلاسل والرسائل نهائيًا على الفور، مع تجاهل المهملات، ويمكن تنفيذ جميع الإجراءات الأخرى باستخدام نطاقات أقل تساهلاً. محظور

يشير عمود "الاستخدام" في الجدول أعلاه إلى حساسية كل نطاق، وفقًا للتعريفات التالية:

يمكنك الاطّلاع على معلومات إضافية تحكم استخدامك لواجهات برمجة تطبيقات Gmail والوصول إليها عند طلب الوصول إلى بيانات المستخدمين في سياسة بيانات المستخدمين والمطوّرين في خدمات Gmail API.

إذا كان تطبيقك يتطلّب الوصول إلى أي واجهات Google APIs أخرى، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات حول نطاقات Google API، يُرجى الاطّلاع على استخدام بروتوكول OAuth 2.0 للدخول إلى Google APIs.

التحقّق من OAuth

قد يتطلّب استخدام نطاقات OAuth حساسة معيّنة أن يخضع تطبيقك لعملية التحقّق من OAuth التي تجريها Google. اطّلِع على الأسئلة الشائعة حول عملية التحقّق من OAuth لتحديد الحالات التي يجب فيها التحقّق من تطبيقك ونوع عملية التحقّق المطلوبة. يُرجى الاطّلاع أيضًا على خدمات Google API: سياسة بيانات المستخدمين.