Criar anexo

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.

Crie um objeto fileAttachment , que adiciona um anexo de imagem inline a uma nota. Apenas são suportados tipos de ficheiro de imagem (imagem/png, imagem/jpeg, imagem/gif ou imagem/bmp), com um tamanho máximo de 3 MB por anexo. Utilize a propriedade contentId para referenciar o anexo no corpo HTML de uma nota com <img src="cid:{contentId}" />.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) ShortNotes.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) ShortNotes.ReadWrite Indisponível.
Application ShortNotes.ReadWrite.All Indisponível.

Solicitação HTTP

POST /me/notes/{note-id}/attachments
POST /users/{id | userPrincipalName}/notes/{note-id}/attachments

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto fileAttachment .

Pode especificar as seguintes propriedades quando cria um anexo.

Propriedade Tipo Descrição
@odata.type Cadeia de caracteres O tipo de OData do recurso de anexo. Obrigatório. Definido como #microsoft.graph.fileAttachment
nome Cadeia de caracteres O nome do arquivo do anexo. Obrigatório.
contentType String O tipo de MIME do anexo. Tem de ser um tipo de imagem: image/png, image/jpeg, ou image/gifimage/bmp. Obrigatório.
contentBytes Cadeia de caracteres O conteúdo do arquivo codificado pela base64. Obrigatório.
contentId String O ID utilizado para referenciar o anexo no corpo HTML através de cid:. Obrigatório.
isInline Booliano Indica se o anexo é um anexo inline. Tem de estar definido como true para anexos de notas. Obrigatório.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto de anexo no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/me/notes/AAMkAGI2THVSAAA=/attachments
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "name": "screenshot.png",
  "contentType": "image/png",
  "contentBytes": "iVBORw0KGgoAAAANSUhEUgAAAAUA...",
  "contentId": "screenshot-001",
  "isInline": true
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "id": "AAMkAGI2attach2",
  "name": "screenshot.png",
  "contentType": "image/png",
  "size": 12456,
  "isInline": true,
  "contentId": "screenshot-001",
  "lastModifiedDateTime": "2024-01-29T11:30:00Z"
}
  • Last updated on