قبل از انتقال ایمیل به Google Groups با استفاده از Groups Migration API، موارد زیر را انجام دهید
- قبل از انتقال یک پیام ایمیل به آرشیو آن گروه، تأیید کنید که گروه هدف وجود دارد و ایمیل گروه دقیق است. برای اطلاعات بیشتر درباره فهرست کردن گروهها و کاربران، به Directory API مراجعه کنید.
- اگر فرستنده ایمیل دارای دامنه مشابه با گروه هدف است، قبل از انتقال پیام ایمیل به بایگانی گروه هدف، وجود فرستنده ایمیل را تأیید کنید.
- قالب پیام ایمیل باید در تعریف استاندارد RFC 822 باشد. از هدر
Content-type: message/rfc822استفاده کنید. تأیید کنید که فیلدهای پیام ایمیلTo:،From:وDate:به درستی تشکیل شده اند. پاسخ در قالب داده JSON برگردانده می شود.
انتقال یک پیام ایمیل به Google Groups
برای انتقال یک پیام ایمیل به بایگانی یک گروه، یک درخواست POST HTTP ارسال کنید، سرصفحه 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 ، به مرجع API مهاجرت گروه ها مراجعه کنید.
{
"kind": "groupsMigration#groups",
"responseCode": "SUCCESS",
}پیام های وارد شده را در رابط Google Groups مشاهده کنید
در Google Groups، وضعیت خوانده شده/خوانده نشده رشته ها به طور جداگانه برای هر کاربر ذخیره می شود. هنگام درج پیامها و رشتهها با استفاده از Groups Migration API، با آنها به گونهای رفتار میشود که گویی توسط کاربر در هدر From: ارسال شدهاند. این بدان معنی است که برای همه کاربران به عنوان خوانده نشده ظاهر می شوند، به جز برای کاربری که آدرس آن در هدر From: است. به عنوان مثال، پس از نمونه درخواست قبلی JSON، اگر samplesender@example.com به Google Groups وارد شود، پیام با عنوان SUBJECT به عنوان خوانده شده ظاهر می شود، اما برای همه کاربران دیگر به عنوان خوانده نشده ظاهر می شود.