Google Drive ofrece dos opciones para recopilar información sobre los usuarios de Drive:
Con el recurso
about
, puedes recuperar información sobre el usuario, su configuración de Drive y las capacidades del sistema.Con el recurso
apps
, puedes recuperar una lista de las apps instaladas por el usuario, con información sobre los tipos de MIME compatibles con cada app, las extensiones de archivo y otros detalles.
En esta guía, se explica cómo puedes recuperar la información de los usuarios en Drive.
Recupera información sobre un usuario
Para mostrar información de un usuario de Drive como una instancia de about
, usa el método about.get
. El método about.get
requiere el parámetro de consulta fields
en tu llamada de método. Los valores mostrados se miden en bytes. Si deseas obtener más información, consulta Cómo mostrar campos específicos para un archivo.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo proporcionar varios fields
como parámetro de consulta en la solicitud. La respuesta muestra los valores de campo de la solicitud.
Solicitud
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Respuesta
{ "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" } }
La respuesta incluye los siguientes valores:
DISPLAY_NAME
: Es el nombre del usuario en texto sin formato.PHOTO_LINK
: Es la URL de la foto de perfil del usuario.PERMISSION_ID
: Es el ID del usuario dentro de los recursosPermission
.EMAIL_ADDRESS
: Es la dirección de correo electrónico del usuario.
Recupera información sobre las apps de un usuario
Las apps para Google Drive se encuentran en Google Workspace Marketplace y se usan para que Drive sea más conveniente, como la app de Documentos de Google o un complemento que se usa dentro de Documentos para firmar documentos. Para obtener más información, consulta Cómo usar apps de Google Drive.
Para mostrar una lista de todas las apps instaladas por el usuario como una instancia de apps
, usa el método apps.list
sin ningún parámetro.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo mostrar una lista de todas las apps instaladas por el usuario en la solicitud. La respuesta muestra los valores de campo de la solicitud.
Solicitud
GET https://www.googleapis.com/drive/v3/apps
Respuesta
{ "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" ] }
La respuesta incluye los siguientes valores:
ID
: Es el ID de la app.PRODUCT_ID
: Es el ID de la ficha de producto de esta app.
Genera una lista de apps de usuario con parámetros de consulta
Para encontrar una app específica, usa uno o más de los parámetros de consulta opcionales:
appFilterExtensions
: Filtra los resultados de la búsqueda con una lista de extensiones de archivo separadas por comas. Las apps dentro del alcance de la búsqueda que pueden abrir las extensiones de archivo enumeradas se incluyen en la respuesta. Si también se proporcionaappFilterMimeTypes
, se muestra una unión de las dos listas de apps resultantes. Algunos ejemplos de extensiones incluyendocx
para Microsoft Word ypptx
para Microsoft PowerPoint. Para ver más ejemplos de extensiones de archivo, consulta Exporta tipos de MIME para documentos de Google Workspace.En la siguiente muestra de código, se indica cómo proporcionar varias extensiones de archivo como un parámetro de consulta:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: Filtra los resultados de la búsqueda con una lista separada por comas de tipos de MIME. Las apps dentro del alcance de la consulta que pueden abrir los tipos de MIME enumerados se incluyen en la respuesta. Si también se proporcionaappFilterExtensions
, se muestra una unión de las dos listas de apps resultantes. Algunos ejemplos de tipos de MIME incluyenapplication/vnd.google-apps.form
para Formularios de Google yapplication/vnd.google-apps.site
para Google Sites. Para ver más ejemplos de tipos de MIME, consulta Tipos de MIME compatibles con Google Workspace y Google Drive.En la siguiente muestra de código, se indica cómo proporcionar varios tipos de MIME como un 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 los resultados de la búsqueda con un código de idioma o configuración regional, según lo definido por BCP 47, con algunas extensiones del formato LDML de Unicode. Algunos ejemplos de códigos de idioma incluyenen-us
para inglés (Estados Unidos) yfr-ca
para francés (Canadá).En la siguiente muestra de código, se indica cómo proporcionar varios códigos de lenguaje como un parámetro de consulta:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Obtener la app del usuario por ID
Para descargar la información detallada de la app como una instancia de apps
, usa el método apps.get
con el ID de la app.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo proporcionar un appId
como parámetro de consulta en la solicitud. La respuesta muestra los valores de campo de la solicitud.
Solicitud
GET https://www.googleapis.com/drive/v3/apps/APP_ID
Respuesta
{ "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" }
La respuesta incluye los siguientes valores:
ID
: Es el ID de la app.PRODUCT_ID
: Es el ID de la ficha de producto de esta app.
Temas relacionados
Estos son algunos de los pasos que puedes seguir:
Para crear un archivo en Drive, consulta Cómo crear archivos.
Para subir datos de archivos cuando creas o actualizas un archivo, consulta Sube datos de archivos.
Para descargar y exportar archivos, consulta Descarga y exporta archivos.