Archive: insert

لنقل رسالة إلكترونية إلى أرشيف مجموعة Google باستخدام تحميل الوسائط.

تتيح هذه الطريقة استخدام معرّف الموارد المنتظم (URI) /upload وتقبل الوسائط التي تم تحميلها بالخصائص التالية:

  • الحد الأقصى لحجم الملف: الحد الأقصى لحجم رسالة البريد هو 25 ميغابايت. ويشمل هذا الحد رؤوس البيانات الوصفية للرسالة ونصوصها وأي مرفقات لها.
  • أنواع MIME المقبولة للوسائط: message/rfc822

الحد الأقصى المسموح به للمشروع في واجهة برمجة التطبيقات Groups Migration API هو 10 طلبات بحث في الثانية (QPS) لكل حساب. الحد الأقصى لطلبات واجهة برمجة التطبيقات في اليوم هو 500,000 طلب. لمزيد من المعلومات عن تنسيق RFC822، اطّلِع على التنسيق العادي لـ RFC822.

الطلب

طلب HTTP

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

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
groupId string عنوان البريد الإلكتروني للمجموعة التي تتم أرشفة الرسالة الإلكترونية التي تم نقلها. يمثّل عنوان البريد الإلكتروني هذا متغيّرًا في مسار عنوان URL للطلب. إذا غيّر مالك المجموعة عنوان البريد الإلكتروني للمجموعة باستخدام "وحدة تحكّم المشرف" أو Directory API، يجب استخدام عنوان البريد الإلكتروني الجديد في المتغيّر groupId.
مَعلمات طلب البحث المطلوبة
uploadType string

نوع طلب التحميل إلى معرّف الموارد المنتظم (URI) /upload مع إحدى القيم التالية:

  • media - تحميل بسيط لتحميل بيانات الوسائط
  • ‫resumable - التحميل القابل للاستئناف الذي يحمِّل الملف بطريقة قابلة للاستئناف باستخدام سلسلة من طلبَين على الأقل

التفويض

يتطلب هذا الطلب الحصول على تفويض بالنطاق التالي:

النطاق
https://www.googleapis.com/auth/apps.groups.migration

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

لا توفّر نص طلب باستخدام هذه الطريقة.

الرد

في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
اسم الموقع القيمة الوصف
kind string نوع مورد الإدراج هذا. القيمة: groupsmigration#groups
responseCode string

رمز حالة استجابة واجهة برمجة التطبيقات لطلب نقل البيانات مصحوبًا برمز حالة HTTP تشمل قيم حالة responseCode ما يلي:

AUTHORIZATION FAILURE - بيانات اعتماد التفويض الخاصة بالمسؤول غير صالحة. يتم عرض رمز حالة HTTP‏ 401.

BACKEND FAILURE - حدثت مشكلة في الخادم أو هو مشغول. يتم عرض رمز الحالة 503 HTTP. باستخدام خوارزمية الوقت المتزايد للانتظار ، انتظِر فترة قصيرة قبل إعادة محاولة إجراء المكالمة التي تعذّر إجراؤها.

INVALID MESSAGE FAILURE — تنسيق الرسالة الإلكترونية غير صالح. إذا تم رفض رسالة لأنّها غير صالحة، سيظهر لك رمز حالة HTTP‏ 400 Bad Request. وتشمل أمثلة التنسيق غير الصالح ما يلي:

  • قد تكون حقول From وTo وDate غير متوفّرة في الرسالة.
  • يحدث خطأ إذا لم يتم إنهاء سطر في الرسالة من خلال سطر جديد بنمط CR+LF (أي "\r\n").
  • رسالة البريد الإلكتروني فارغة.
  • المجموعة المستهدفة لعملية نقل البيانات غير متوفّرة أو هي في وضع "القراءة فقط". لمزيد من المعلومات عن وضع المشاركة للقراءة فقط، يُرجى الاطّلاع على خيارات المشاركة في "مجموعات Google للشركات".

SUCCESS - تم أرشفة الرسالة بنجاح في أرشيف مجموعة الحساب. يتم عرض رمز حالة HTTP‏ 200.

UNSUPPORTED_PARALLEL_OPERATION - لا تسمح واجهة برمجة التطبيقات Groups Migration API بإدراج الرسائل بشكل موازٍ في أرشيف المجموعة نفسه. بالإضافة إلى ذلك، لا تتيح واجهة برمجة التطبيقات Groups Migration API إرسال طلبات مجمّعة. ولكن واجهة برمجة التطبيقات Groups Migration API تتيح الطلبات الموازية لإدراج رسائل البريد الإلكتروني في أرشيفات مجموعات مختلفة. يتم عرض رمز حالة HTTP‏ 400.