Управление миграцией электронной почты

Управление миграциями

API Groups Migration управляет переносом общих сообщений электронной почты из общедоступных папок и списков рассылки в архив обсуждений группы. Функция загрузки мультимедиа позволяет API хранить групповые сообщения электронной почты в облаке и делать их доступными для сервера. При управлении миграцией важно учитывать:

  • API предназначен для переноса общих электронных писем в группы Google. Информацию о переносе или синхронизации электронной почты из определенного пользовательского приложения в Gmail см. в разделе API Gmail .
  • Все участники группы, имеющие доступ к архиву группы, могут просматривать перенесенные сообщения, но электронные письма не доставляются отдельным членам группы. Конкретную информацию о переносе пользовательских приложений в Google Workspace см. в матрице продуктов инструментов переноса Google Workspace .
  • В целях миграции API возвращает ошибку, если группа приостановлена, не создана или имеет доступ только для чтения. Дополнительные сведения о том, как определить и исправить их, см. в разделе API каталогов , API настроек групп и Способы создания групп .
  • Перед переносом сообщения электронной почты:
    • Прежде чем переносить сообщение электронной почты в архив этой группы, убедитесь, что целевая группа существует и адрес электронной почты группы верен.
    • Если отправитель электронной почты имеет тот же домен, что и целевая группа, убедитесь, что отправитель электронной почты существует, прежде чем переносить сообщение электронной почты в архив целевой группы.
    Дополнительные сведения о перечислении групп и пользователей см. в Directory API .
  • Перед миграцией формат сообщения электронной почты должен соответствовать стандартному определению RFC 822 . Используйте заголовок Content-type: message/rfc822 . Убедитесь, что поля сообщения электронной почты « To: », « From: » и « Date: » сформированы правильно. Ответ возвращается в формате данных JSON .
  • API поддерживает параллельные запросы на вставку электронной почты в разные групповые архивы. Но API не поддерживает параллельную вставку сообщений в один и тот же групповой архив. Максимальное количество запросов в секунду для проекта API — 10, а максимальное количество запросов на миграцию в день — 500 000.
  • API не поддерживает политики размещения данных, требующие хранения данных в определенных географических или политических границах по договорным причинам. Не используйте API, если для вашей учетной записи требуется местоположение данных.

Перенос сообщения электронной почты в группы Google

Чтобы перенести сообщение электронной почты в архив группы, используйте следующий HTTP-запрос POST . Включите заголовок Authorization , как описано в разделе Авторизация запросов . group email address — это запрошенный пункт назначения перенесенного сообщения электронной почты.

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

JSON-запрос

В этом примере сообщения электронной почты переносятся в архив 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: number of bytes in the email
Authorization: Bearer Auth token

The email's meta data, body, and any attachments

Это пример сообщения электронной почты в текстовом формате 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.

JSON-ответ

Успешный ответ возвращает код состояния HTTP 200 . Вместе с кодом состояния ответ возвращает статус миграции. Дополнительные сведения о значениях responseCode см. в справочнике по API .

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

Просмотр импортированных сообщений в интерфейсе Google Groups

В группах Google статус прочитанных/непрочитанных тредов сохраняется отдельно для каждого пользователя. При вставке сообщений и потоков с помощью этого API они обрабатываются так, как если бы они были отправлены пользователем в заголовке From: Это означает, что они будут отображаться как непрочитанные для всех пользователей, кроме пользователя, чей адрес указан в заголовке From: Например, после приведенного выше запроса JSON сообщение под названием «SUBJECT» будет отображаться как прочитанное, если samplesender@example.com вошел в группы Google, но будет отображаться как непрочитанное для всех остальных пользователей.