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

قبل نقل رسالة إلكترونية إلى "مجموعات Google" باستخدام واجهة برمجة تطبيقات نقل بيانات "مجموعات 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"

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