Esta página foi traduzida pela API Cloud Translation.

Visão geral dos apps para computador

A API Google Picker é uma maneira de permitir que os usuários selecionem ou façam upload de arquivos do Google Drive. Os usuários podem conceder permissão aos seus apps para computador para acessar os dados do Drive, oferecendo uma maneira segura e autorizada de interagir com os arquivos.

O Google Picker funciona como uma caixa de diálogo "Abrir arquivo" para arquivos armazenados no Drive e tem vários recursos:

Uma aparência semelhante à interface do Google Drive.
Várias visualizações mostrando prévias e miniaturas de arquivos do Drive.
Um redirecionamento para o Google Picker em uma nova guia no navegador padrão do usuário.

O Google Picker não permite que os usuários organizem, movam ou copiem arquivos de uma pasta para outra. Para gerenciar arquivos, use a API Google Drive ou a interface do Drive.

Pré-requisitos

Os apps que usam o Google Picker precisam obedecer a todos os Termos de Serviço. O mais importante é se identificar corretamente nas solicitações.

Você também precisa ter um projeto do Google Cloud.

Configurar o ambiente

Para começar a usar a API Google Picker, configure seu ambiente.

Ativar a API

Antes de usar as APIs do Google, é necessário ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.

No console do Google Cloud, ative a API Google Picker.

Ativar a API

crie uma chave de API

Uma chave de API é uma string longa que contém letras maiúsculas e minúsculas, números, sublinhados e hifens, como AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe. Esse método de autenticação é usado para acessar anonimamente dados disponíveis publicamente, como arquivos do Google Workspace compartilhados com a configuração "Qualquer pessoa na Internet com este link". Para mais detalhes, consulte Gerenciar chaves de API.

Para criar uma chave de API, siga estas etapas:

No console do Google Cloud, acesse Menu > APIs e serviços > Credenciais.
Ir para Credenciais
Clique em Criar credenciais > Chave de API.
Sua nova chave de API é exibida.
- Clique em Copiar para copiar a chave de API e usar no código do app. A chave de API também pode ser encontrada na seção "Chaves de API" das credenciais do seu projeto.
- Para evitar o uso não autorizado, recomendamos restringir os locais e as APIs em que a chave de API pode ser usada. Para mais detalhes, consulte Adicionar restrições de API.

Autorizar credenciais para um app para computador

Para autenticar usuários finais e acessar dados de usuários no app, crie um ou mais IDs do cliente OAuth 2.0. Um ID do cliente é usado para identificar um único app nos servidores OAuth do Google. Se o app for executado em várias plataformas, crie um ID do cliente separado para cada uma delas.

No console do Google Cloud, acesse Menu > Google Auth platform > Clientes.
Acesse "Clientes"
Clique em Criar cliente.
Clique em Tipo de aplicativo > App para computador.
No campo Nome, digite um nome para a credencial. Esse nome é mostrado apenas no console do Google Cloud.
Clique em Criar.
A credencial recém-criada aparece em "IDs de cliente OAuth 2.0".

Para que os apps recebam autorização para arquivos concedidos anteriormente, siga estas etapas:

Você precisa conseguir um token do OAuth 2.0 com o escopo drive.file, drive ou drive.readonly usando estas instruções: Como usar o OAuth 2.0 para acessar as APIs do Google. Para mais informações sobre escopos, consulte Escolher escopos da API Google Drive.
Transmita o token do OAuth 2.0 para a API Drive e leia e modifique arquivos em que o usuário concedeu acesso anteriormente.

Mostrar o Google Picker

A API Google Picker para apps de computador redireciona para o Google Picker em uma nova guia no navegador padrão do usuário. Depois que o usuário concede acesso e escolhe os arquivos relevantes, o Google Picker retorna ao app de chamada pelo URL de callback. Para abrir a API Google Picker em uma página do cliente, use a API Google Picker para apps da Web. Para mais informações, consulte Visão geral dos apps da Web.

Para permitir que os usuários concedam acesso a outros arquivos ou escolham arquivos para uso no fluxo do app para computador, siga estas etapas:

Solicite acesso ao escopo drive.file para abrir a página de acesso do OAuth 2.0 em uma nova guia do navegador usando estas instruções: Como usar o OAuth 2.0 para acessar as APIs do Google. Para mais informações sobre escopos, consulte Escolher escopos da API Google Drive.

Somente o escopo drive.file é permitido para apps de computador, e ele não pode ser combinado com nenhum outro escopo.

O URL da nova guia do navegador aceita todos os parâmetros padrão de string de consulta do OAuth.

É preciso anexar os parâmetros de URL prompt e trigger_onepick à sua solicitação de URL de autorização do OAuth 2.0. Também é possível personalizar o Google Picker com vários parâmetros opcionais:

Parâmetro	Descrição	Status
`prompt=consent`	Solicitar acesso ao arquivo.	Obrigatório
`trigger_onepick=true`	Ative o Google Picker.	Obrigatório
`allow_multiple=true`	Se for "true", permite que o usuário selecione vários arquivos.	Opcional
`mimetypes=MIMETYPES`	Uma lista separada por vírgulas de tipos MIME para filtrar os resultados da pesquisa. Se não estiver definido, os arquivos de todos os tipos MIME serão mostrados na visualização.	Opcional
`file_ids=FILE_IDS`	Uma lista separada por vírgulas de IDs de arquivo para filtrar os resultados da pesquisa. Se não for definido, todos os arquivos serão mostrados na visualização.	Opcional

O exemplo a seguir mostra uma solicitação de URL de autorização do OAuth 2.0:

https://accounts.google.com/o/oauth2/v2/auth? \
client_id=CLIENT_ID \
&scope=https://www.googleapis.com/auth/drive.file \
&redirect_uri=REDIRECT_URI \
&response_type=code \
&access_type=offline \
&prompt=consent \
&trigger_onepick=true

Substitua:

CLIENT_ID: o ID do cliente do app para computador.
REDIRECT_URI: para onde o servidor de autorização redireciona o navegador do usuário após a autenticação bem-sucedida. Por exemplo, https://www.cymbalgroup.com/oauth2callback.

O redirect_uri especificado precisa ser um URL HTTPS público. Se você quiser usar um protocolo personalizado ou um URL localhost para seu redirect_uri, use um URL HTTPS público que redirecione para o protocolo personalizado ou o URL localhost.

Depois que o usuário concede acesso e escolhe os arquivos relevantes, o OAuth redireciona para o redirect_uri especificado na solicitação com os seguintes parâmetros de URL anexados:
- picked_file_ids: se o usuário concedeu acesso e escolheu arquivos, uma lista separada por vírgulas de IDs de arquivos selecionados.
- code: o token de acesso ou o código de acesso com base no parâmetro response_type definido na solicitação. Esse parâmetro inclui um novo código de autorização.
- scope: os escopos incluídos na solicitação.
- error: se o usuário cancelou a solicitação no fluxo de consentimento, um erro será mostrado.
O exemplo a seguir mostra uma resposta de URL de autorização do OAuth 2.0:
```
https://REDIRECT_URI?picked_file_ids=PICKED_FILE_IDS&code=CODE&scope=SCOPES
```
Os apps precisam trocar o código de autorização da etapa 3 por um novo token do OAuth 2.0. Para mais informações, consulte Trocar código de autorização por tokens de atualização e de acesso.
Em seguida, os apps podem usar os IDs de arquivo do parâmetro de URL na etapa 3 e o token do OAuth 2.0 obtido na etapa 4 para chamar a API Drive. Para mais informações, consulte Visão geral da API Google Drive.