Archive: insert

Переносит сообщение электронной почты в архив группы Google с помощью загрузки мультимедиа.

Этот метод поддерживает URI /upload и принимает загруженные носители со следующими характеристиками:

  • Максимальный размер файла: максимальный размер почтового сообщения составляет 25 МБ. Это ограничение включает заголовки метаданных сообщения, тело и любые вложения.
  • Допустимые типы MIME мультимедиа: message/rfc822

Ограничение проекта Google Groups Migration API составляет 10 запросов в секунду (QPS) на аккаунт. Максимальное количество запросов API в день — 500 000.
Дополнительные сведения о формате RFC822 см. в стандартном формате RFC822 , а о переносе загрузки мультимедиа — в Руководстве разработчика .

Запрос

HTTP-запрос

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

Параметры

Имя параметра Ценность Описание
Параметры пути
groupId string Адрес электронной почты группы, в которой хранится перенесенная электронная почта. Этот адрес электронной почты является переменной в URL-адресе запроса.
Если владелец группы меняет адрес электронной почты группы с помощью консоли администратора или Directory API, вы должны использовать новый адрес электронной почты в переменной groupId .
Обязательные параметры запроса
uploadType string Тип запроса на загрузку в URI /upload . Допустимые значения:

Авторизация

Этот запрос требует авторизации со следующей областью действия:

Сфера
https://www.googleapis.com/auth/apps.groups.migration

Дополнительные сведения см. на странице аутентификации и авторизации .

Тело запроса

Не указывайте тело запроса с этим методом.

Ответ

В случае успеха этот метод возвращает тело ответа со следующей структурой:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Имя свойства Ценность Описание Заметки
kind string Это тип ресурса вставки. Значение: groupsmigration#groups
responseCode string

Код состояния ответа API для запроса на перенос, сопровождаемый кодом состояния HTTP .
Значения состояния responseCode включают:

AUTHORIZATION FAILURE — учетные данные авторизации администратора недействительны. Возвращается код состояния HTTP 401 .

BACKEND FAILURE — На сервере возникла проблема или он занят. Возвращается код состояния HTTP 503 . Используя алгоритм экспоненциальной отсрочки , дождитесь небольшой задержки перед повторной попыткой неудачного вызова.

INVALID MESSAGE FAILURE — сообщение электронной почты имеет недопустимый формат. Если сообщение отклонено как искаженное, вы получите код состояния HTTP 400 Bad Request . Примеры недопустимого формата включают:

  • В сообщении могут отсутствовать поля From , To и Date .
  • Ошибка возникает, если строка в сообщении не завершается новой строкой в ​​стиле CR+LF (то есть "\r\n" ).
  • Сообщение электронной почты пусто.
  • Целевая группа миграции не существует или находится в режиме "только для чтения". Дополнительную информацию о режиме общего доступа только для чтения см. в разделе Варианты общего доступа в Google Группах для бизнеса .

SUCCESS — Почта была успешно заархивирована в групповом архиве учетной записи. Возвращается код состояния HTTP 200 .

UNSUPPORTED_PARALLEL_OPERATION — API не поддерживает параллельную вставку сообщений в один и тот же групповой архив. Пакетные запросы также не поддерживаются в этой версии API. Но API поддерживает параллельные запросы на вставку электронной почты в разные групповые архивы. Возвращается код состояния HTTP 400 .