Información del usuario que se muestra

Google Drive proporciona dos opciones para recopilar información sobre los usuarios de Drive:

• Con el recurso about, puedes recuperar información sobre el usuario, la configuración de Drive del usuario y sus capacidades del sistema.

• Con el apps recurso, puedes recuperar una lista de las apps instaladas del usuario, con información sobre los tipos de MIME, las extensiones de archivo y otros detalles compatibles con cada app.

En esta guía, se explica cómo puedes recuperar información del usuario en Drive.

Obtén detalles sobre un usuario

Para mostrar información sobre un usuario de Drive como una instancia de about, usa el get método. Los valores que se muestran se miden en bytes.

Debes establecer el fields parámetro del sistema en el método get para especificar los campos que se mostrarán en la respuesta. En la mayoría de los métodos de Drive, esta acción solo es necesaria para mostrar campos no predeterminados, pero es obligatoria para el recurso about. Si omites el parámetro, el método muestra un error. Para obtener más información, consulta Cómo mostrar campos específicos.

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

{
  "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"
  }
}

Enumera las apps del usuario

Las apps de Google Drive se enumeran en el 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 en Documentos para firmar documentos. Para obtener más información, consulta Cómo usar las apps de Google Drive.

Para mostrar una lista de todas las apps instaladas del usuario como una instancia de apps, usa el método list sin parámetros.

Si deseas especificar los campos que se mostrarán en la respuesta, puedes establecer el fields parámetro del sistema. Si no especificas el parámetro fields, el servidor muestra un conjunto predeterminado de campos. Para obtener más información, consulta Cómo mostrar campos específicos.

GET https://www.googleapis.com/drive/v3/apps

{
  "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"
  ]
}

Enumera las apps del 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 consulta de la app que pueden abrir las extensiones de archivo enumeradas se incluyen en la respuesta. Si también se proporcionan appFilterMimeTypes, se muestra una unión de las dos listas de apps resultantes. Algunos ejemplos de extensiones incluyen docx para Microsoft Word y pptx para Microsoft PowerPoint. Para obtener más ejemplos de extensiones de archivo, consulta Exporta tipos de MIME para documentos de Google Workspace.

  En el siguiente ejemplo de código, se muestra 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 de tipos de MIME separados por comas. Las apps dentro del alcance de la consulta de la app que pueden abrir los tipos de MIME enumerados se incluyen en la respuesta. Si también se proporcionan appFilterExtensions, se muestra una unión de las dos listas de apps resultantes. Algunos ejemplos de tipos de MIME incluyen application/vnd.google-apps.form para Formularios de Google y application/vnd.google-apps.site para Google Sites. Para obtener más ejemplos de tipos de MIME, consulta Tipos de MIME compatibles con Google Workspace y Google Drive.

  En el siguiente ejemplo de código, se muestra 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 define BCP 47, con algunas extensiones del formato LDML de Unicode. Algunos ejemplos de códigos de idioma incluyen en-us para inglés (Estados Unidos) y fr-ca para francés (Canadá).

  En el siguiente ejemplo de código, se muestra cómo proporcionar varios códigos de idioma como un parámetro de consulta: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Obtén la app del usuario por ID

Para descargar la información detallada de la app como una instancia de apps, usa el get método con el ID de la app.

GET https://www.googleapis.com/drive/v3/apps/APP_ID

{
  "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"
}

Temas relacionados

Aquí hay algunos pasos que puedes seguir:

• Para crear un archivo en Drive, consulta Crea y administra 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.