Method: users.settings.forwardingAddresses.delete
يؤدي هذا الإجراء إلى حذف عنوان إعادة التوجيه المحدّد وإلغاء أي عملية إثبات ملكية قد تكون مطلوبة.
لا تتوفّر هذه الطريقة إلا لعملاء حسابات الخدمة الذين تم تفويضهم بصلاحية على مستوى النطاق.
طلب HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة "me" للإشارة إلى المستخدم الذي تم مصادقة بياناته.
|
forwardingEmail |
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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Deletes a specified forwarding address and any associated verification for service account clients with domain-wide authority."],["Requires a `DELETE` request to the Gmail API with the user ID and forwarding email address in the path."],["Request body should be empty, and a successful deletion results in an empty response body."],["Needs authorization with the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope."]]],["This document outlines the process to delete a forwarding address in Gmail using a `DELETE` HTTP request. The request requires a `userId` and `forwardingEmail` in the URL path. The request body must be empty. Successful deletion yields an empty response body. This action is restricted to service accounts with delegated domain-wide authority. It needs `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for authorization. gRPC Transcoding syntax is utilized in the URL.\n"]]
