Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
O tipo base para vários tipos de anexos em uma postagem de usuário, mensagem, tarefa ou grupo que serve como recurso base para os seguintes tipos derivados de anexos:
- Um arquivo (recurso fileAttachment)
- Um item (contato, evento ou mensagem, representado por um recurso itemAttachment )
- Um link para um arquivo (recurso referenceAttachment)
Você pode adicionar conteúdo relacionado a um evento de usuário, mensagem, tarefa do Outlook ou postagem de grupo na forma de um anexo.
Cuidado
As tarefas do Outlook foram preteridas e pararam de retornar dados em 10 de agosto de 2022. Atualize os aplicativos existentes que usam esse recurso com tarefas do Outlook.
Os eventos em calendários de grupo não têm suporte para anexos.
As tarefas do Outlook não oferecem suporte a anexos de referência.
Observação: se você estiver anexando um arquivo a uma postagem de grupo ou anexando um item a um evento, mensagem ou postagem de grupo, limite o tamanho do anexo a 3 MB.
Se você estiver anexando um arquivo com menos de 3 MB, poderá adicionar o anexo de arquivo a um evento de usuário, a uma mensagem ou a uma postagem de grupo.
Se você estiver anexando um arquivo entre 3 MB e 150 MB a um evento ou mensagem, poderá criar uma sessão de upload e carregar iterativamente intervalos do arquivo para anexá-lo. Confira anexar arquivos grandes a mensagens do Outlook para obter um exemplo.
Métodos
Os métodos a seguir se aplicam a qualquer um dos tipos de anexo derivados (fileAttachment, itemAttachment ou referenceAttachment).
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Get | attachment | Leia as propriedades, relações ou conteúdo bruto de um anexo anexado a um evento de usuário, mensagem, tarefa do Outlook ou postagem. |
| Delete | Nenhum | Exclua um anexo em um evento, mensagem, tarefa do Outlook ou postagem. |
| Adicionar anexo a um evento do usuário | attachment | Adicione um arquivo, item ou anexo de link a um evento em um calendário de usuário. Esta operação limita o tamanho do anexo que você pode adicionar a menos de 3 MB. |
| Adicionar um anexo a uma mensagem | attachment | Adicione um arquivo, item ou anexo de link a uma mensagem. Esta operação limita o tamanho do anexo que você pode adicionar a menos de 3 MB. |
| Criar sessão para anexar um arquivo grande | uploadSession | Crie uma sessão de upload que permita que um aplicativo carregue iterativamente intervalos de um arquivo, de modo a anexar o arquivo à mensagem ou ao evento especificado. O tamanho do arquivo deve estar entre 3 MB e 150 MB. |
| Adicionar anexo a uma tarefa do Outlook (preterido) | attachment | Adicione um anexo de arquivo ou item a uma tarefa do Outlook. |
| Adicionar anexo a uma postagem | attachment | Adicione um arquivo, item ou link de anexo a uma postagem de grupo. Esta operação limita o tamanho do anexo que você pode adicionar a menos de 3 MB. |
| Listar anexos de um evento de usuário | Coleção attachment | Obtenha uma lista de anexos de um evento em um calendário de usuário. |
| Listar anexos de uma mensagem | Coleção attachment | Obtenha uma lista de anexos de uma mensagem. |
| Listar anexos de uma tarefa do Outlook (obsoleta) | Coleção attachment | Obtenha uma lista de anexos para uma tarefa do Outlook. |
| Listar anexos de uma postagem | Coleção attachment | Obtenha uma lista de anexos de uma postagem. |
Propriedades
A seguir estão as propriedades de base de qualquer recurso de anexo. Consulte o tipo de anexo específico (fileAttachment, itemAttachment ou referenceAttachment) para propriedades adicionais.
| Propriedade | Tipo | Descrição |
|---|---|---|
| contentType | String | O tipo MIME. |
| id | String | Somente leitura. |
| isInline | Booliano |
true se o anexo for embutido; caso contrário, false. |
| lastModifiedDateTime | DateTimeOffset | O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| nome | Cadeia de caracteres | O nome de exibição do anexo. Não precisa ser o nome real do arquivo. |
| size | Int32 | O comprimento do anexo em bytes. |
Relações
Nenhum
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"contentType": "string",
"id": "string (identifier)",
"isInline": true,
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"size": 1024
}