Referência do OneDrive Work IQ (versão prévia)

Overview

Ferramentas disponíveis

getOnedrive

Obtém informações sobre o OneDrive do usuário, incluindo metadados de unidade, cota e informações de proprietário.

Nenhum parâmetro é necessário.

getFolderChildrenInMyOnedrive

Enumera os 20 principais arquivos e pastas (DriveItems) contidos em uma pasta pai especificada no OneDrive do usuário.

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai cujos arquivos e pastas você deseja listar (padrão: 'raiz')

encontrarArquivoOuPastaNoMeuOnedrive

Localiza um arquivo ou pasta (DriveItem) no OneDrive do usuário por consulta de pesquisa. Esse método é mais eficiente do que pesquisar todos os arquivos acessíveis se você souber que o item está no OneDrive do usuário.

Parâmetros requeridos:

• Searchquery: Consulta de pesquisa; pode ser o nome inteiro ou parcial do arquivo

obterMetadadosDeArquivoOuPastaNoMeuOnedrive

Obtém metadados de um arquivo ou pasta (DriveItem) do OneDrive do usuário.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta no OneDrive do usuário

getFileOrFolderMetadataByUrl

Obtém metadados de um arquivo ou pasta (DriveItem) de uma URL de compartilhamento. Somente usuários com permissões explícitas existentes para acessar o arquivo podem obter os metadados.

Parâmetros requeridos:

• fileOrFolderUrl: URL do arquivo ou pasta. A URL não é resgatada para compartilhamento com o usuário; o usuário já deve ter acesso explícito.

LeituraDeArquivoTextoPequenoDoMeuOnedrive

Lê (baixa) um arquivo de texto do OneDrive do usuário.

Parâmetros requeridos:

• Idarquivo: ID do arquivo (DriveItem) para ler ou baixar

criarArquivoPequenoDeTextoNoMeuOnedrive

Cria ou carrega um arquivo de texto menor que 5 MB no OneDrive do usuário.

Parâmetros requeridos:

• Filename: Nome do arquivo a ser criado
• Contenttext: Conteúdo de texto do arquivo

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai (padrão: 'raiz')

createFolderInMyOnedrive

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

Parâmetros requeridos:

• Foldername: Nome da pasta a ser criada

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai (padrão: 'raiz')

renomearArquivoOuPastaNoMeuOnedrive

Renomeia um arquivo ou pasta (DriveItem) no OneDrive do usuário. O novo nome deve estar em conformidade com as convenções de nomenclatura.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta a ser renomeada
• newFileOrFolderName: O novo nome para o arquivo ou pasta

Parâmetros opcionais:

• Etag: Valor de ETag para controle de simultaneidade. A operação só terá êxito se a ETag atual do DriveItem for correspondente

excluirArquivoOuPastaNoMeuOnedrive

Exclui um arquivo ou pasta (DriveItem) do OneDrive do usuário.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta a ser excluída

Parâmetros opcionais:

• Etag: Valor de ETag para controle de simultaneidade

compartilharArquivoOuPastaNoMeuOnedrive

Envia um convite de compartilhamento para conceder permissões de leitura ou gravação em um arquivo ou pasta (DriveItem) no OneDrive do usuário.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta a ser compartilhada
• recipientEmails: Matriz de endereços de email de destinatários a serem convidados
• roles: matriz de funções a ser atribuída. Valores aceitos: 'leitura', 'gravação' (gravação concede acesso de leitura e gravação)

Parâmetros opcionais:

• Mensagem: Mensagem personalizada a ser incluída no email de convite. Padrão: "Aqui está o arquivo em que estamos colaborando."
• sendInvitation: Se deseja enviar um convite de compartilhamento. Padrão: verdadeiro.

definirEtiquetaDeSensibilidadeNoArquivoNoMeuOnedrive

Define o rótulo de confidencialidade de um arquivo no OneDrive do usuário.

Parâmetros requeridos:

• ID do arquivo: ID do arquivo (DriveItem)
• sensitivityLabelId: ID do rótulo de confidencialidade a ser atribuído ou cadeia de caracteres vazia a ser removida

Parâmetros opcionais:

• assignmentMethod: Método de atribuição: 'standard', 'privileged', 'auto' ou 'unknownFutureValue' (padrão: 'privileged')
• justificationText: Texto de justificativa para fins de auditoria; necessário ao fazer downgrade ou remover um rótulo (padrão: 'Alterado por MCPServer')

criarArquivoBinárioPequenoNoMeuOnedrive

Cria um arquivo binário de tamanho inferior a 5 MB codificando seu conteúdo em base64 para o OneDrive do usuário.

Parâmetros requeridos:

• Filename: Nome do arquivo a ser criado, incluindo a extensão de arquivo
• base64Content: O conteúdo do arquivo binário codificado como uma cadeia de caracteres base64

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai (padrão: 'raiz')

readSmallBinaryFileFromMyOnedrive

Lê um arquivo binário menor que 5 MB do OneDrive do usuário. Retorna o conteúdo do arquivo como uma cadeia de caracteres codificada em base64.

Parâmetros requeridos:

• Idarquivo: ID do arquivo (DriveItem) para ler ou baixar

copiarArquivoOuPastaNoMeuOnedrive

Copia um arquivo ou pasta (DriveItem) para uma pasta de destino no OneDrive do usuário. Esta operação é assíncrona. Use checkOperationStatusInMyOnedrive para monitorar o progresso.

Parâmetros requeridos:

• sourcefileid: ID do arquivo ou pasta de origem (DriveItem) para copiar
• destfolderid: ID da pasta de destino (deve existir no OneDrive do usuário)

Parâmetros opcionais:

• newfilename: Novo nome para o item copiado (padrão para o nome original)

moveFileOrFolderInMyOnedrive

Move um arquivo ou pasta (DriveItem) para uma pasta de destino dentro do OneDrive do usuário. Esta operação é assíncrona. Use checkOperationStatusInMyOnedrive para monitorar o progresso.

Parâmetros requeridos:

• sourcefileid: ID do arquivo ou pasta de origem (DriveItem) para mover
• destfolderid: ID da pasta de destino (deve existir no OneDrive do usuário)

Parâmetros opcionais:

• newfilename: Novo nome para o item movido (padrão para o nome original)

checkOperationStatusInMyOnedrive

Verifica o status de uma operação assíncrona, como copiar ou mover, usando o token de operação retornado da operação original. Retorna informações de progresso se ainda estiver em andamento, detalhes de erro se falharam ou os metadados finais de arquivo ou pasta, se concluídos com êxito.

Parâmetros requeridos:

• operationToken: o token de operação retornado de uma operação assíncrona como copyFileOrFolderInMyOnedrive ou moveFileOrFolderInMyOnedrive

Características principais

gerenciamento de OneDrive

• Obtém as informações do OneDrive, como cota e proprietário
• Acessar o OneDrive pessoal do usuário
• Todas as operações têm como destino o OneDrive do usuário autenticado

Pesquisa e descoberta de arquivos

• Pesquisar arquivos e pastas por nome no OneDrive do usuário
• Obter metadados de arquivo ou pasta por ID ou URL de compartilhamento
• Procurar conteúdo de pasta (até 20 itens)

Operações de arquivo

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

Gerenciamento de pastas

• Criar pastas com caminhos pai opcionais
• Sufixo numérico automático para nomes de pasta duplicados
• Listar o conteúdo da pasta (até 20 itens)
• Obter metadados de pasta
• Excluir pastas com controle de concorrência
• Renomear pastas com proteção de eTag

Compartilhamento e permissões

• Compartilhar arquivos e pastas com usuários
• Controle de acesso baseado em função (leitura, gravação)
• Notificações por email para compartilhamento
• Mensagens personalizadas em convites

Segurança e conformidade

• Aplicar e remover etiquetas de sensibilidade.
• Use vários métodos de atribuição, incluindo padrão, privilegiado e automático.
• Justificativa para auditoria de suporte.
• Use o controle de simultaneidade com eTags.

Notes

• Todas as operações têm como destino o OneDrive pessoal do usuário autenticado.
• As operações de arquivo são limitadas a arquivos com 5 MB ou menos para upload e download.
• As operações de exclusão e renomeação dão suporte a eTags para controle de simultaneidade.
• O compartilhamento requer endereços de email válidos e permissões apropriadas.
• Os rótulos de confidencialidade exigem o licenciamento e a configuração adequados.
• A listagem de pastas retorna um máximo de 20 itens por padrão.