Archive: insert

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

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

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

Ограничение проекта для 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-пути запроса. Если владелец группы меняет адрес электронной почты группы с помощью консоли администратора или API каталога, вы должны использовать новый адрес электронной почты в переменной groupId .
Обязательные параметры запроса
uploadType string

Тип запроса на загрузку в URI /upload с одним из следующих значений:

  • media — простая загрузка, при которой загружаются медиаданные.
  • resumable — возобновляемая загрузка, при которой файл загружается возобновляемым способом с использованием серии как минимум двух запросов.

Авторизация

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

Объем
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 .