O Google Drive oferece duas opções para coletar informações sobre os usuários do Drive:
Com o recurso
about
, é possível recuperar informações sobre o usuário, as configurações do Drive e os recursos do sistema dele.Com o recurso
apps
, é possível extrair uma lista dos apps instalados do usuário, com informações sobre os tipos MIME com suporte de cada app, extensões de arquivo e outros detalhes.
Este guia explica como recuperar informações de usuários no Drive.
Buscar informações sobre um usuário
Para retornar informações sobre um usuário do Drive como uma instância de about
, use o método about.get
. O método about.get
requer o parâmetro de consulta fields
na chamada do método. Os valores retornados são medidos em bytes. Para saber mais, consulte Retornar campos específicos
de um arquivo.
Mostrar um exemplo
O exemplo de código a seguir mostra como fornecer vários fields
como um parâmetro de consulta na solicitação. A resposta retorna os valores de campo para a solicitação.
Solicitação
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Resposta
{ "kind": "drive#about", "user": { "kind": "drive#user", "displayName": "DISPLAY_NAME", "photoLink": "PHOTO_LINK", "me": true, "permissionId": "PERMISSION_ID", "emailAddress": "EMAIL_ADDRESS" }, "storageQuota": { "usage": "10845031958", "usageInDrive": "2222008387", "usageInDriveTrash": "91566" } }
A resposta inclui os seguintes valores:
DISPLAY_NAME
: o nome do usuário em texto simples.PHOTO_LINK
: o URL da foto do perfil do usuário.PERMISSION_ID
: o ID do usuário nos recursosPermission
.EMAIL_ADDRESS
: o endereço de e-mail do usuário
Buscar informações sobre os apps de um usuário
Os aplicativos do Google Drive estão listados no Google Workspace Marketplace e são usados para tornar o Drive mais conveniente, como o app Documentos Google ou um complemento usado no Documentos para assinar documentos. Para mais informações, consulte Usar os aplicativos do Google Drive.
Para retornar uma lista de todos os apps instalados do usuário como uma instância de
apps
, use o método
apps.list
sem nenhum
parâmetro.
Mostrar um exemplo
O exemplo de código a seguir mostra como retornar uma lista de todos os apps instalados do usuário na solicitação. A resposta retorna os valores de campo para a solicitação.
Solicitação
GET https://www.googleapis.com/drive/v3/apps
Resposta
{ "kind": "drive#appList", "selfLink": "https://www.googleapis.com/drive/v3/apps", "items": [ { "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" } ], "defaultAppIds": [ "ID" ] }
A resposta inclui os seguintes valores:
ID
: o ID do app.PRODUCT_ID
: o ID das informações do produto do app.
Listar apps do usuário com parâmetros de consulta
Para encontrar um app específico, use um ou mais dos parâmetros de consulta opcionais:
appFilterExtensions
: filtre os resultados da pesquisa usando uma lista de extensões de arquivo separada por vírgulas. Os apps no escopo da consulta do app que podem abrir as extensões de arquivo listadas são incluídos na resposta. SeappFilterMimeTypes
também forem fornecidos, uma união das duas listas de apps resultantes será retornada. Exemplos de extensões incluemdocx
para Microsoft Word epptx
para Microsoft PowerPoint. Para mais exemplos de extensões de arquivo, consulte Exportar tipos MIME para documentos do Google Workspace.O exemplo de código a seguir mostra como fornecer várias extensões de arquivo como um parâmetro de consulta:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: filtre os resultados da pesquisa usando uma lista separada por vírgulas de tipos MIME. Os apps no escopo da consulta do app que podem abrir os tipos MIME listados são incluídos na resposta. SeappFilterExtensions
também forem fornecidos, uma união das duas listas de apps resultantes será retornada. Exemplos de tipos MIME incluemapplication/vnd.google-apps.form
para o Formulários Google eapplication/vnd.google-apps.site
para o Google Sites. Para mais exemplos de tipos MIME, consulte Tipos MIME compatíveis com o Google Workspace e o Google Drive.O exemplo de código a seguir mostra como fornecer vários tipos MIME como um parâmetro de consulta:
GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site
.languageCode
: filtra os resultados da pesquisa usando um código de localidade ou idioma, conforme definido pelo BCP 47, com algumas extensões do formato LDML do Unicode. Exemplos de códigos de idioma incluemen-us
para inglês (Estados Unidos) efr-ca
para francês (Canadá).O exemplo de código a seguir mostra como fornecer vários códigos de idioma como parâmetro de consulta:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Acessar o app do usuário pelo ID
Para fazer o download das informações detalhadas do app como uma instância de
apps
, use o método
apps.get
com o ID do app.
Mostrar um exemplo
O exemplo de código a seguir mostra como fornecer um appId
como parâmetro de consulta na solicitação. A resposta retorna os valores de campo para a solicitação.
Solicitação
GET https://www.googleapis.com/drive/v3/apps/APP_ID
Resposta
{ "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" }
A resposta inclui os seguintes valores:
ID
: o ID do app.PRODUCT_ID
: o ID das informações do produto do app.
Temas relacionados
Confira aqui o que pode ser feito:
Para criar um arquivo no Drive, consulte Criar arquivos.
Para fazer upload de dados de arquivos ao criar ou atualizar um arquivo, consulte Fazer upload de dados do arquivo.
Para fazer o download e exportar arquivos, consulte Fazer o download e exportar arquivos.