REST Resource: users.messages

المورد: الرسالة

رسالة إلكترونية.

تمثيل JSON 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
الحقول
id

string

المعرّف غير القابل للتغيير للرسالة.
threadId

string

رقم تعريف سلسلة المحادثات التي تنتمي إليها الرسالة. لإضافة رسالة أو مسودة إلى سلسلة محادثات، يجب استيفاء المعايير التالية:

  1. يجب تحديد سمة threadId المطلوبة في Message أو Draft.Message التي تُدخلها مع طلبك.
  2. يجب ضبط العنوانَين References وIn-Reply-To بما يتوافق مع معيار RFC 2822.
  3. يجب أن تتطابق عناوين Subject.
labelIds[]

string

قائمة بأرقام تعريف التصنيفات المطبقة على هذه الرسالة.
snippet

string

جزء قصير من نص الرسالة.
historyId

string

رقم تعريف آخر سجلّ تم تعديله في هذه الرسالة.
internalDate

string (int64 format)

الطابع الزمني لإنشاء الرسالة الداخلية (الحقبة بالمللي ثانية)، الذي يحدد الترتيب في البريد الوارد. بالنسبة إلى البريد الإلكتروني العادي المُستلَم عبر SMTP، يمثل ذلك الوقت الذي قبلت فيه Google الرسالة في البداية، والذي يعد أكثر موثوقية من رأس Date. ومع ذلك، بالنسبة إلى البريد المُرحَّل عبر واجهة برمجة التطبيقات، يمكن ضبطه من خلال البرنامج على أساس العنوان Date.
payload

object (MessagePart)

بنية البريد الإلكتروني الذي تم تحليله في أجزاء الرسالة.
sizeEstimate

integer

الحجم المُقدَّر بالبايت بالرسالة.
raw

string (bytes format)

رسالة البريد الإلكتروني بأكملها في سلسلة RFC 2822 المنسقة وترميز base64url. يُعرَض في messages.get وdrafts.get رد عند تقديم المعلَمة format=RAW.

سلسلة بترميز base64.

جزء الرسالة

جزء من رسالة MIME واحدة.

تمثيل JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
الحقول
partId

string

المعرّف غير القابل للتغيير لجزء الرسالة.
mimeType

string

نوع MIME لجزء الرسالة.
filename

string

اسم ملف المرفق. لا يتوفر إلا إذا كان جزء الرسالة هذا يمثل مرفقًا.
headers[]

object (Header)

قائمة بالرؤوس في جزء الرسالة هذا. بالنسبة إلى جزء الرسائل من المستوى الأعلى، الذي يمثل حمولة الرسالة بالكامل، سيحتوي على عناوين البريد الإلكتروني القياسية لـ RFC 2822 مثل To وFrom وSubject.
body

object (MessagePartBody)

نص جزء الرسالة لهذا الجزء، والذي قد يكون فارغًا لأجزاء رسائل MIME للحاوية.
parts[]

object (MessagePart)

أجزاء رسالة MIME الفرعية لهذا الجزء. وينطبق هذا فقط على أجزاء رسائل MIME للحاوية، مثل multipart/*. هذا الحقل فارغ لأنواع أنواع رسائل MIME غير التابعة للحاوية، مثل text/plain. لمزيد من المعلومات، راجع RFC 1521.
تمثيل JSON 
{
  "name": string,
  "value": string
}
الحقول
name

string

اسم الرأس قبل فاصل :. مثلاً: To
value

string

قيمة الرأس بعد فاصل :. مثلاً: someuser@example.com

الطُرق

batchDelete

 حذف العديد من الرسائل حسب رقم تعريف الرسالة.

batchModify

 لتعديل التصنيفات في الرسائل المحددة.

delete

 يحذف الرسالة المحددة فورًا ونهائيًا.

get

 لعرض الرسالة المحددة.

import

 لاستيراد رسالة إلى صندوق بريد المستخدم هذا فقط، من خلال الفحص والتسليم القياسي للرسائل الإلكترونية المشابهة لاستلام البريد عبر SMTP.

insert

 يدرج رسالة مباشرةً في صندوق بريد المستخدم فقط مثل IMAP APPEND، مما يتجاوز معظم عمليات الفحص والتصنيف.

list

 يدرج الرسائل في صندوق بريد المستخدم.

modify

 لتعديل التصنيفات في الرسالة المحددة.

send

 لإرسال الرسالة المحددة إلى المستلمين في عناوين To وCc وBcc.

trash

 نقل الرسالة المحددة إلى المهملات.

untrash

 إزالة الرسالة المحددة من المهملات.