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 Transcode.

معلّمات المسار

المعلّمات
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

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