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, su configuración de Drive y las capacidades del sistema.

  • Con el recurso apps, 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 la información del usuario en Drive.

Cómo obtener detalles sobre un usuario

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

El método get() requiere el parámetro fields para enumerar los campos que se mostrarán en la respuesta. Si omites el parámetro, el método mostrará un error. Para mostrar los campos exactos que necesitas, consulta Cómo mostrar campos específicos.

Mostrar un ejemplo

En la siguiente muestra de código, se muestra cómo proporcionar varios fields como un parámetro de consulta en la solicitud. La respuesta muestra los valores de los campos 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: El ID del usuario dentro de los recursos Permission.
  • EMAIL_ADDRESS: La dirección de correo electrónico del usuario

Cómo mostrar las apps del usuario

Las apps de Google Drive se muestran 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 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 ningún parámetro.

Puedes configurar el parámetro fields para enumerar los campos que se mostrarán en la respuesta. Para mostrar los campos exactos que necesitas, consulta Cómo mostrar campos específicos.

Mostrar un ejemplo

En la siguiente muestra de código, se muestra cómo mostrar una lista de todas las apps instaladas del usuario en la solicitud. La respuesta muestra los valores de los campos 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: El ID de la app.
  • PRODUCT_ID: El ID de la ficha de producto de esta app.

Cómo mostrar una lista de las apps del usuario con parámetros de consulta

Para encontrar una app específica, usa uno o más de los siguientes parámetros de consulta opcionales:

  • appFilterExtensions: Filtra los resultados de la búsqueda con una lista de extensiones de archivo separadas por comas. En la respuesta, se incluyen las apps dentro del alcance de la consulta de la app que pueden abrir las extensiones de archivo enumeradas. Si también se proporciona appFilterMimeTypes, se muestra una unión de las dos listas de apps resultantes. Algunos ejemplos de extensiones son docx para Microsoft Word y pptx para Microsoft PowerPoint. Para ver más ejemplos de extensiones de archivo, consulta Cómo exportar tipos MIME para documentos de Google Workspace.

    En la siguiente muestra 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 MIME separados por comas. En la respuesta, se incluyen las apps dentro del alcance de la consulta de la app que pueden abrir los tipos de MIME enumerados. Si también se proporciona appFilterExtensions, se muestra una unión de las dos listas de apps resultantes. Algunos ejemplos de tipos MIME son application/vnd.google-apps.form para Formularios de Google y application/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 muestra cómo proporcionar varios tipos 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, como se define en el BCP 47, con algunas extensiones del formato LDML de Unicode. Algunos ejemplos de códigos de idioma son en-us para inglés (Estados Unidos) y fr-ca para francés (Canadá).

    En la siguiente muestra 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.

Cómo 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 get() con el ID de la app.

Mostrar un ejemplo

En la siguiente muestra de código, se muestra cómo proporcionar un appId como parámetro de consulta en la solicitud. La respuesta muestra los valores de los campos 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: El ID de la app.
  • PRODUCT_ID: El ID de la ficha de producto de esta app.

Estos son algunos pasos que puedes seguir: