قبل نقل رسالة إلكترونية إلى "مجموعات 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"، ولكنها تظهر كغير مقروءة
لجميع المستخدمين الآخرين.