Method: users.messages.import

لاستيراد رسالة إلى صندوق بريد هذا المستخدم فقط، مع فحص التسليم العادي للبريد الإلكتروني وتصنيفه مثل الاستلام عبر SMTP. لا تُجري هذه الطريقة عمليات فحص نظام التعرّف على هوية المرسل (SPF)، لذا قد لا تعمل مع بعض الرسائل غير المرغوب فيها، مثل تلك الرسائل التي تحاول انتحال النطاق. ولا تؤدي هذه الطريقة إلى إرسال رسالة.

طلب HTTP

  • معرّف الموارد المنتظم (URI) للتحميل، لطلبات تحميل الوسائط:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، لطلبات البيانات الوصفية فقط:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
userId

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.

معلمات طلب البحث

المَعلمات
internalDateSource

enum (InternalDateSource)

مصدر التاريخ الداخلي للرسالة في Gmail.
neverMarkSpam

boolean

تجاهَل قرار مصنِّف الرسائل غير المرغوب فيها في Gmail ولا تضع علامة على هذه الرسالة الإلكترونية مطلقًا على أنها رسائل غير مرغوب فيها في صندوق البريد.
processForCalendar

boolean

يمكنك معالجة دعوات التقويم في البريد الإلكتروني وإضافة أي اجتماعات تم استخراجها إلى "تقويم Google" لهذا المستخدم.
deleted

boolean

ضَع علامة على الرسالة الإلكترونية على أنّها محذوفة نهائيًا (وليس TRASH) ولا تظهر إلا في Google Vault لمشرف Vault. تُستخدم فقط لحسابات Google Workspace.

نص الطلب

يحتوي نص الطلب على مثال Message.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Message.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

لمزيد من المعلومات، راجِع دليل التفويض.