تنشئ هذه الطريقة عنوان إعادة توجيه. إذا كان إثبات الملكية مطلوبًا، سيتم إرسال رسالة إلى المستلِم وسيتم ضبط حالة التحقّق من المرجع على pending، وإلا سيتم إنشاء المرجع مع ضبط حالة التحقّق على accepted.
لا تتوفّر هذه الطريقة إلا لعملاء حسابات الخدمة الذين تم تفويضهم على مستوى النطاق.
طلب HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
userId |
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة "me" للإشارة إلى المستخدم الذي تمّت مصادقته. |
نص الطلب
يحتوي نص الطلب على مثال ForwardingAddress.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا ForwardingAddress.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/gmail.settings.sharing
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.