Información del usuario que se muestra

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 recursos Permission.
  • 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 proporciona 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 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 proporciona 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 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 incluyen en-us para inglés (Estados Unidos) y fr-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.

Estos son algunos de los pasos que puedes seguir: