Acessando dados do seu One Drive com R

Leia o post no blog da Curso-R: acesse aqui!

Introdução

Recentemente, escrevi um post sobre como é possível acessar dados do Google Sheets com R, além de importar respostas do Google Forms. Algumas pessoas comentaram que utilizam o One Drive, e perguntaram como funcionaria para importar tabelas que estão por lá. Como eu não uso One Drive, dei uma explorada para responder, e neste post falarei um pouco sobre como podemos importar dados que estão na conta do One Drive usando o pacote Microsoft365R.

O pacote Microsoft365R é uma interface para acessar o Microsoft 365, e segundo a documentação do pacote, possui funções para interagir com o Microsoft Teams, Outlook, SharePoint Online, e o OneDrive (que é o foco deste post!).

Primeiramente, é necessário instalar o pacote:

install.packages("Microsoft365R")

Então, podemos carregá-lo:

# Carregar pacote Microsoft365R
library(Microsoft365R)

Ao carregar o pacote pela primeira vez, a seguinte mensagem aparecerá, dizendo que é possível armazenar as credenciais em uma pasta chamada AzureR e perguntando se permitimos que o pacote crie esse diretório. Eu aceitei respondendo com Yes:

The AzureR packages can save your authentication credentials in the directory:

~/Library/Application Support/AzureR

This saves you having to re-authenticate with Azure in future sessions.
Create this directory? (Yes/no/cancel) 

Depois de responder com Yes, nada aparentemente acontece, porém o pacote é carregado!

Autenticação

Ao acessar pela primeira vez, o pacote abrirá uma aba do navegador para fazer a autenticação.

Neste exemplo, usarei a função Microsoft365R::get_personal_onedrive() que explicarei posteriormente. No console do R, aparecerá a seguinte mensagem ao utilizar alguma função pela primeira vez:

Microsoft365R::get_personal_onedrive()
# Using authorization_code flow
# Creating Microsoft Graph login for tenant 'consumers'
# Using authorization_code flow
# Waiting for authentication in browser...
# Press Esc/Ctrl + C to abort

O navegador abrirá uma janela para que a autenticação seja feita:

Após fazer a autenticação, a seguinte mensagem aparecerá no navegador:

Authenticated with Azure Active Directory. Please close this page and return to R.

Isso significa que podemos fechar a aba do navegador e retornar ao R. No console do R, aparecerá a seguinte mensagem:

Authentication complete.

Acesso de conta pessoal ou de trabalho?

O primeiro passo após autenticar é acessar o One Drive, e a função para fazer isso depende do tipo de acesso da conta: pessoal ou de trabalho. Como o meu acesso é pessoal, vou usar a função get_personal_onedrive(). Mas caso o seu acesso seja de trabalho, utilize a função get_business_onedrive(). É necessário executar a função e salvar o resultado em um objeto.

onedrive_da_bea <-  Microsoft365R::get_personal_onedrive()

Agora a forma de interagir com o pacote é um pouco diferente de como usamos na maior parte das vezes. Isso porque o pacote utiliza objetos que são da classe R6, e que permitem utilizar métodos. O foco deste post não é explicar o que são as classes R6, e escrevi este post pensando em ser útil para pessoas que também não conhecem as classes R6. Caso você tenha interesse em saber mais, deixei alguns links de referência no final do post.

Para conferir a classe desse objeto, podemos usar a função class():

class(onedrive_da_bea)
#> [1] "ms_drive"  "ms_object" "R6"  

Ao executar apenas o objeto, o console apresenta os métodos possíveis:

drive_da_bea

#> <Personal OneDrive of Beatriz Milz>
#>   directory id: df5a76afb6532845 
#> ---
#>   Methods:
#>     create_folder, create_share_link, delete,
#>     delete_item, do_operation, download_file,
#>     get_item, get_item_properties, get_list_pager,
#>     list_files, list_items, list_shared_files,
#>     list_shared_items, open_item,
#>     set_item_properties, sync_fields, update,
#>     upload_file

Sabendo o nome dos métodos, podemos usá-los usando o seguinte padrão: nome_do_objeto$nome_do_metodo()! Existem vários métodos, e vamos explorar os métodos relacionados à importação. Mas caso você use bastante o One Drive no seu dia-a-dia, recomendo experimentar os outros métodos, como os que servem para manipular arquivos (como criar, atualizar, deletar)!

Navegar nos arquivos do Drive

Para conseguir importar um arquivo, é necessário primeiramente encontrar o caminho até este arquivo. E isso funciona de forma similar aos caminhos que já conhecemos nos nossos projetos! Vamos usar o método list_files() para listar os arquivos presentes na pasta inicial do meu OneDrive. Como eu raramente uso ele, criei uma pasta de exemplo chamada pasta_de_exemplo, e dentro dela criei um arquivo Excel chamado pinguins. Veja que apareceu apenas a pasta, e não o conteúdo que ela armazena:

onedrive_da_bea$list_files() |> dplyr::glimpse()

#> Rows: 1
#> Columns: 4
#> $ name  <chr> "pasta_de_exemplo"
#> $ size  <int> 23041
#> $ isdir <lgl> TRUE
#> $ id    <chr> "DF5A76AFB6532845!4368"

Para ver os arquivos que estão dentro da pasta (e encontrar o excel pinguins), podemos usar o mesmo método utilizado acima, e informar o nome da pasta que queremos listar os arquivos.

onedrive_da_bea$list_files(path = "pasta_de_exemplo/") |> dplyr::glimpse()

#> Rows: 1
#> Columns: 4
#> $ name  <chr> "pinguins.xlsx"
#> $ size  <int> 23041
#> $ isdir <lgl> FALSE
#> $ id    <chr> "DF5A76AFB6532845!4369"

Importar o arquivo

Eu ainda não encontrei um método que permita ler o conteúdo de um Excel diretamente do OneDrive para o R (como fazemos com o Google Drive). Olhando nas issues do GitHub, parece que essa funcionalidade ainda não foi implementada até o momento, e algumas pessoas inclusive sugeriram melhorias neste sentido.

A forma que encontrei para importar um Excel do Ondrive foi fazer o download do arquivo Excel que está no Ondrive, e depois importar o arquivo salvo localmente. Para fazer o download e abrir um arquivo Excel, podemos usar o método download_file() para baixar o arquivo, e então a função readxl::read_excel() para importar o arquivo:

# baixar o arquivo
onedrive_da_bea$download_file("pasta_de_exemplo/pinguins.xlsx", 
                              dest = "pinguins_onedrive.xlsx")

# ler o arquivo baixado
pinguins_do_onedrive <- readxl::read_excel("pinguins_onedrive.xlsx")
dplyr::glimpse(pinguins_do_onedrive)
#>  Rows: 344
#>  Columns: 8
#>  $ especie               <chr> "Pinguim-de-adélia", "Pinguim-de-adé…
#>  $ ilha                  <chr> "Torgersen", "Torgersen", "Torgersen…
#>  $ comprimento_bico      <dbl> 39.1, 39.5, 40.3, NA, 36.7, 39.3, 38…
#>  $ profundidade_bico     <dbl> 18.7, 17.4, 18.0, NA, 19.3, 20.6, 17…
#>  $ comprimento_nadadeira <dbl> 181, 186, 195, NA, 193, 190, 181, 19…
#>  $ massa_corporal        <dbl> 3750, 3800, 3250, NA, 3450, 3650, 36…
#>  $ sexo                  <chr> "macho", "fêmea", "fêmea", NA, "fême…
#>  $ ano                   <dbl> 2007, 2007, 2007, 2007, 2007, 2007, …

Caso queira abrir o arquivo no navegador (para ver, compartilhar ou coisas similares), use o método open_item(), informando o caminho até o arquivo:

onedrive_da_bea$open_item(path = "pasta_de_exemplo/pinguins.xlsx") 

Conclusão

Espero que este post seja útil para quem usa o One Drive também. Também espero que o pacote seja aprimorado para conseguir importar os dados sem que seja necessário baixá-los.

Caso você encontre algum método melhor para importar os dados, conta pra gente!

Até a próxima!

Referências

• Documentação do pacote Microsoft365R - Vignette sobre o OneDrive

• GitHub do pacote Microsoft365R

• Referência da base dos pinguins

• Avançado: Referências sobre classes R6 em R

  • Documentação do pacote R6
  • Livro Advanced R

Licença de uso

Estes materiais são disponibilizados com a licença Creative Commons Atribuição-CompartilhaIgual (CC BY-SA), ou seja, você pode compartilhar e adaptar este material, porém deve atribuir os créditos para as pessoas autoras, adicionando um link para o material original, e o seu material também deve ter este mesmo tipo de licença.

Saiba mais em: Creative Commons