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, la configuración de Drive del usuario y sus 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 de cada app.

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

Obtén detalles sobre un usuario

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

Debes establecer el parámetro del sistema fields en el método get para especificar los campos que se devolverán en la respuesta. En la mayoría de los métodos de Drive, esta acción solo es necesaria para devolver 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 devolver campos específicos.

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

Enumera las apps del usuario

Las apps de Google Drive se enumeran 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 Usa las apps de Google Drive.

Para devolver una lista de todas las apps instaladas del usuario como una instancia de apps, usa el método list sin ningún parámetro.

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

En la siguiente muestra de código, se muestra cómo devolver una lista de todas las apps instaladas del usuario en la solicitud. La respuesta muestra los valores de los campos para 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 Play Store de esta app.

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. En la respuesta, se incluyen las apps dentro del alcance de la búsqueda de apps que pueden abrir las extensiones de archivo enumeradas. Si también se proporcionan appFilterMimeTypes, se devuelve 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 obtener más ejemplos de extensiones de archivos, consulta Tipos MIME de exportación para documentos de Google Workspace.

    En el siguiente ejemplo de código, se muestra cómo proporcionar varias extensiones de archivo como 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 proporcionan appFilterExtensions, se devuelve una unión de las dos listas de apps resultantes. Algunos ejemplos de tipos de MIME son 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 admitidos en 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 se define en BCP 47, con algunas extensiones del formato LDML de Unicode. Entre los ejemplos de códigos de idioma, se incluyen 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 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 método get con el ID de la app.

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 para 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 Play Store de esta app.

Aquí hay algunos pasos que puedes seguir: