Method: users.messages.send
يُرسل الرسالة المحدّدة إلى المستلِمين في عناوين To
وCc
وBcc
. مثلاً الاستخدام، يمكنك الاطّلاع على إرسال البريد الإلكتروني.
طلب HTTP
- معرّف الموارد المنتظم (URI) للتحميل، لطلبات تحميل الوسائط:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/send
- معرّف الموارد المنتظم (URI) للبيانات الوصفية، لطلبات البيانات الوصفية فقط:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/send
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.
|
نص الطلب
يحتوي نص الطلب على مثال Message
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Message
.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
https://www.googleapis.com/auth/gmail.send
لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This API endpoint allows sending emails to specified recipients using the `To`, `Cc`, and `Bcc` headers, with usage examples available in the Sending email guide."],["It accepts HTTP POST requests to either upload media or send metadata, utilizing gRPC Transcoding syntax and requiring a `userId` path parameter representing the sender's email address."],["The request body should contain a `Message` object defining the email content, and a successful response will return the sent `Message` object."],["Authorization is required using one of the listed OAuth scopes, including `https://mail.google.com/` or those granting Gmail modification, composing, or sending permissions."]]],[]]