Diretrizes para acessar o OneDrive via aplicativo

Applies to Windows and Windows Phone

Siga estas diretrizes para criar um aplicativo da Windows Store que interaja com os arquivos, documentos, imagens, vídeos, pastas, álbuns ou comentários do usuário do OneDrive.

O que fazer e o que não fazer

Os usuários do OneDrive presumem que a Microsoft trabalha para proteger a segurança e a privacidade de seus dados. Eles confiam no OneDrive para ajudar a preservar documentos importantes, salvar fotos e compartilhar experiências com amigos. Seu aplicativo pode agregar valor ao OneDrive dos usuários, fornecendo acesso bem cuidado e projetado aos respectivos dados.

Para manter a confiança que os usuários depositam no OneDrive, o seu aplicativo deve seguir estes princípios de design.

Possibilite a aceitação do usuário

Os usuários querem escolher como os aplicativos tratam seus dados. Eles esperam que o aplicativo peça permissão antes de se conectar a suas contas. Eles querem ser notificados antes dos dados serem alterados. Para atender a essas expectativas, siga estas práticas:

  • Carregue arquivos no OneDrive somente em resposta a uma solicitação ou opção explícita do usuário.

    Um aplicativo que se conecta ao OneDrive deve incluir um botão que permita aos usuários carregar intencionalmente seus arquivos no OneDrive. Se o aplicativo sincronizar os arquivos com o OneDrive por padrão, informe o usuário sobre isso e ofereça uma oportunidade para que ele aceite antes dos dados serem salvos.

  • Faça a entrada e saída dos usuários de suas contas usando o botão Conta.

    Conforme explicado em Procedimento de entrada e saída dos usuários de suas contas da Microsoft, o aplicativo deve fornecer aos usuários uma maneira de entrar e sair ativamente de suas contas da Microsoft. (Lembre-se de que, se o usuário tiver entrado no Windows usando a conta da Microsoft, o aplicativo não poderá desconectá-lo explicitamente.)

    Para saber mais, veja Diretrizes para a experiência de entrada na conta da Microsoft.

  • Acesse apenas os arquivos de propriedade do usuário conectado.

    A menos que o aplicativo tenha como finalidade compartilhar arquivos entre usuários do OneDrive, assegure-se de que ele acesse apenas os arquivos do usuários conectado. Seu aplicativo deverá acessar arquivos e pastas que foram compartilhados com o usuário somente se o usuário solicitar. De forma correspondente, o aplicativo não deve salvar arquivos em pastas compartilhadas, a menos que essa seja a opção do usuário.

  • Dê aos usuários a opção de onde eles desejam armazenar os dados no OneDrive.

    Seu aplicativo pode usar o seletor de arquivos do Windows usando o namespace Windows.Storage.Pickers para abrir e salvar arquivos no OneDrive do usuário. Se o aplicativo sincronizar vários arquivos, considere a criação de uma subpasta com um nome exclusivo nas pastas do usuário.

    Para saber mais sobre como usar um seletor de arquivos ao abrir um arquivo do OneDrive, veja Pastas e arquivos.

Ajude a proteger os dados e a privacidade do usuário

Seu aplicativo não pode abalar a confiança do usuário no OneDrive. Trate os dados do usuário de forma discreta. Os usuários pressupõem que seus arquivos são compartilhados apenas com as pessoas selecionadas por eles. Suas informações importantes devem ser preservadas de forma que eles possam retornar a elas quando necessário.

Importante  Depois de definidas, o aplicativo não pode alterar as permissões configuradas em um objeto do OneDrive de forma programática.

  • Por padrão, carregue arquivos no OneDrive com aceso de usuário único.

    Compartilhe arquivos com terceiros somente se o usuário solicitar especificamente que os arquivos sejam compartilhados.

  • Avise o usuário sobre o compartilhamento de links para arquivos com outras pessoas.

    Quando os usuários solicitarem o compartilhamento de um link para seus arquivos, faça o aplicativo informá-los sobre as consequências do compartilhamento. Em particular, se o aplicativo permitir que os usuários compartilhem links pré-autenticados para seus arquivos, informe-os de que qualquer pessoa que receber o link poderá exibir os arquivos. As permissões de arquivos desses links não são avaliadas e qualquer pessoa que abrir o link poderá exibir seu conteúdo.

    Para saber mais, veja Conceitos básicos do OneDrive.

  • Crie links para objetos do OneDrive de forma intencional, com base na utilização do link.

    Sempre que possível, compartilhe links inseridos, somente leitura e leitura-gravação. Esses links funcionarão apenas para usuários com permissão para exibir o arquivo. Forneça links pré-autenticados para arquivos somente quando o usuário deseja compartilhar uma pasta ou um arquivo com pessoas específicas. As permissões de arquivos desses links não são avaliadas e qualquer pessoa que abrir o link poderá exibir seu conteúdo.

    Para saber mais, veja Conceitos básicos do OneDrive.

  • Alerte o usuário ao substituir um arquivo existente.

    Ao carregar um arquivo no OneDrive, o comportamento padrão de carregamento é substituir qualquer arquivo existente com o mesmo nome. Em caso de conflitos, informe o usuário que um arquivo existente será substituído. Você pode adicionar um cabeçalho Overwrite definido como 'falso' para evitar que um arquivo seja substituído.

Use o OneDrive e o Windows de acordo com suas finalidades

É tentador usar o armazenamento disponível gratuitamente por meio do OneDrive como uma solução genérica de dados em nuvem. Embora apresente muitas opções para um aplicativo da Windows Store, o OneDrive fornece os melhores benefícios para seu aplicativo quando usado conforme sua finalidade. O OneDrive foi criado para fornecer aos usuários acesso a seus documentos, fotos e outras informações importantes em qualquer dispositivo.

  • Use o OneDrive para armazenar, exibir, editar documentos, ou criar e compartilhar álbuns de fotos.

    O OneDrive não tem como finalidade ser uma alternativa ao armazenamento de banco de dados escalonáveis, ao compartilhamento de arquivos de configuração ou à hospedagem de aplicativos Web (esses são apenas alguns exemplos). Ele se destina unicamente ao armazenamento e compartilhamento fácil de arquivos limitados do usuário.

  • Verifique se o usuário tem espaço no OneDrive antes de carregar um arquivo.

    Cada usuário do OneDrive tem uma quantidade limitada de armazenamento disponível. Se o seu aplicativo tentar salvar um arquivo que vai além da cota alocada na conta do usuário, a chamada retornará um erro. A prática recomendada é verificar o armazenamento disponível do usuário antes de salvar um arquivo no OneDrive.

    Para saber mais sobre como verificar o espaço disponível no OneDrive, veja Tarefas comuns.

  • Use os recursos internos do Windows.

    Sempre que possível, use os recursos e a interface do usuário do Windows para hospedar ou interagir com o OneDrive. Por exemplo, use o seletor de arquivos fornecido pelo namespace Windows.Storage.Pickers para abrir e salvar arquivos. Como outro exemplo, faça seu aplicativo usar as APIs de Dados de aplicativos do Windows para salvar porções menores de dados em vários dispositivos do usuário.

    Para saber mais sobre como usar um seletor de arquivos para abrir um arquivo do OneDrive, veja Pastas e arquivos.

    Para saber mais sobre como usar as APIs de Dados de aplicativos do Windows, veja Diretrizes para mobilidade de dados de aplicativos e Guia de início rápido: dados de aplicativos em roaming.

Diretrizes de uso adicional

O OneDrive fornece aos usuários um local confiável e acessível para armazenar seus arquivos na nuvem. Os usuários podem acessar os arquivos do OneDrive em qualquer dispositivo para Windows. Bastar entrar em suas contas da Microsoft. O OneDrive fornece aos usuários 7 GB de armazenamento gratuito, que podem ser usados para salvar e compartilhar suas fotos, documentos, vídeos e arquivos de áudio.

Seu aplicativo da Windows Store pode permitir que os usuários acessem arquivos e pastas no OneDrive. Através da conexão com o OneDrive, seu aplicativo permite que os usuários abram, leiam, salvem e baixem arquivos do OneDrive sem desorganizar o disco rígido. As APIs do OneDrive são criadas para serem usadas dentro de aplicativos da Windows Store e se integram de forma suave ao design do seu aplicativo.

Designs de aplicativos para usar o OneDrive

De forma ampla, o OneDrive pode ter uma função para qualquer aplicativo que interaja com arquivos discretos. Se o seu aplicativo lê ou exibe arquivos, salva arquivos ou baixa ou abre arquivos, você pode adicionar o OneDrive ao design do aplicativo. O OneDrive se integra bem à arquitetura do seu aplicativo da Windows Store, fazendo uso dos recursos internos do Windows sem exigir que você escreva códigos adicionais.

Importante  As APIs do OneDrive encontram-se no SDK do Live Connect. Antes de começar a desenvolver um aplicativo da Windows Store que se conecta ao OneDrive, você precisa instalar o SDK do Live Connect e adicionar uma referência a ele em seu projeto.

Procedimento de entrada e saída dos usuários de suas contas da Microsoft

Claro, qualquer aplicativo que interaja com o OneDrive deve fornecer ao usuário uma forma de entrar e sair da conta da Microsoft associada ao OneDrive. Embora isso não faça parte do design do aplicativo propriamente dito, a entrada dos usuários na conta é uma etapa crítica da criação de um aplicativo integrado ao OneDrive.

A técnica recomendada para a entrada dos usuários é criar uma página Contas e uma página da Política de privacidade no botão Configurações do aplicativo. A página Contas deve fornecer um botão de entrada e de saída que conecta e desconecta os usuários de suas contas. A interface do usuário do Windows trata do restante do processo de entrada do aplicativo.

Para saber mais, veja estes recursos:

Salvando arquivos novos ou atualizando arquivos existentes no OneDrive

Alguns usuários usam o OneDrive como se fosse 'Meus Documentos'. Para os usuários que preferem usar o OneDrive para armazenar seus arquivos, o aplicativo pode fornecer a opção de salvar dados no OneDrive. Por exemplo, quando eles criarem arquivos novos no aplicativo, você pode oferecer o OneDrive como um local para salvar. Quando eles editarem arquivos no aplicativo, eles poderão salvar as edições novamente no OneDrive.

De forma realista, qualquer aplicativo que permita aos usuários criar novos arquivos pode aproveitar as vantagens do acesso dos usuários ao OneDrive.

  • Para obter diretrizes de como criar um aplicativo integrado ao OneDrive, consulte a seção O que fazer e o que não fazer.
  • Para saber mais sobre como carregar imagens, vídeos e arquivos de áudio do OneDrive do usuário, veja Álbuns, fotos, vídeos, áudio e marcas.
  • Para saber mais sobre como salvar e atualizar um arquivo no OneDrive do usuário, veja Pastas e arquivos.

Baixando, abrindo e exibindo arquivos do OneDrive

Como observamos antes, alguns usuários mantêm muitos de seus dados na nuvem. Eles esperam poder ver os dados contidos ali. Seu aplicativo pode oferecer aos usuários a opção de abrir e ler arquivos no OneDrive. O aplicativo pode baixar, abrir e exibir o conteúdo do arquivo para o usuário visualizar.

Por exemplo, se o aplicativo reproduzir vídeos, você pode permitir que os usuários abram filmes de suas pastas do OneDrive. Ou o aplicativo pode permitir que os usuários abram e vejam um tipo de arquivo específico, como um leitor.

Observação  Recomendamos que seu aplicativo da Windows Store faça mais do que apenas permitir que os usuários vejam os arquivos contidos no OneDrive. O Windows é fornecido com um aplicativo OneDrive. É mais provável que os usuários baixem e instalem seu aplicativo se ele lhes fornecer uma experiência exclusiva.

Para saber mais, examine estes recursos:

  • Para obter diretrizes de como criar um aplicativo integrado ao OneDrive, consulte a seção O que fazer e o que não fazer.
  • Para saber mais sobre como baixar e exibir imagens, vídeos e arquivos de áudio do OneDrive do usuário, veja Alguns, fotos, vídeos, áudio e marcas.
  • Para saber mais sobre como baixar e abrir um arquivo do OneDrive do usuário, veja Pastas e arquivos.

Tópicos relacionados

Para designers
API do OneDrive
Conceitos básicos do OneDrive
Para desenvolvedores (HTML)
OneDrive para desenvolvedores
Tarefas comuns
Pastas e arquivos
API JavaScript
Para desenvolvedores (XAML)
OneDrive para desenvolvedores
Pastas e arquivos
API gerenciada

 

 

Mostrar:
© 2014 Microsoft