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 embutida a uma anotação. Apenas tipos de arquivo de imagem (imagem/png, imagem/jpeg, imagem/gif ou imagem/bmp) são suportados, com um tamanho máximo de 3 MB por anexo. Use a propriedade contentId para fazer referência ao anexo no corpo HTML de uma nota usando <img src="cid:{contentId}" />.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) ShortNotes.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) ShortNotes.ReadWrite Indisponível.
Aplicativo Sem suporte. Sem suporte.

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 da solicitação, forneça uma representação JSON do objeto fileAttachment .

Você pode especificar as propriedades a seguir ao criar um anexo.

Propriedade Tipo Descrição
@odata.type Cadeia de caracteres O tipo 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 MIME do anexo. Deve ser um tipo de imagem: image/png, image/jpeg, image/gif, ou image/bmp. Obrigatório.
contentBytes Cadeia de caracteres O conteúdo do arquivo codificado pela base64. Obrigatório.
contentId String A ID usada para referenciar o anexo no corpo do HTML por meio do cid:. Obrigatório.
isInline Booliano Indica se o anexo é um anexo embutido. Deve ser definido como true para anexos de anotações. Obrigatório.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created 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