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