Archive: insert

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

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

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

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

الطلب

طلب HTTP

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

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
groupId string عنوان البريد الإلكتروني للمجموعة حيث يتم وضع الرسائل الإلكترونية المنقولة في الأرشيف. عنوان البريد الإلكتروني هذا هو متغيّر في مسار عنوان URL للطلب. إذا غيّر مالك مجموعة عنوان البريد الإلكتروني للمجموعة إما باستخدام وحدة تحكّم المشرف أو واجهة برمجة تطبيقات الدليل، عليك استخدام عنوان البريد الإلكتروني الجديد في المتغيّر 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 — هناك مشكلة في الخادم أو مشغول. يتم عرض رمز حالة HTTP 503. وباستخدام خوارزمية التراجع الأُسيّ، انتظِر حتى بعد فوات الأوان بعض الشيء قبل إعادة محاولة إجراء المكالمة التي تعذّر تنفيذها.

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

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

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

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