Referência ao OneDrive (pré-visualização)

Overview

Ferramentas disponíveis

getOneDrive

Obtém informações sobre o OneDrive do utilizador, incluindo metadados do drive, quotas e dados do proprietário.

Nenhum parâmetro necessário.

getFolderChildrenInMyOneDrive

Enumera os 20 principais ficheiros e pastas (DriveItems) contidos numa pasta pai especificada no OneDrive do utilizador.

Parâmetros opcionais:

• parentFolderId: ID da pasta principal cujos ficheiros e pastas queres listar (por defeito: 'root')

localizarFicheiroOuPastaNoMeuOneDrive

Encontra um ficheiro ou pasta (DriveItem) no OneDrive do utilizador através da consulta de pesquisa. Este método é mais eficiente do que pesquisar todos os ficheiros acessíveis se souber que o item está no OneDrive do utilizador.

Parâmetros necessários:

• searchQuery: Consulta de pesquisa; pode ser o nome completo do ficheiro ou parte dele

getFileOrFolderMetadataInMyOneDrive

Obtém metadados de um ficheiro ou pasta (DriveItem) do OneDrive do utilizador.

Parâmetros necessários:

• fileOrFolderId: ID do ficheiro ou pasta no OneDrive do utilizador

getFileOrFolderMetadataByUrl (obter metadados de arquivo ou pasta pelo URL)

Obtém metadados de um ficheiro ou pasta (DriveItem) a partir de uma URL de partilha. Apenas utilizadores com permissões explícitas existentes para aceder ao ficheiro podem obter os metadados.

Parâmetros necessários:

• fileOrFolderUrl: URL do ficheiro ou pasta. O URL não é utilizado para o partilhar com o utilizador; este já deve ter acesso explícito.

readSmallTextFileFromMyOneDrive

Lê (descarrega) um ficheiro de texto do OneDrive do utilizador.

Parâmetros necessários:

• fileId: ID do ficheiro (DriveItem) para ler ou descarregar

criarPequenoFicheiroDeTextoNoMeuOneDrive

Cria ou carrega um ficheiro de texto com menos de 5 MB para o OneDrive do utilizador.

Parâmetros necessários:

• nome do ficheiro: Nome do ficheiro a criar
• TextoConteúdo: Conteúdo textual do ficheiro.

Parâmetros opcionais:

• parentFolderId: ID da pasta pai (por defeito: 'root').

createFolderInMyOnedrive

Cria uma nova pasta (DriveItem) no OneDrive do utilizador como subpasta da pasta principal especificada. Se já existir uma pasta com o mesmo nome, o método adiciona um sufixo numérico (por exemplo, NewFolder (1)).

Parâmetros necessários:

• pastaNome: Nome da pasta a criar

Parâmetros opcionais:

• parentFolderId: ID da pasta pai (por defeito: 'root').

renomearFicheiroOuPastaNoMeuOneDrive

Renomeia um ficheiro ou pasta (DriveItem) no OneDrive do utilizador. O novo nome deve cumprir as convenções de nomeação.

Parâmetros necessários:

• fileOrFolderId: ID do ficheiro ou pasta a renomear
• NewFileOrFolderName: O novo nome do ficheiro ou pasta

Parâmetros opcionais:

• Etag: Valor ETag para controlo de concorrência. A operação só tem sucesso se o ETag atual do DriveItem coincidir

eliminarFicheiroOuPastaNoMeuOneDrive

Apaga um ficheiro ou pasta (DriveItem) do OneDrive do utilizador.

Parâmetros necessários:

• fileOrFolderId: ID do ficheiro ou pasta a eliminar

Parâmetros opcionais:

• Etag: Valor ETag para controlo de concorrência

partilharFicheiroOuPastaNoMeuOneDrive

Envia um convite de partilha para conceder permissões de leitura ou escrita num ficheiro ou pasta (DriveItem) no OneDrive do utilizador.

Parâmetros necessários:

• fileOrFolderId: ID do ficheiro ou pasta a partilhar
• E-mails do destinatário: Conjunto de endereços de email dos destinatários a convidar
• funções: Lista de funções a atribuir. Valores permitidos: 'ler', 'escrever' ('escrever' concede permissões de leitura e escrita)

Parâmetros opcionais:

• Mensagem: Mensagem personalizada para incluir no email de convite. Predefinição: 'Este é o ficheiro em que estamos a trabalhar em conjunto.'
• enviarConvido: Se devo enviar um convite para partilhar. Padrão: verdadeiro.

definirRotuloDeConfidencialidadeNoFicheiroNoMeuOneDrive

Define a etiqueta de sensibilidade de um ficheiro no OneDrive do utilizador.

Parâmetros necessários:

• fileId: ID do ficheiro (DriveItem)
• sensitivityLabelId: ID do rótulo de sensibilidade a atribuir, ou string vazia para remover

Parâmetros opcionais:

• assignmentMethod: Método de atribuição: 'standard', 'privileged', 'auto' ou 'unknownFutureValue' (por defeito: 'privileged')
• justificationText: Texto de justificação para efeitos de auditoria; necessário ao reduzir ou remover uma etiqueta (por defeito: 'Modificado por MCPServer')

createSmallBinaryFileInMyOnedrive

Cria um ficheiro binário com tamanho inferior a 5 MB ao codificar o seu conteúdo com base 64 no OneDrive do utilizador.

Parâmetros necessários:

• nome do ficheiro: Nome do ficheiro a criar, incluindo a extensão do ficheiro
• base64Conteúdo: O conteúdo binário do ficheiro codificado como uma string base64

Parâmetros opcionais:

• parentFolderId: ID da pasta pai (por defeito: 'root').

readSmallBinaryFileFromMyOneDrive

Lê um ficheiro binário inferior a 5 MB do OneDrive do utilizador. Devolve o conteúdo do ficheiro como uma cadeia codificada base64.

Parâmetros necessários:

• fileId: ID do ficheiro (DriveItem) para ler ou descarregar

copiarFicheiroOuPastaNoMeuOneDrive

Copia um ficheiro ou pasta (DriveItem) para uma pasta de destino dentro do OneDrive do utilizador. Esta operação é assíncrona. Usa checkOperationStatusInMyOnedrive para monitorizar o progresso.

Parâmetros necessários:

• sourcefileid: ID do ficheiro ou pasta de origem (DriveItem) para copiar
• destfolderid: ID da pasta de destino (deve existir no OneDrive do utilizador)

Parâmetros opcionais:

• newfilename: Novo nome para o item copiado (predefinido como o nome original)

moveFileOrFolderInMyOnedrive

Move um ficheiro ou pasta (DriveItem) para uma pasta de destino dentro do OneDrive do utilizador. Esta operação é assíncrona. Usa checkOperationStatusInMyOnedrive para monitorizar o progresso.

Parâmetros necessários:

• sourcefileid: ID do ficheiro ou pasta de origem (DriveItem) a mover
• destfolderid: ID da pasta de destino (deve existir no OneDrive do utilizador)

Parâmetros opcionais:

• newfilename: Novo nome para o item movido (por predefinição, o nome original)

checkOperationStatusInMyOnedrive

Verifica o estado de uma operação assíncrona, como copiar ou mover, usando o token de operação devolvido da operação original. Devolve informação de progresso se ainda estiver em andamento, detalhes de erro se falhar, ou os metadados finais do ficheiro ou pasta se concluídos com sucesso.

Parâmetros necessários:

• operationToken: O token de operação devolvido por uma operação assíncrona, tal como copyFileOrFolderInMyOnedrive ou moveFileOrFolderInMyOnedrive

Principais características

Gestão do OneDrive

• Obtém informações do OneDrive, como quota e proprietário
• Aceder ao OneDrive pessoal do utilizador
• Todas as operações visam o OneDrive do utilizador autenticado

Pesquisa e descoberta de ficheiros

• Pesquise ficheiros e pastas por nome dentro do OneDrive do utilizador
• Obtenha metadados de ficheiros ou pastas por ID ou URL de partilha
• Navegue pelo conteúdo da pasta (até 20 itens).

Operações de ficheiros

• Criar ficheiros de texto e binários (≤5 MB)
• Ler texto e ficheiros binários (≤5 MB)
• Eliminar ficheiros com controlo de concorrência
• Renomear ficheiros com proteção de eTag
• Copiar e mover ficheiros e pastas de forma assíncrona

Gestão de pastas

• Criar pastas com caminhos parentais opcionais
• Sufixo numérico automático para nomes de pastas duplicados.
• Lista de conteúdos das pastas (até 20 itens)
• Obter metadados da pasta
• Eliminar pastas com controlo de concorrência
• Renomear pastas protegidas por ETag

Compartilhamento e permissões

• Partilhe ficheiros e pastas com os utilizadores
• Controlo de acesso baseado em funções (leitura, escrita)
• Notificações por email para partilhar.
• Mensagens personalizadas nos convites.

Segurança e conformidade

• Aplique e remova etiquetas de sensibilidade.
• Use múltiplos métodos de atribuição, incluindo padrão, privilegiado e automático.
• Apoiem a justificação da auditoria.
• Use o controlo de concorrência com eTags.

Notes

• Todas as operações visam o OneDrive pessoal do utilizador autenticado.
• As operações de ficheiros são limitadas a ficheiros com 5 MB ou menos para upload e download.
• Operações de eliminação e renomeação suportam eTags para controlo de concorrência.
• A partilha requer endereços de email válidos e permissões adequadas.
• As etiquetas de sensibilidade exigem licença e configuração adequadas.
• A listagem de pastas apresenta, por defeito, um máximo de 20 itens.