Pular para conteúdo

Ações do OneDrive

As ações do OneDrive permitem a interação com arquivos e pastas do OneDrive usando a Microsoft Graph API.

Ações

onedrive.get_client

Cria uma instância do GraphServiceClient para interagir com o OneDrive.

Parâmetros:

  • client_id – ID do aplicativo Azure.
  • tenant_id – ID do tenant do Azure.
  • client_secret – Secret do aplicativo Azure.

Retorno:

  • client – Instância do GraphServiceClient.

Exceções:

  • InvalidParameters – Se algum parâmetro obrigatório estiver ausente.
  • WrongVarType – Se algum parâmetro tiver tipo incorreto.
  • AzureClientAuthenticationError – Se a autenticação falhar.
  • ConnectionException – Para problemas inesperados de conexão.

onedrive.get_user_id

Obtém o ID do usuário do OneDrive a partir de um e-mail.

Parâmetros:

  • client – Instância do GraphServiceClient.
  • target_user_email – E-mail do usuário alvo.

Retorno:

  • user_id – ID do usuário alvo.

Exceções:

  • InvalidParameters, WrongVarType, AzureClientAuthenticationError, MicrosoftGraphAPIError, ConnectionException

onedrive.get_drive_id

Obtém o ID do drive do OneDrive de um usuário específico.

Parâmetros:

  • client – Instância do GraphServiceClient.
  • user_id – ID do usuário alvo.

Retorno:

  • drive_id – ID do drive do OneDrive do usuário.

Exceções:

  • InvalidParameters, WrongVarType, AzureClientAuthenticationError, MicrosoftGraphAPIError, ConnectionException

onedrive.get_items_by_path

Obtém itens de uma pasta do OneDrive filtrando por regex opcional.

Parâmetros:

  • client – Instância do GraphServiceClient.
  • drive_id – ID do drive do usuário alvo.
  • path – Caminho para busca.
  • regex (opcional) – Regex para filtrar os itens pelo nome.

Retorno:

  • total – Número de itens encontrados.
  • items – Lista de itens com nome, id, tipo e lastModifiedDateTime.

Exceções:

  • InvalidParameters, WrongVarType, AzureClientAuthenticationError, MicrosoftGraphAPIError, OneDriveFolderNotFound, ConnectionException

onedrive.download_file_by_id

Baixa um arquivo do OneDrive pelo seu ID.

Parâmetros:

  • client – Instância do GraphServiceClient.
  • drive_id – ID do drive do usuário alvo.
  • item_id – ID do arquivo.
  • download_path – Caminho para salvar o arquivo baixado.

Retorno:

  • download_path – Caminho onde o arquivo foi salvo.

Exceções:

  • InvalidParameters, WrongVarType, AzureClientAuthenticationError, MicrosoftGraphAPIError, OneDriveFolderNotFound, ConnectionException

onedrive.move_item

Move um item do OneDrive para outra pasta.

Parâmetros:

  • client – Instância do GraphServiceClient.
  • drive_id – ID do drive do usuário alvo.
  • item_id – ID do item a ser movido.
  • destination_id – ID da pasta de destino.
  • new_name (opcional) – Novo nome para o item.

Retorno:

  • id – ID do item movido.
  • name – Nome do item movido.
  • parent_reference_id – ID da pasta de destino.

Exceções:

  • InvalidParameters, WrongVarType, AzureClientAuthenticationError, MicrosoftGraphAPIError, OneDriveFolderNotFound, ConnectionException