- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Corpus
- Pruébala
Enumera los archivos del usuario.
Este método acepta el parámetro q
, que es una búsqueda que combina uno o más términos de búsqueda. Para obtener más información, consulta la guía Cómo buscar archivos y carpetas.
Solicitud HTTP
GET https://www.googleapis.com/drive/v2/files
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
corpora |
Cuerpos de elementos (archivos/documentos) a los que se aplica la consulta Los cuerpos admitidos son |
corpus |
Obsoleto: El cuerpo de los elementos (archivos/documentos) a los que se aplica la consulta. Usa |
driveId |
ID de la unidad compartida que se buscará. |
includeItemsFromAllDrives |
Indica si se deben incluir tanto los elementos de Mi unidad como los de la unidad compartida en los resultados. |
includeTeamDriveItems |
Obsoleto: usa |
maxResults |
La cantidad máxima de archivos que se muestran por página. Es posible que se muestren páginas de resultados parciales o vacías incluso antes de llegar al final de la lista de archivos. |
orderBy |
Una lista separada por comas de claves de orden. Las claves válidas son |
pageToken |
Token de la página para archivos |
projection |
Obsoleto: este parámetro no tiene función. |
q |
Cadena de consulta para buscar archivos. |
spaces |
Una lista de espacios separados por comas para consultar. Los valores admitidos son |
supportsAllDrives |
Indica si la aplicación solicitante admite Mi unidad y las unidades compartidas. |
supportsTeamDrives |
Obsoleto: usa |
teamDriveId |
Obsoleto: usa |
includePermissionsForView |
Especifica qué permisos de vistas adicionales se deben incluir en la respuesta. Solo se admite |
includeLabels |
Una lista separada por comas de los IDs de las etiquetas que se incluirán en la parte |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Una lista de archivos.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
Campos | |
---|---|
nextPageToken |
El token de la página de la siguiente página de archivos. Estará ausente si se llega al final de la lista de archivos. Si por algún motivo se rechaza el token, se debe descartar y se debe reiniciar la paginación desde la primera página de resultados. |
kind |
Siempre es |
etag |
La ETag de la lista |
selfLink |
Vínculo a esta lista. |
incompleteSearch |
Si el proceso de búsqueda estaba incompleto. Si esta preferencia se establece como "true", es posible que falten algunos resultados de la búsqueda, ya que no se buscaron todos los documentos. Esto puede ocurrir cuando se buscan varias unidades en el corpus "allDrives", pero no se pudo buscar todo el corpus. Cuando esto sucede, se sugiere que los clientes acotan su consulta eligiendo un corpus diferente, como "default" o "drive". |
nextLink |
Es un vínculo a la página siguiente de archivos. |
items[] |
Es la lista de archivos. Si se propaga nextPageToken, es posible que esta lista esté incompleta y se deba recuperar una página adicional de resultados. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la guía de autorización.
Corpus
Enumeradores | |
---|---|
DEFAULT |
Corresponde a los elementos a los que accedió el usuario. |
DOMAIN |
Elementos compartidos con el dominio del usuario |