ترحيل الرسائل الإلكترونية

قبل نقل رسالة إلكترونية إلى "مجموعات Google" باستخدام واجهة برمجة التطبيقات لنقل بيانات المجموعات، يُرجى اتّخاذ الخطوات التالية:

  • تأكَّد من أنّ المجموعة المستهدَفة متوفّرة وأنّ البريد الإلكتروني للمجموعة دقيق قبل نقل رسالة إلكترونية إلى أرشيف تلك المجموعة. لمزيد من المعلومات حول إدراج المجموعات والمستخدمين، يُرجى الاطّلاع على Directory API.
  • إذا كان نطاق مُرسِل الرسالة الإلكترونية هو نفسه نطاق المجموعة المستهدَفة، تأكَّد من أنّ مُرسِل الرسالة الإلكترونية موجود قبل نقل الرسالة الإلكترونية إلى أرشيف المجموعة المستهدَفة.
  • يجب أن يكون تنسيق الرسالة الإلكترونية متوافقًا مع التعريف المعياري RFC 822. استخدِم العنوان Content-type: message/rfc822. تأكَّد من أنّ حقول To: وFrom: وDate: في رسالة البريد الإلكتروني منسَّقة بشكل سليم. يتم عرض الرد بتنسيق البيانات JSON.

نقل رسالة إلكترونية إلى "مجموعات Google"

لنقل رسالة إلكترونية إلى أرشيف مجموعة، أرسِل طلب HTTP POST، وأدرِج العنوان Authorization، واستبدِل GROUP_EMAIL_ADDRESS بعنوان البريد الإلكتروني للمجموعة التي تريد إرسال الرسائل إليها:

POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media

مثال على الطلب

ينقل هذا المثال رسائل البريد الإلكتروني إلى الأرشيف samplegroup@googlegroups.com. يقتصر حجم Content-Length على 25 ميغابايت، ويشمل ذلك البيانات الوصفية ونص الرسالة وأي مرفقات:

POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer AUTH_TOKEN

METADATA_BODY

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫BYTES: عدد وحدات البايت في الرسالة الإلكترونية
  • AUTH_TOKEN: عنوان Authorization
  • ‫METADATA_BODY: البيانات الوصفية للرسالة الإلكترونية ونصها وأي مرفقات

في ما يلي مثال على رسالة إلكترونية بتنسيق نص RFC 822 تم نقلها إلى أرشيف samplegroup@googlegroups.com. يمثّل NNNN@mail.samplegroup.com رقم تعريف الرسالة في هذا المثال. مرسِل الرسالة الإلكترونية التي تم نقلها هو samplesender@example.com، وتم نقل الرسالة إلى أرشيف المجموعة samplegroup@googlegroups.com:

    Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT)
    Message-ID: <NNNN@mail.samplegroup.com>
    Date: Mon, 16 Jul 2007 10:12:26 -0700
    From: samplesender@example.com
    To: samplegroup@googlegroups.com
    Subject: SUBJECT
    MIME-Version: 1.0
    Content-Type: text/plain; charset=ISO-8859-1; format=flowed
    Content-Transfer-Encoding: 7bit
    Content-Disposition: inline
    Delivered-To: samplegroup@samplegroup.com

    This is the body of the migrated email message.

تعرض الاستجابة الناجحة رمز حالة HTTP 200 وحالة نقل البيانات. لمزيد من المعلومات عن قيم responseCode، يُرجى الاطّلاع على مرجع واجهة برمجة تطبيقات "نقل بيانات المجموعات".

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

عرض الرسائل المستورَدة على واجهة "مجموعات Google"

في &quot;مجموعات Google&quot;، يتم تخزين حالة قراءة سلاسل المحادثات أو عدم قراءتها بشكل منفصل لكل مستخدم. عند إدراج الرسائل وسلاسل المحادثات باستخدام واجهة برمجة التطبيقات Groups Migration API، يتم التعامل معها كما لو أنّ المستخدم أرسلها من خلال العنوان From:. وهذا يعني أنّها تظهر كرسائل غير مقروءة لجميع المستخدمين، باستثناء المستخدم الذي يظهر عنوانه في رأس From:. على سبيل المثال، بعد مثال طلب JSON السابق، تظهر الرسالة بعنوان SUBJECT كمقروءة إذا كان samplesender@example.com مسجّلاً الدخول إلى &quot;مجموعات Google&quot;، ولكنها تظهر كغير مقروءة لجميع المستخدمين الآخرين.