client.Exports
이 네임스페이스의 모든 메서드: 시그니처, 매개변수, 반환값과 예시.
메서드
A zip of the whole workspace, as the Export page makes it: see what it would hold, start one, follow it while it is made and download it once it is ready.
Exports.PreviewAsync
See what an export would hold
Task<JsonObject> PreviewAsync(string? apiKey = null, CancellationToken cancellationToken = default)Returns whether the workspace can be exported by the caller now, when the next export can start, the export still being made, if there is one, and how much an export would hold: conversations, attachments and their size, contacts, audiences, calendar events, templates, rules, labels, notes and addresses. When allowed is false, reason says why and counts is null.
Only the workspace owner, or a member whose role holds every permission, can export the workspace: an API key, or an access token connected with every address. A key or token limited to particular addresses or domains is 422 capability_unsupported, and an account the workspace cannot export for is 403 export_not_permitted.
매개변수
apiKeystring?Overrides the client's API key for this call only.
cancellationTokenCancellationTokenCancels the request.
반환값
A JsonObject with allowed, reason, nextAvailableAt, activeExportId and counts, an object of threads, attachments, attachmentBytes, deletedFiles, contacts, audiences, calendarEvents, templates, rules, labels, notes and addresses.
예시
var preview = await client.Exports.PreviewAsync(); if ((bool?)preview["allowed"] != true){ Console.WriteLine($"Cannot export: {preview["reason"]}");}else if (preview["activeExportId"] is not null){ Console.WriteLine($"Export {preview["activeExportId"]} is still being made");}else{ Console.WriteLine($"{preview["counts"]?["threads"]} conversations and {preview["counts"]?["attachments"]} attachments");}참고
reasonisnot-permitted,mailbox-loginortwo-factor-required.
다른 사용처
Exports.ListAsync
List the exports
Task<JsonObject> ListAsync( int? limit = null, int? offset = null, string? apiKey = null, CancellationToken cancellationToken = default)Returns every export of the workspace, newest first, a page at a time, with its status, its progress through the conversations and, once it is ready, its size, file name and when it is deleted.
Only the workspace owner, or a member whose role holds every permission, can export the workspace: an API key, or an access token connected with every address. A key or token limited to particular addresses or domains is 422 capability_unsupported, and an account the workspace cannot export for is 403 export_not_permitted.
매개변수
limitint?Exports per page, from 1 to 100. The server defaults to 25.
offsetint?How many exports to skip.
apiKeystring?Overrides the client's API key for this call only.
cancellationTokenCancellationTokenCancels the request.
반환값
A JsonObject, not a Page, with data, a list of export objects shaped like the one Exports.GetAsync returns, plus total and hasMore. Ask for the next page with offset:.
예시
using OpenEmail.Constants; var exports = await client.Exports.ListAsync(limit: 10); foreach (var export in exports["data"]?.AsArray() ?? []){ if ((string?)export?["status"] == ExportStatuses.Ready) { Console.WriteLine($"{export?["id"]} {export?["fileName"]} {export?["sizeBytes"]} bytes, kept until {export?["expiresAt"]}"); }}참고
A workspace can be exported once a day, and each export is kept for a year, so the list stays short.
다른 사용처
- API
GET /exports- TypeScript
exports.list()- Python
exports.list()- Ruby
exports.list- PHP
exports->list- Go
Exports.List- Java
exports().list- CLI
openemail exports list
Exports.GetAsync
Retrieve an export
Task<JsonObject> GetAsync( string id, string? apiKey = null, CancellationToken cancellationToken = default)Returns one export: its status, phase and progress while it is made, and once it is ready its size, file name and when it is deleted.
Only the workspace owner, or a member whose role holds every permission, can export the workspace: an API key, or an access token connected with every address. A key or token limited to particular addresses or domains is 422 capability_unsupported, and an account the workspace cannot export for is 403 export_not_permitted.
매개변수
idstring필수The export id from
Exports.StartAsyncorExports.ListAsync.apiKeystring?Overrides the client's API key for this call only.
cancellationTokenCancellationTokenCancels the request.
반환값
A JsonObject with id, status, phase, createdAt, createdBy, startedAt, finishedAt, expiresAt, sizeBytes, fileName, threadsDone, threadsTotal and error.
예시
var export = await client.Exports.GetAsync("exp_8c1e4a7f2b9d3e6a0c5f1b28"); Console.WriteLine($"{export["status"]} {export["error"]}");참고
An unknown id is a 404.
다른 사용처
- API
GET /exports/{id}- TypeScript
exports.get()- Python
exports.get()- Ruby
exports.get- PHP
exports->get- Go
Exports.Get- Java
exports().get- CLI
openemail exports get
Exports.StartAsync
Start an export
Task<JsonObject> StartAsync(string? apiKey = null, CancellationToken cancellationToken = default)Starts making a zip of the whole workspace, as Export now on the Export page does, and returns the export, queued. It is made in the background: poll Exports.GetAsync until status is ready, then Exports.DownloadAsync it. One export runs at a time, and a workspace can be exported once a day.
Only the workspace owner, or a member whose role holds every permission, can export the workspace: an API key, or an access token connected with every address. A key or token limited to particular addresses or domains is 422 capability_unsupported, and an account the workspace cannot export for is 403 export_not_permitted.
매개변수
apiKeystring?Overrides the client's API key for this call only.
cancellationTokenCancellationTokenCancels the request.
반환값
A JsonObject for the new export, shaped like the one Exports.GetAsync returns.
예시
try{ var export = await client.Exports.StartAsync(); Console.WriteLine($"Export {export["id"]} is {export["status"]}");}catch (OpenEmailApiException error){ Console.WriteLine($"Not now: {error.Message}");}참고
With an OAuth access token it asks for a verification code: until the app has verified one, it is refused with 403
step_up_required. An API key is never asked.An export already being made is 409
already_running, and a workspace exported in the last day is 429export_limit_reached.The SDK does not retry it.
다른 사용처
- API
POST /exports- TypeScript
exports.start()- Python
exports.start()- Ruby
exports.start- PHP
exports->start- Go
Exports.Start- Java
exports().start- CLI
openemail exports start
Exports.DownloadAsync
Download an export
Task<byte[]> DownloadAsync( string id, string? apiKey = null, CancellationToken cancellationToken = default)Returns the zip of a ready export, the same file the Download action on the Export page saves.
Only the workspace owner, or a member whose role holds every permission, can export the workspace: an API key, or an access token connected with every address. A key or token limited to particular addresses or domains is 422 capability_unsupported, and an account the workspace cannot export for is 403 export_not_permitted.
매개변수
idstring필수The export id from
Exports.StartAsyncorExports.ListAsync.apiKeystring?Overrides the client's API key for this call only.
cancellationTokenCancellationTokenCancels the request.
반환값
A string holding the bytes of the zip.
예시
var export = await client.Exports.GetAsync("exp_8c1e4a7f2b9d3e6a0c5f1b28"); var zip = await client.Exports.DownloadAsync(export["id"]!.GetValue<string>()); Console.WriteLine($"{zip.Length} bytes saved");참고
With an OAuth access token it asks for a verification code: until the app has verified one, it is refused with 403
step_up_required. An API key is never asked.Before the export is
readythe call is 409export_not_ready, and an export older than a year is 409expired.The whole zip is held in memory, and a large workspace makes a large zip.