Как отправить тяжелый файл через outlook
Перейти к содержимому

Как отправить тяжелый файл через outlook

  • автор:

Отправка документа из Microsoft Office

Классический клиент Project Online Publisher для Microsoft 365 Excel 2021 Word 2021 PowerPoint 2021 Project профессиональный 2021 Project стандартный 2021 Publisher 2021 Excel 2019 Word 2019 PowerPoint 2019 Project профессиональный 2019 Project стандартный 2019 Publisher 2019 Excel 2016 Word 2016 PowerPoint 2016 Project профессиональный 2016 Project стандартный 2016 Publisher 2016 Excel 2013 Word 2013 PowerPoint 2013 Project профессиональный 2013 Project стандартный 2013 Publisher 2013 Excel 2010 Word 2010 Project 2010 Project стандартный 2010 Publisher 2010 Еще. Меньше

Если в состав установленной на компьютере версии Microsoft Office входит Outlook и он используется по умолчанию для отправки почты, вы можете отправлять документы в виде вложений. Кроме того, файлы Excel, Publisher или Word можно отправлять непосредственно в тексте сообщения.

Если Outlook не является стандартным почтовым приложением, потребуется сделать его таковым, чтобы использовать эту функцию. Дополнительные сведения см. в статье Выбор Outlook в качестве программы по умолчанию для работы с электронной почтой, контактами и календарем.

Отправка в виде вложения

Excel, PowerPoint и Word

  1. Выберите файл >поделиться, а затем выберите один из следующих вариантов:

Примечание: Конкретный набор доступных параметров будет варьироваться в зависимости от используемого приложения Office.

  • Отправить в OneDrive Отправка файла в учетную запись OneDrive, где вы можете поделиться им по прямой ссылке или сообщению электронной почты.
  • Вложите вместо этого копию Выберите вложенный файл в сообщение электронной почты или PDF-файл.

OneNote, Visio, Publisher и Project

  1. Выберите файл >поделиться, а затем выберите один из следующих вариантов:

Примечание: Конкретный набор доступных параметров будет варьироваться в зависимости от используемого приложения Office.

  • Поделиться с людьми (OneNote и Visio) Позволяет ввести имя или адрес электронной почты для тех, кому вы хотите отправить сообщение, настроить его редактирование, требовать входа пользователя перед редактированием и необязательное сообщение. Этот параметр требует отправки файла в OneDrive.
  • Отправить ссылку (Visio) Позволяет всем работать с одной и той же копией файла, видеть последние изменения и не замерять размер электронной почты. Чтобы отправить ссылку, файл должен быть сохранен на веб-сервере или в общей папке.
  • Отправить как вложение. Откроется окно сообщения электронной почты с вложенной копией файла в исходном формате.
  • Отправить как PDF. Откроется окно сообщения электронной почты с вложенной копией файла в формате PDF.
  • Отправить как XPS. Откроется окно сообщения электронной почты с вложенной копией файла в формате XPS.

Отправка в тексте сообщения электронной почты

В приложениях Excel, Publisher и Word можно отправлять файлы непосредственно в тексте сообщения электронной почты (а не в виде вложения). Для этого необходимо добавить на панель быстрого доступа команду Отправить получателю. Сведения о добавлении команд на панель быстрого доступа см. в статье Настройка панели быстрого доступа.

  1. Откройте файл, который вы хотите отправить.
  2. На панели быстрого доступа нажмите кнопку Отправить получателю, чтобы открыть сообщение электронной почты. Файл будет помещен в текст сообщения.
  3. Укажите псевдонимы получателей, введите тему и текст сообщения (если необходимо) и нажмите кнопку Отправить.

Отправка в виде вложения

Excel, PowerPoint, Project, Publisher, Visio и Word

  1. Выберите Файл >Общий доступ >Электронная почта, а затем — один из указанных ниже параметров.
  2. Отправить как вложение. Откроется окно сообщения электронной почты с вложенной копией файла в исходном формате.
  3. Отправить как PDF. Откроется окно сообщения электронной почты с вложенной копией файла в формате PDF.
  4. Отправить как XPS. Откроется окно сообщения электронной почты с вложенной копией файла в формате XPS.
  5. Отправить как факс через Интернет. Откроется веб-страница со списком поставщиков услуг, которые позволяют отправлять факсы через Интернет.

Примечание: Конкретный набор доступных параметров будет варьироваться в зависимости от используемого приложения Office.

OneNote

  1. Выберите Файл >Отправить, а затем — один из указанных ниже параметров.
    • Отправить как вложение Откроется окно сообщения электронной почты с вложенными копией файла в исходном формате и копией файла в формате веб-страницы.
    • Отправить как PDF. Откроется окно сообщения электронной почты с вложенной копией файла в формате PDF.
  2. Укажите псевдонимы получателей, введите тему и текст сообщения (если необходимо) и нажмите кнопку Отправить.

Отправка в тексте сообщения электронной почты

В приложениях Excel, Publisher и Word можно отправлять файлы непосредственно в тексте сообщения электронной почты (а не в виде вложения). Для этого необходимо добавить на панель быстрого доступа команду Отправить получателю. Сведения о добавлении команд на панель быстрого доступа см. в статье Настройка панели быстрого доступа.

  1. Откройте файл, который вы хотите отправить.
  2. На панели быстрого доступа нажмите кнопку Отправить получателю, чтобы открыть сообщение электронной почты. Файл будет помещен в текст сообщения.
  3. Укажите псевдонимы получателей, введите тему и текст сообщения (если необходимо) и нажмите кнопку Отправить.

Отправка в виде вложения

Приведенные ниже инструкции относятся к приложениям Excel, PowerPoint, Project, Publisher, Visio и Word.

  1. Откройте вкладку Файл.
  2. Нажмите кнопку Сохранить и отправить.
  3. Выберите вариант Отправить по электронной почте, после чего выберите один из следующих параметров:
  4. Отправить как вложение. Откроется окно сообщения электронной почты с вложенной копией файла в исходном формате.
  5. Отправить как PDF. Откроется окно сообщения электронной почты с вложенной копией файла в формате PDF.
  6. Отправить как XPS. Откроется окно сообщения электронной почты с вложенной копией файла в формате XPS.

Примечание: В приложении Project 2010 форматы PDF и XPS недоступны.

Ниже приведены инструкции для приложения OneNote 2010.

  1. Откройте вкладку Файл.
  2. Нажмите кнопку Отправить и выберите один из указанных ниже параметров.
    • Отправить страницу по электронной почте как вложение. Откроется окно сообщения электронной почты с вложенными копией файла в исходном формате и копией файла в формате веб-страницы.
    • Отправить страницу электронной почты в формате PDF. Откроется окно сообщения электронной почты с копией файла в .pdfformat attached.
  3. Укажите псевдонимы получателей, введите тему и текст сообщения (если необходимо) и нажмите кнопку Отправить.

Отправка в тексте сообщения электронной почты

В приложениях Excel, Publisher и Word можно отправлять файлы непосредственно в тексте сообщения электронной почты (а не в виде вложения). Для этого необходимо добавить на панель быстрого доступа команду Отправить получателю. Сведения о добавлении команд на панель быстрого доступа см. в статье Настройка панели быстрого доступа.

Чтобы отправить файл в тексте сообщения электронной почты, выполните указанные ниже действия.

Значок

  1. Откройте файл, который вы хотите отправить.
  2. На панели быстрого доступа нажмите кнопку Отправить сообщение , чтобы открыть сообщение электронной почты. Файл будет помещен в текст сообщения.
  3. Укажите псевдонимы получателей, введите тему и текст сообщения (если необходимо) и нажмите кнопку Отправить.

Отправка крупных файлов в Outlook

При попытке вложения файлов, размер файлов превышает максимальный, вы получите сообщение об ошибке. Обойти это ограничение можно несколькими способами, включая использование службы общего доступа к файлам или сжатие файла.

Outlook ограничивает размер файлов, которые можно отправлять. Это ограничение не позволит вашему компьютеру постоянно загружать очень большие вложения, превышают ограничения большинства поставщиков услуг Интернета. Для учетной записи электронной почты Интернета. Например, Outlook.com или Gmail, предельный размер объединенного файла составляет 20 МБ, а для учетных записей Exchange (электронная почта) по умолчанию — 10 МБ.

Сохранение файла в облачной службе и отправка ссылки на него

Существует множество облачных хранилищ, в которые можно отправить большие файлы, а затем делиться ими. Некоторые популярные облачные хранилища включают OneDrive, Dropbox, iCloud и Google Диск. Если файл хранится в облаке, вы можете включить ссылку на него в сообщение электронной почты.

    Добавьте свой файл в облачную службу, например OneDrive или Dropbox.

Примечание: Служба создаст ссылку для доступа к файлу. Получатель сообщения сможет открыть ссылку для скачивания файла.

Совет: Дополнительные сведения об отправке файлов и создании ссылки для скачивания в OneDrive см. в статьях Добавление фотографий и файлов в OneDrive и Предоставление общего доступа к файлам и папкам и изменение разрешений.

Сжатие файла

Когда вы сжимаете ( запаковываете ) файл, его размер уменьшается и он может стать меньше ограничений Outlook. В следующих статьях приведены инструкции по сжатию и извлечению файлов для разных операционных систем Windows:

  • Windows 10: zip и unzip fileshttp://go.microsoft.com/fwlink/?LinkId=722360
  • Windows 8.1. За zip-файлы и их
  • Windows 7: сжатие и сжатие файлов (ZIP-файлы)

Уменьшение размера изображения

Если вы отправляете крупные файлы изображений, вы можете автоматически изменить их размеры.

Если вы выберете этот параметр, Outlook будет изменять размер изображений при отправке.

  1. Вложите изображения в сообщение электронной почты.
  2. Щелкните Файл >Сведения.
  3. В разделе Графические вложения выберите Уменьшать большие изображения при отправке сообщения.
  4. Вернитесь к сообщению и нажмите кнопку Отправить.

Сохранение файла в библиотеку сервера SharePoint

Если вы применяете Outlook на работе и пользуетесь SharePoint, вы можете сохранить файл в библиотеке SharePoint и поделиться ссылкой на него. Инструкции см. в статье Предоставление общего доступа к документу с использованием SharePoint или OneDrive.

Если вы пытаетесь отправить сообщение с вложениями слишком большого размера в Outlook 2010 и Outlook 2007, отображается сообщение«Размервложения превышает допустимое ограничение».

Примечание: Дополнительные сведения об изменении максимально допустимого размера вложений см. в ошибке «Размер вложения превышает допустимое ограничение».

Проблемы с большими вложениями

Даже если размер сообщения не превышает ограничение Outlook или Exchange Server вложения, поставщик услуг электронной почты получателя может заблокировать сообщения с большими вложениями. Чтобы уменьшить размер вложений, отправляемых в Outlook, см. в этой справке.

Кроме ограничения поставщика услуг электронной почты на общий размер сообщений, отправлять большие вложения по электронной почте не всегда является оптимальным решением.

  • Сообщение может привести к превышению квоты хранилища в почтовом ящике получателей Если почтовые ящики получателей превышают квоту хранилища, получатели могут получить другие сообщения.
  • Сообщение может привести к превышению квоты хранилища для вашего почтового ящика Все отправляемые сообщения сохраняются в папке «Отправленные». Отправка больших вложений другим людям также учитывается при подсчете квоты на размер почтового ящика. При превышении квоты хранилища может быть заблокировано получение дополнительных сообщений.
  • Раздутый вложение Когда файл вложен в сообщение, он должен быть закодирован. В процессе кодиации вложенные файлы становятся в 1,37 раз больше, чем на компьютере. Например, при отправке вложенного файла размером 5 МБ вложение отправляется как данные размером 6,85 МБ.

Эффективное совместное использование больших файлов

Существует несколько способов обмена большими файлами и совместной работы с другими людьми без отправки вложений.

  • Библиотеки Microsoft SharePoint Server Если у вас есть доступ к библиотеке SharePoint Server, файлы можно сохранить в библиотеке. Дополнительные сведения см. в теме «Сохранение файла в библиотеке SharePoint». Доступ к библиотекам SharePoint можно получить непосредственно в Outlook.

Если ваша организация использует SharePoint Server и предоставляет вам «Мой сайт», вы можете добавить свои файлы в библиотеку «Общие документы моего сайта», а затем добавить ссылку на файл в сообщение.

Открыв библиотеку документов SharePoint, в которую вы загрузили файл, щелкните правой кнопкой мыши ссылку на документ, выберите «Копировать ярлык», а затем вкопируйте (CTRL+V) ярлык в сообщение.

  • OneDrive OneDrive — это бесплатная служба Майкрософт, которая предоставляет защищенное паролем интернет-хранилище файлов, которое позволяет сохранять файлы, получать к ним доступ и делиться ими через Интернет с друзьями и сотрудниками практически из любого места. Вы можете сохранять Microsoft Office документы непосредственно в OneDrive. Дополнительные сведения см. в видео «Введение в OneDrive».
  • Общие сетевые расположения Сохранения файлов в папке, к которую могут получить доступ получатели. Затем вы можете отправить получателям сообщение со ссылкой на общее расположение. На вкладке Вставка в группе Ссылки выберите команду Гиперссылка. Если путь к общему расположению или имя файла содержит пробелы, см. статью «Добавление ссылок, содержащих пробелы» в сообщение электронной почты.
  • Сайты для обмена фотографиями Если вы отправляете изображения другому человеку, рассмотрите возможность его размер перед отправкой. Узнайте, как уменьшить размер рисунков и вложений. Современные цифровые камеры могут иметь каждый рисунок (не менее 3 МБ) при передаче с камеры. Если вы не хотите, чтобы фотографии менялись, существует множество веб-сайтов с возможностью отправки изображений и отправки ссылки на них в сообщении.
  • Сайты для обмена видео Даже короткий видео файл может иметь очень большой размер. Делиться видеоклипами можно с помощью одного из способов, описанных в этой статье, или на веб-сайте с видео.

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

Вложение крупных файлов в сообщения и события Outlook

С помощью API Microsoft Graph можно вкладывать файлы размером до 150 МБ в элементы Outlook сообщение или событие. В зависимости от размера файла выберите один из двух способов вложения файла:

  • Если размер файла не превышает 3 МБ, выполните одну операцию POST в свойстве навигации attachments элемента Outlook. Узнайте, как это выполняется для сообщения или события. Успешный отклик POST включает ИД вложенного файла.
  • Если размер файла составляет от 3 до 150 МБ, создайте сеанс отправки и итеративно используйте PUT для отправки диапазонов байтов, пока не будет отправлен весь файл. Заголовок в итоговом успешном отклике PUT включает URL-адрес с ИД вложения.

Чтобы вложить в сообщение несколько файлов, выберите способ для каждого файла на основе их размеров и вложите файлы по отдельности.

В этой статье пошагово демонстрируется второй подход с созданием и использованием сеанса отправки для добавления большого вложенного файла (размером более 3 МБ) в элемент Outlook. На каждом шаге демонстрируется соответствующий код для сообщения и события. После успешной отправки целого файла в статье показано получение заголовка отклика, содержащего идентификатор вложения файла, который затем используется для получения необработанного содержимого или метаданных вложения.

Обратите внимание на известную проблему при вложении больших файлов в сообщение или событие в общем или делегированном почтовом ящике.

Шаг 1. Создание сеанса отправки

Создайте сеанс отправки, чтобы вложить файл в сообщение или событие. Укажите файл во входном параметре AttachmentItem.

После успешной операции возвращается HTTP 201 Created и новый экземпляр объекта uploadSession, содержащий непрозрачный URL-адрес, который можно использовать в последующих операциях PUT для отправки частей этого файла. Этот экземпляр uploadSession предоставляет временное место хранения, где байты файла сохраняются до отправки всего файла.

Объект uploadSession в отклике также включает свойство nextExpectedRanges, указывающее, что начальное место отправки должно быть байтом 0.

Разрешения

Обязательно запросите разрешение Mail.ReadWrite на создание экземпляра uploadSession для сообщения и экземпляра Calendars.ReadWrite для события.

Непрозрачный URL-адрес, возвращенный свойством uploadUrl нового объекта uploadSession, проходит предварительную проверку подлинности и содержит соответствующий маркер авторизации для последующих запросов PUT в домене https://outlook.office.com . Этот маркер истекает в срок expirationDateTime. Не следует изменять этот URL-адрес для операций PUT .

Пример: создание сеанса отправки для сообщения

Запрос
 // Code snippets are only available for the latest version. Current version is 5.x // Dependencies using Microsoft.Graph.Me.Messages.Item.Attachments.CreateUploadSession; using Microsoft.Graph.Models; var requestBody = new CreateUploadSessionPostRequestBody < AttachmentItem = new AttachmentItem < AttachmentType = AttachmentType.File, Name = "flower", Size = 3483322L, >, >; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp var result = await graphClient.Me.Messages[""].Attachments.CreateUploadSession.PostAsync(requestBody); 
 // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY mgc users messages attachments create-upload-session post --user-id --message-id --body '\ >\ ' 
 import ( "context" msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" graphusers "github.com/microsoftgraph/msgraph-sdk-go/users" graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" //other-imports ) graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) requestBody := graphusers.NewItemCreateUploadSessionPostRequestBody() attachmentItem := graphmodels.NewAttachmentItem() attachmentType := graphmodels.FILE_ATTACHMENTTYPE attachmentItem.SetAttachmentType(&attachmentType) name := "flower" attachmentItem.SetName(&name) size := int64(3483322) attachmentItem.SetSize(&size) requestBody.SetAttachmentItem(attachmentItem) createUploadSession, err := graphClient.Me().Messages().ByMessageId("message-id").Attachments().CreateUploadSession().Post(context.Background(), requestBody, nil) 
 GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient(); AttachmentItem attachmentItem = new AttachmentItem(); attachmentItem.attachmentType = AttachmentType.FILE; attachmentItem.name = "flower"; attachmentItem.size = 3483322L; graphClient.me().messages("AAMkADI5MAAIT3drCAAA=").attachments() .createUploadSession(AttachmentCreateUploadSessionParameterSet .newBuilder() .withAttachmentItem(attachmentItem) .build()) .buildRequest() .post(); 
 const options = < authProvider, >; const client = Client.init(options); const uploadSession = < AttachmentItem: < attachmentType: 'file', name: 'flower', size: 3483322 >>; await client.api('/me/messages/AAMkADI5MAAIT3drCAAA=/attachments/createUploadSession') .post(uploadSession); 
 setAttachmentType(new AttachmentType('file')); $attachmentItem->setName('flower'); $attachmentItem->setSize(3483322); $requestBody->setAttachmentItem($attachmentItem); $result = $graphServiceClient->me()->messages()->byMessageId('message-id')->attachments()->createUploadSession()->post($requestBody)->wait(); 
 Import-Module Microsoft.Graph.Users.Actions $params = @ < AttachmentItem = @< attachmentType = "file" name = "flower" size = 3483322 >> # A UPN can also be used as -UserId. New-MgUserMessageAttachmentUploadSession -UserId $userId -MessageId $messageId -BodyParameter $params 
 # THE PYTHON SDK IS IN PREVIEW. FOR NON-PRODUCTION USE ONLY graph_client = GraphServiceClient(credentials, scopes) request_body = CreateUploadSessionPostRequestBody( attachment_item = AttachmentItem( attachment_type = AttachmentType.File, name = "flower", size = 3483322, ), ) result = await graph_client.me.messages.by_message_id('message-id').attachments.create_upload_session.post(request_body) 
Отклик

В следующем примере отклика демонстрируется ресурс uploadSession, возвращаемый для сообщения.

HTTP/1.1 201 Created Content-type: application/json < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.uploadSession", "uploadUrl": "https://outlook.office.com/api/v2.0/Users('a8e8e219-4931-95c1-b73d-62626fd79c32@72aa88bf-76f0-494f-91ab-2d7cd730db47')/Messages('AAMkADI5MAAIT3drCAAA=')/AttachmentSessions('AAMkADI5MAAIT3k0tAAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIUlN6bllHMmNI", "expirationDateTime": "2019-09-25T01:09:30.7671707Z", "nextExpectedRanges": [ "0-" ] >

Пример: создание сеанса отправки для события

Запрос
 // Code snippets are only available for the latest version. Current version is 5.x // Dependencies using Microsoft.Graph.Me.Events.Item.Attachments.CreateUploadSession; using Microsoft.Graph.Models; var requestBody = new CreateUploadSessionPostRequestBody < AttachmentItem = new AttachmentItem < AttachmentType = AttachmentType.File, Name = "flower", Size = 3483322L, >, >; // To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp var result = await graphClient.Me.Events[""].Attachments.CreateUploadSession.PostAsync(requestBody); 
 // THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY mgc users events attachments create-upload-session post --user-id --event-id --body '\ >\ ' 
 import ( "context" msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go" graphusers "github.com/microsoftgraph/msgraph-sdk-go/users" graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models" //other-imports ) graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes) requestBody := graphusers.NewItemCreateUploadSessionPostRequestBody() attachmentItem := graphmodels.NewAttachmentItem() attachmentType := graphmodels.FILE_ATTACHMENTTYPE attachmentItem.SetAttachmentType(&attachmentType) name := "flower" attachmentItem.SetName(&name) size := int64(3483322) attachmentItem.SetSize(&size) requestBody.SetAttachmentItem(attachmentItem) createUploadSession, err := graphClient.Me().Events().ByEventId("event-id").Attachments().CreateUploadSession().Post(context.Background(), requestBody, nil) 
 GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient(); AttachmentItem attachmentItem = new AttachmentItem(); attachmentItem.attachmentType = AttachmentType.FILE; attachmentItem.name = "flower"; attachmentItem.size = 3483322L; graphClient.me().events("AAMkADU5CCmSAAA=").attachments() .createUploadSession(AttachmentCreateUploadSessionParameterSet .newBuilder() .withAttachmentItem(attachmentItem) .build()) .buildRequest() .post(); 
 const options = < authProvider, >; const client = Client.init(options); const uploadSession = < AttachmentItem: < attachmentType: 'file', name: 'flower', size: 3483322 >>; await client.api('/me/events/AAMkADU5CCmSAAA=/attachments/createUploadSession') .post(uploadSession); 
 setAttachmentType(new AttachmentType('file')); $attachmentItem->setName('flower'); $attachmentItem->setSize(3483322); $requestBody->setAttachmentItem($attachmentItem); $result = $graphServiceClient->me()->events()->byEventId('event-id')->attachments()->createUploadSession()->post($requestBody)->wait(); 
 Import-Module Microsoft.Graph.Users.Actions $params = @ < AttachmentItem = @< attachmentType = "file" name = "flower" size = 3483322 >> # A UPN can also be used as -UserId. New-MgUserEventAttachmentUploadSession -UserId $userId -EventId $eventId -BodyParameter $params 
 # THE PYTHON SDK IS IN PREVIEW. FOR NON-PRODUCTION USE ONLY graph_client = GraphServiceClient(credentials, scopes) request_body = CreateUploadSessionPostRequestBody( attachment_item = AttachmentItem( attachment_type = AttachmentType.File, name = "flower", size = 3483322, ), ) result = await graph_client.me.events.by_event_id('event-id').attachments.create_upload_session.post(request_body) 
Отклик

В следующем примере отклика демонстрируется ресурс uploadSession, возвращаемый для события.

HTTP/1.1 201 Created Content-type: application/json < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.uploadSession", "uploadUrl": "https://outlook.office.com/api/v2.0/Users('d3b9214b-dd8b-441d-b7dc-c446c9fa0e69@98a79ebe-74bf-4e07-a017-7b410848cb32')/Events('AAMkADU5CCmSAAA=')/AttachmentSessions('AAMkADU5RpAACJlCs8AAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIBtw", "expirationDateTime": "2020-02-22T02:46:56.7410786Z", "nextExpectedRanges": [ "0-" ] >

Шаг 2. Отправка диапазона байтов файла с помощью сеанса отправки

Чтобы отправить файл или часть файла, выполните запрос PUT к URL-адресу, возвращенному на шаге 1 в свойстве uploadUrl ресурса uploadSession. Можно отправить файл целиком или разделить файл на несколько диапазонов байтов. Для более высокой производительности размер каждого диапазона байтов не должен превышать 4 МБ.

Укажите заголовки и основной текст запроса, как описано ниже.

Заголовки запросов

Имя Тип Описание
Content-Length Int32 Количество байтов, отправляемых в этой операции. Для более высокой производительности количество байт в каждой операции PUT не должно превышать 4 МБ. Обязательный элемент.
Content-Range String Диапазон байтов файла, отправляемого в этой операции, начиная с байта 0, выраженный в формате bytes -/ . Обязательный элемент.
Content-Type String Тип MIME. Укажите application/octet-stream . Обязательный элемент.

Не указывайте заголовок запроса Authorization . Запрос PUT использует прошедший предварительную проверку подлинности URL-адрес из свойства uploadUrl, что позволяет получить доступ к домену https://outlook.office.com .

Основной текст запроса

Укажите фактические байты вкладываемого файла, находящиеся в диапазоне расположения, указанном в заголовке запроса Content-Range .

Отклик

После успешной отправки возвращается HTTP 200 OK и объект uploadSession. Объект отклика имеет указанные ниже свойства.

  • Свойство ExpirationDateTime указывает дату и время окончания срока действия для маркера авторизации, внедренного в значение свойства uploadUrl. Это значение даты и времени окончания срока действия остается таким же, какое было возвращено начальным объектом uploadSession на шаге 1.
  • nextExpectedRanges указывает расположение следующего байта для начала загрузки, например, «nextExpectedRanges»:[«2097152»] . Байты файла необходимо отправлять по порядку.
  • Свойство uploadUrl не возвращается явным образом, поскольку все операции PUT сеанса отправки используют тот же самый URL-адрес, который был возвращен при создании сеанса (на шаге 1).

Пример: первая отправка в сообщение

Запрос
PUT https://outlook.office.com/api/v2.0/Users('a8e8e219-4931-95c1-b73d-62626fd79c32@72aa88bf-76f0-494f-91ab-2d7cd730db47')/Messages('AAMkADI5MAAIT3drCAAA=')/AttachmentSessions('AAMkADI5MAAIT3k0tAAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIUlN6bllHMmNI Content-Type: application/octet-stream Content-Length: 2097152 Content-Range: bytes 0-2097151/3483322 < > 
Отклик

Следующий пример ответа показывает в свойстве nextExpectedRanges начало следующего диапазона байтов, ожидаемого сервером.

HTTP/1.1 200 OK Content-type: application/json < "@odata.context":"https://outlook.office.com/api/v2.0/$metadata#Users('a8e8e219-4931-95c1-b73d-62626fd79c32%4072aa88bf-76f0-494f-91ab-2d7cd730db47')/Messages('AAMkADI5MAAIT3drCAAA%3D')/AttachmentSessions/$entity", "ExpirationDateTime":"2019-09-25T01:09:30.7671707Z", "nextExpectedRanges":["2097152"] >

Пример: первая отправка в событие

Запрос
PUT https://outlook.office.com/api/v2.0/Users('d3b9214b-dd8b-441d-b7dc-c446c9fa0e69@98a79ebe-74bf-4e07-a017-7b410848cb32')/Events('AAMkADU5CCmSAAA=')/AttachmentSessions('AAMkADU5RpAACJlCs8AAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIBtw Content-Type: application/octet-stream Content-Length: 2097152 Content-Range: bytes 0-2097151/3483322 < > 
Отклик

Следующий пример ответа показывает в свойстве nextExpectedRanges начало следующего диапазона байтов, ожидаемого сервером.

HTTP/1.1 200 OK Content-type: application/json < "@odata.context":"https://outlook.office.com/api/v2.0/$metadata#Users('d3b9214b-dd8b-441d-b7dc-c446c9fa0e69%4098a79ebe-74bf-4e07-a017-7b410848cb32')/Events('AAMkADU5CCmSAAA%3D')/AttachmentSessions/$entity", "ExpirationDateTime":"2020-02-22T02:46:56.7410786Z", "nextExpectedRanges":["2097152"] >

Шаг 3. Продолжение отправки диапазонов байтов вплоть до отправки всего файла

После первоначальной отправки на шаге 2 продолжайте отправлять оставшиеся части файла, используя аналогичный запрос PUT , как описано на шаге 2, до достижения даты и времени окончания срока действия сеанса. Используйте коллекцию nextExpectedRanges, чтобы определить, с чего начать отправку следующего диапазона байтов. Вы можете увидеть несколько диапазонов, указывающих части файла, еще не полученные сервером. Это удобно, когда требуется возобновить прерванную передачу, а клиенту неизвестно состояние службы.

После успешной отправки последнего байта файла операция PUT возвращает HTTP 201 Created и заголовок Location , указывающий URL-адрес вложенного файла в домене https://outlook.office.com . Можно получить ИД вложения по этому URL-адресу и сохранить его для дальнейшего использования. В зависимости от сценария можно использовать этот ИД для получения метаданных вложения или для удаления вложения из элемента Outlook с помощью конечной точки Microsoft Graph.

В следующих примерах показана отправка последнего диапазона байтов файла в сообщение и событие из предыдущих шагов.

Пример: окончательная отправка в сообщение

Запрос
PUT https://outlook.office.com/api/v2.0/Users('a8e8e219-4931-95c1-b73d-62626fd79c32@72aa88bf-76f0-494f-91ab-2d7cd730db47')/Messages('AAMkADI5MAAIT3drCAAA=')/AttachmentSessions('AAMkADI5MAAIT3k0tAAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIUlN6bllHMmNI Content-Type: application/octet-stream Content-Length: 1386170 Content-Range: bytes 2097152-3483321/3483322 < > 
Отклик

В следующем примере отклика показан заголовок отклика Location , из которого можно сохранить идентификатор вложения ( AAMkADI5MAAIT3drCAAABEgAQANAqbAe7qaROhYdTnUQwXm0= ) для дальнейшего применения.

HTTP/1.1 201 Created Location: https://outlook.office.com/api/v2.0/Users('a8e8e219-4931-95c1-b73d-62626fd79c32@72aa88bf-76f0-494f-91ab-2d7cd730db47')/Messages('AAMkADI5MAAIT3drCAAA=')/Attachments('AAMkADI5MAAIT3drCAAABEgAQANAqbAe7qaROhYdTnUQwXm0=') Content-Length: 0 

Пример: окончательная отправка в событие

Запрос
PUT https://outlook.office.com/api/v2.0/Users('d3b9214b-dd8b-441d-b7dc-c446c9fa0e69@98a79ebe-74bf-4e07-a017-7b410848cb32')/Events('AAMkADU5CCmSAAA=')/AttachmentSessions('AAMkADU5RpAACJlCs8AAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIBtw Content-Type: application/octet-stream Content-Length: 1386170 Content-Range: bytes 2097152-3483321/3483322 < > 
Отклик

В следующем примере отклика показан заголовок отклика Location , из которого можно сохранить идентификатор вложения ( AAMkADU5CCmSAAANZAlYPeyQByv7Y= ) для дальнейшего применения.

HTTP/1.1 201 Created Location: https://outlook.office.com/api/v2.0/Users('d3b9214b-dd8b-441d-b7dc-c446c9fa0e69@98a79ebe-74bf-4e07-a017-7b410848cb32')/Events('AAMkADU5CCmSAAA=')/Attachments('AAMkADU5CCmSAAANZAlYPeyQByv7Y=') Content-Length: 0 

Шаг 4 (необязательно). Получение вложенного файла из элемента Outlook

Как всегда, при получении вложения из элемента Outlook размер вложения не ограничивается технически.

Тем не менее, получение большого вложенного файла в формате кодировки base64 влияет на производительность API. Если ожидается вложение большого размера:

  • Вместо получения вложенного содержимого в формате base64 можно получить необработанные данные вложенного файла.
  • Чтобы получить метаданные вложенного файла, добавьте параметр $select , включающий только нужные свойства метаданных, исключая свойство contentBytes, которое возвращает вложенный файл в формате base64.

Пример: получение необработанного файла, вложенного в событие

После примера события и использования идентификатора вложения, возвращаемого в заголовке Location предыдущего шага, в примере запроса в этом разделе демонстрируется использование параметра $value для получения необработанных данных содержимого вложения.

Разрешения

Для этой операции необходимо использовать подходящее разрешение делегирования или приложения с минимальным уровнем привилегий, Calendars.Read . Дополнительные сведения см. в разделе Разрешения для календаря.

Запрос
Отклик
HTTP/1.1 200 OK content-length: 3483322 Content-type: image/jpeg

Пример: получение метаданных файла, вложенного в сообщение

После примера сообщения в примере запроса в этом разделе демонстрируется использование параметра $select для получения некоторых метаданных файла, вложенного в сообщение, кроме contentBytes.

Разрешения

Для этой операции необходимо использовать подходящее разрешение делегирования или приложения с минимальным уровнем привилегий, Mail.Read . Дополнительные сведения см. в разделе Разрешения для почты.

Запрос
Отклик
HTTP/1.1 200 OK Content-type: application/json < "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('a8e8e219-4931-95c1-b73d-62626fd79c32%4072aa88bf-76f0-494f-91ab-2d7cd730db47')/messages('AAMkADI5MAAIT3drCAAA%3D')/attachments/$entity", "@odata.type": "#microsoft.graph.fileAttachment", "@odata.mediaContentType": "image/jpeg", "id": "AAMkADI5MAAIT3drCAAABEgAQANAqbAe7qaROhYdTnUQwXm0=", "lastModifiedDateTime": "2019-09-24T23:27:43Z", "name": "flower", "contentType": "image/jpeg", "size": 3640066, "isInline": false >

Альтернатива: отмена сеанса отправки

Если необходимо отменить отправку в любое время до окончания срока действия сеанса отправки, можно использовать тот же самый начальный непрозрачный URL-адрес, чтобы удалить сеанс отправки. После успешной операции возвращается HTTP 204 No Content .

Разрешения

Поскольку исходный непрозрачный URL-адрес прошел предварительную проверку подлинности и содержит подходящий маркер авторизации для последующих запросов для этого сеанса отправки, не указывайте заголовок запроса на авторизацию для этой операции.

Пример: отмена сеанса отправки для сообщения

Запрос
DELETE https://outlook.office.com/api/v2.0/Users('a8e8e219-4931-95c1-b73d-62626fd79c32@72aa88bf-76f0-494f-91ab-2d7cd730db47')/Messages('AAMkADI5MAAIT3drCAAA=')/AttachmentSessions('AAMkADI5MAAIT3k0tAAA=')?authtoken=eyJhbGciOiJSUzI1NiIsImtpZCI6IktmYUNIUlN6bllHMmNI 
Отклик
HTTP/1.1 204 No content 

Ошибки

ErrorAttachmentSizeShouldNotBeLessThanMinimumSize

Эта ошибка возвращается при попытке создать сеанс отправки, чтобы вложить файл размером менее 3 МБ. Если размер файла меньше 3 МБ, следует выполнить одну операцию POST для свойства навигации attachmentsсообщения или события. Успешный отклик POST включает ИД файла, прикрепленного к сообщению.

При наличии большого файла данных Outlook может возникнуть приостановка работы приложения

При наличии большого файла данных Microsoft Outlook в профиле может возникнуть приостановка работы приложения. Чем больше файл данных, тем больше приостановок приложения может возникнуть.

Файлы данных Outlook могут быть файлами личных папок (PST) или файлов автономных папок (OST).

Причина

Эта проблема возникает, если размер файла данных Outlook — 10 гигабайт (ГБ) или более.

Решение

Чтобы устранить эту проблему, уменьшите размер файла данных Outlook путем перемещения или архивации элементов из файла.

Outlook 2007 и более поздние версии

Вы также можете использовать фильтры синхронизации для профилей режима кэширования, чтобы уменьшить размер .ost файла. В следующей записи блога описывается, как уменьшить размер локального файла данных с помощью фильтров синхронизации.

Это решение является стоп-кодом и предоставляется здесь для справки, если размер почтового ящика уменьшить нельзя. Например, вы не сможете уменьшить размер почтового ящика, если вам потребуется хранить архив всех отправленных и полученных сообщений электронной почты в течение нескольких лет.

Outlook 2013 и более поздние версии

В Outlook 2013 и более поздних версиях можно также попробовать использовать функцию «Синхронизировать ползунок» для профилей режима кэширования. Эта функция позволяет контролировать, сколько месяцев сообщений электронной почты синхронизируются с файлом .ost . Дополнительные сведения о функции синхронизации ползунка см. в разделе о синхронизации только подмножества элементов почтового ящика Exchange, синхронизированных в Outlook.

Дополнительные сведения

При наличии большого PST-файла .ost при выполнении типичных операций в Outlook может возникнуть приостановка работы приложения. Эти типичные операции включают чтение сообщений электронной почты, перемещение сообщений электронной почты и удаление сообщений электронной почты.

В следующем списке приводится сводка ожидаемого поведения в зависимости от размера файла данных Outlook.

  • До 5 ГБ. Этот размер файла должен обеспечить хорошее взаимодействие с пользователем на большинстве аппаратных устройств.
  • От 5 ГБ до 10 ГБ: этот размер файла обычно зависит от оборудования. Таким образом, если у вас быстрый жесткий диск и большой объем ОЗУ, ваш интерфейс будет лучше. Однако более медленные жесткие диски, такие как диски, которые обычно находятся на переносимых компьютерах или твердотельных накопителях раннего поколения (SSD), могут приостанавливать работу некоторых приложений при ответе дисков.
  • Более 10 ГБ. Когда .ost размер файла достигает этого размера, короткие паузы начинают выполняться на большинстве аппаратных компонентов.
  • Очень большой (25 ГБ или больше): .ost файл этого размера увеличивает частоту коротких приостановок, особенно при загрузке новых сообщений электронной почты. Однако для синхронизации почты вручную можно использовать группы отправки и получения.

Дополнительные сведения об устранении проблем с производительностью в Outlook см. в статье «Устранение неполадок с производительностью в Outlook».

Обратная связь

Были ли сведения на этой странице полезными?

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *