ترحّل رسالة إلكترونية إلى أرشيف مجموعة 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)
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
---|
https://www.googleapis.com/auth/apps.groups.migration |
وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا توفِّر نص طلب بهذه الطريقة.
الإجابة
في حال نجاحها، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{ "kind": "groupsmigration#groups", "responseCode": string }
اسم الموقع | القيمة | الوصف |
---|---|---|
kind |
string |
نوع مورد الإدراج هو. القيمة: groupsmigration#groups |
responseCode |
string |
رمز حالة لاستجابة واجهة برمجة التطبيقات لطلب نقل بيانات مصاحب لرمز حالة HTTP.
تشمل قيم الحالة
|