Method: users.messages.import

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

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    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

وضع علامة على الرسالة الإلكترونية كرسالة محذوفة نهائيًا (وليس في "المهملات") وجعلها مرئية فقط في 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.