انتقال ایمیل ها

قبل از انتقال ایمیل به گروه‌های گوگل با استفاده از Groups Migration API، موارد زیر را انجام دهید:

  • قبل از انتقال یک پیام ایمیل به بایگانی گروه، از وجود گروه هدف و صحت ایمیل آن گروه اطمینان حاصل کنید. برای اطلاعات بیشتر در مورد فهرست کردن گروه‌ها و کاربران، به API دایرکتوری مراجعه کنید.
  • اگر دامنه فرستنده ایمیل با دامنه گروه هدف یکسان است، قبل از انتقال پیام ایمیل به بایگانی گروه هدف، از وجود فرستنده ایمیل اطمینان حاصل کنید.
  • قالب پیام ایمیل باید مطابق با تعریف استاندارد RFC 822 باشد. از هدر Content-type: message/rfc822 استفاده کنید. تأیید کنید که فیلدهای To: From: و Date: پیام ایمیل به درستی تشکیل شده‌اند. پاسخ در قالب داده JSON برگردانده می‌شود.

انتقال یک پیام ایمیل به گروه‌های گوگل

برای انتقال یک پیام ایمیل به آرشیو یک گروه، یک درخواست 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 به ۲۵ مگابایت محدود شده است که شامل ابرداده، بدنه و هرگونه پیوست پیام می‌شود:

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 ، به مرجع Groups Migration API مراجعه کنید.

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

پیام‌های وارد شده را در رابط کاربری گروه‌های گوگل مشاهده کنید

در گروه‌های گوگل، وضعیت خوانده شدن یا خوانده نشدن رشته‌ها برای هر کاربر به طور جداگانه ذخیره می‌شود. هنگام درج پیام‌ها و رشته‌ها با استفاده از API مهاجرت گروه‌ها، با آنها طوری رفتار می‌شود که گویی توسط کاربر در سربرگ From: ارسال شده‌اند. این بدان معناست که آنها برای همه کاربران، به جز کاربری که آدرس آن در سربرگ From: است، به عنوان خوانده نشده ظاهر می‌شوند. به عنوان مثال، پس از مثال درخواست JSON قبلی، پیامی با عنوان SUBJECT در صورتی که samplesender@example.com به گروه‌های گوگل وارد شده باشد، به عنوان خوانده شده ظاهر می‌شود، اما برای همه کاربران دیگر به عنوان خوانده نشده ظاهر می‌شود.