Method: users.messages.import

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

طلب HTTP

  • عنوان URI للتحميل، لطلبات تحميل الوسائط:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • معرّف الموارد المنتظم للبيانات الوصفية، للطلبات التي تتضمّن البيانات الوصفية فقط:
    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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.