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

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

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

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

لنقل رسالة إلكترونية إلى أرشيف مجموعة، أرسِل طلبًا عبر بروتوكول POST HTTP، وأدرِج العنوان 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"

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