Прежде чем переносить электронную почту в группы Google с помощью API миграции групп, выполните следующие действия.
- Прежде чем переносить сообщение электронной почты в архив этой группы, убедитесь, что целевая группа существует и адрес электронной почты группы верен. Дополнительные сведения о листинге групп и пользователей см. в API каталога .
- Если отправитель электронного письма имеет тот же домен, что и целевая группа, убедитесь, что отправитель электронного письма существует, прежде чем переносить сообщение электронной почты в архив целевой группы.
- Формат сообщения электронной почты должен соответствовать стандартному определению RFC 822 . Используйте заголовок
Content-type: message/rfc822
. Убедитесь, что поля сообщения электронной почтыTo:
,From:
иDate:
сформированы правильно. Ответ возвращается в формате данных JSON .
Перенос сообщения электронной почты в группы Google
Чтобы перенести сообщение электронной почты в архив группы, отправьте HTTP-запрос POST
, включите заголовок 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
— это идентификатор сообщения в этом примере. Отправителем перенесенного электронного письма является samplegroup@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
В группах Google статус прочитанного/непрочитанного потока сохраняется отдельно для каждого пользователя. При вставке сообщений и цепочек с помощью API миграции групп они обрабатываются так, как если бы они были отправлены пользователем в заголовке From:
Это означает, что они отображаются как непрочитанные для всех пользователей, кроме пользователя, адрес которого указан в заголовке From:
Например, после предыдущего примера запроса JSON сообщение с названием SUBJECT
отображается как прочитанное, если samplesender@example.com
вошел в группы Google, но отображается как непрочитанное для всех остальных пользователей.