Method: users.settings.delegates.delete
تزيل هذه العملية المستخدم المفوَّض المحدّد (الذي يمكن أن يكون لديه أي حالة إثبات ملكية)، وتُلغي أي عملية إثبات ملكية قد تكون مطلوبة لاستخدامه.
يُرجى العِلم أنّه يجب الإشارة إلى المستخدم المفوَّض من خلال عنوان بريده الإلكتروني الأساسي، وليس من خلال عنوان بريد إلكتروني بديل.
لا تتوفّر هذه الطريقة إلا لعملاء حسابات الخدمة الذين تم تفويضهم بصلاحية على مستوى النطاق.
طلب HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة "me" للإشارة إلى المستخدم الذي تم مصادقة بياناته.
|
delegateEmail |
string
عنوان البريد الإلكتروني للمستخدم المطلوب إزالته كمفوّض
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة هو عنصر JSON فارغ.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/gmail.settings.sharing
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Removes a delegate user identified by their primary email address, revoking any associated verification."],["This action is restricted to service account clients with delegated domain-wide authority."],["The request must specify the user and delegate's email addresses as path parameters."],["A successful operation results in an empty response body, indicating the delegate was removed."],["This functionality requires the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for authorization."]]],["This outlines how to remove a delegate from a user's Gmail account. A `DELETE` HTTP request is sent to a specific URL, including the user's email (`userId`) and the delegate's email (`delegateEmail`) as path parameters. The request body must be empty. A successful removal returns an empty response body. This operation is only available to service accounts with domain-wide authority, and it requires the `gmail.settings.sharing` authorization scope. Only primary email address can be used for the delegate.\n"]]
