Импорты
Входящая старая почта и переезды от другого провайдера.
Инструменты импорта
| Инструмент | Что делает |
|---|---|
| listImports | Импорты старой почты в рабочее пространство, сначала новые, с их статусом и ходом. addressId оставляет только импорты в один адрес. |
| getImport | Один импорт по его id: его файлы, сколько он прочитал и сколько сообщений импортировал. |
| listImportFailures | Сообщения, которые импорт не смог перенести, и почему. |
| cancelImport | Останавливает ещё идущий импорт. Уже импортированная почта остаётся. В чате приложения он всегда сначала спрашивает. |
| listProviderImports | Импорты от другого почтового провайдера, например Resend, сначала новые, с их статусом. |
| getProviderImport | Один импорт от другого провайдера с отчётом: что перенесено, какие домены опубликовать здесь и какие API-ключи заменить. |
| cancelProviderImport | Останавливает ещё идущий импорт от другого провайдера. Уже перенесённое остаётся. В чате приложения он всегда сначала спрашивает. |
Импортам старой почты нужна threads:read, а для отмены threads:write. Клиент, ограниченный некоторыми адресами, видит только импорты в них.
Импортам от другого провайдера нужна settings:read, а для отмены settings:write. Доступ к ним есть только у владельца рабочего пространства.
Ни один инструмент не загружает почту и не запускает импорт: файлы загружаются частями, а импорту от другого провайдера нужен его API-ключ. Запустите импорт на странице «Переносы» в приложении или через POST /imports и POST /provider-imports в REST API.
Справочник
listImports
The imports of old mail into this workspace, newest first, as the Migrations page of the app lists them: the address each one fills, its status, how far it has read and how many messages it imported. addressId keeps the ones into one address. A member sees the imports into the addresses they reach. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.
Входные данные
addressIdstring- От 1 до 128 символов
limitinteger- Не меньше 1Не больше 100
cursorstring
Также доступно в
getImport
One import of old mail by its id: its status, the files it reads, how far it has read, and how many messages it imported, found already here, left out or could not import. listImportFailures says which messages did not import and why.
Входные данные
idstringОбязательно- От 1 до 128 символов
Также доступно в
listImportFailures
The messages an import could not bring in, in the order it met them, with the reason for each, as What was not imported on the Migrations page shows them. When more follow, the last line gives the after value to pass back for the next page.
Входные данные
idstringОбязательно- От 1 до 128 символов
afterinteger- Не меньше -1
limitinteger- Не меньше 1Не больше 100
Также доступно в
cancelImport
Stop an import of old mail that is still uploading, waiting or running, as Cancel import on the Migrations page does. Mail it already imported stays in the mailbox. A chat always asks first.
Входные данные
idstringОбязательно- От 1 до 128 символов
Также доступно в
listProviderImports
The imports from another email provider, such as Resend, into this workspace, newest first: what each one brings across and its status. Only the workspace owner reaches them. getProviderImport gives the full report of one. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.
Входные данные
limitinteger- Не меньше 1Не больше 100
cursorstring
Также доступно в
getProviderImport
One import from another email provider by its id, with its report as the Migrations page shows it: what came across, the domains to publish here, the API keys to replace and what was not brought across. Only the workspace owner reaches it.
Входные данные
idstringОбязательно- От 1 до 128 символов
Также доступно в
cancelProviderImport
Stop an import from another email provider that is still waiting or running. What it already brought across stays. Only the workspace owner can, and a chat always asks first.
Входные данные
idstringОбязательно- От 1 до 128 символов