Archive: insert

با استفاده از آپلود رسانه، یک پیام ایمیل را به بایگانی گروه Google منتقل می کند.

این روش از یک URI /upload پشتیبانی می کند و رسانه های آپلود شده با ویژگی های زیر را می پذیرد:

  • حداکثر اندازه فایل: حداکثر اندازه پیام نامه 25 مگابایت است. این محدودیت شامل سرصفحه‌های فراداده، متن و هر پیوست پیام است.
  • انواع MIME رسانه پذیرفته شده: message/rfc822

محدودیت پروژه برای Groups Migration API 10 پرس و جو در ثانیه (QPS) در هر حساب است. حداکثر درخواست API در روز 500000 است. برای اطلاعات بیشتر در مورد قالب RFC822، فرمت استاندارد RFC822 را ببینید.

درخواست کنید

درخواست HTTP 

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

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مسیر
groupId string آدرس ایمیل گروهی که ایمیل منتقل شده در آن بایگانی شده است. این آدرس ایمیل متغیری در مسیر URL درخواست است. اگر مالک گروه آدرس ایمیل گروه را با استفاده از Admin console یا Directory API تغییر دهد، باید از آدرس ایمیل جدید در متغیر groupId استفاده کنید.
پارامترهای پرس و جو مورد نیاز
uploadType string

نوع درخواست آپلود به /upload URI با یکی از مقادیر زیر:

  • media - آپلود ساده که داده های رسانه را بارگذاری می کند.
  • resumable - آپلود Resumable که فایل را به روشی قابل ازسرگیری با استفاده از یک سری حداقل دو درخواست آپلود می کند.

مجوز

این درخواست به مجوز با محدوده زیر نیاز دارد:

دامنه
https://www.googleapis.com/auth/apps.groups.migration

برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

پاسخ

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند: 

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
نام ملک ارزش توضیحات
kind string نوع منبع درج این است. ارزش: groupsmigration#groups
responseCode string

کد وضعیت پاسخ API برای درخواست انتقال همراه با کد وضعیت 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 Groups for Business مراجعه کنید.

SUCCESS - نامه با موفقیت در بایگانی گروه حساب بایگانی شد. یک کد وضعیت HTTP 200 برگردانده می شود.

UNSUPPORTED_PARALLEL_OPERATION - API مهاجرت گروه ها از درج پیام موازی در آرشیو گروهی مشابه پشتیبانی نمی کند. همچنین، Groups Migration API از درخواست‌های دسته‌ای پشتیبانی نمی‌کند. اما Groups Migration API از درخواست های موازی برای درج ایمیل در آرشیوهای گروهی مختلف پشتیبانی می کند. کد وضعیت 400 HTTP برگردانده می شود.