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

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

  • تأكَّد من توفُّر المجموعة المستهدفة ومن دقة البريد الإلكتروني للمجموعة قبل نقل رسالة إلكترونية إلى أرشيف تلك المجموعة. لمزيد من المعلومات حول مجموعات البيانات والمستخدمين، يُرجى الاطّلاع على الـ واجهة برمجة التطبيقات للدليل:
  • إذا كان مُرسِل الرسالة الإلكترونية ضمن النطاق نفسه الذي تضمه المجموعة المستهدفة، تأكَّد من توفُّر مُرسِل الرسالة الإلكترونية قبل نقل الرسالة الإلكترونية إلى أرشيف المجموعة المستهدفة.
  • يجب أن يكون تنسيق الرسالة الإلكترونية بالتنسيق التالي: تعريف 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 هو لمعرف الرسالة الخاص بالمثال. مُرسِل البريد الإلكتروني الذي تم نقله هو sampleender@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.

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

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

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

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