Listar conteúdo de uma pasta

GET

/documents/folders/{idFolder}

Lista as subpastas e os arquivos que estão diretamente dentro da pasta informada, sem descer para os níveis de baixo. Itens na lixeira não aparecem. As subpastas vêm primeiro, com kind igual a drive#folder, seguidas dos arquivos, com kind igual a drive#file; cada tipo tem os seus campos. A lista não é paginada. Quando a pasta está vazia, ou o id não corresponde a nenhuma pasta, a resposta é 200 com o corpo { "data": [] }, e não { "items": [] }. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Conteúdo da pasta

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/documents/folders/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Com conteúdo

{
    "items": [
        {
            "id": "Qm3sT8vK1pZx6WcR9bNy2LfH4dJa",
            "kind": "drive#folder",
            "title": "Matrículas",
            "createdDate": "2026-03-10T14:22:05.120Z",
            "hasChildFolders": false,
            "modifiedDate": null,
            "trashed": false,
            "labels": {
                "label": "Fazenda"
            },
            "parent": "Xk9pQ2mW7rLz4NvB8cYt1HdJ5sFg",
            "clientId": "3f1c2a9e-5b7d-4e8a-9c0f-1a2b3c4d5e6f",
            "trashingUser": {
                "id": null,
                "emailAddress": null,
                "name": null,
                "trashedAt": null
            },
            "childFolders": [],
            "metadata": []
        },
        {
            "name": "declaracao-ir-2025",
            "clientId": "3f1c2a9e-5b7d-4e8a-9c0f-1a2b3c4d5e6f",
            "originalFilename": "declaracao-ir-2025.pdf",
            "labels": {
                "label": "IR"
            },
            "fileExtension": "pdf",
            "parent": "Xk9pQ2mW7rLz4NvB8cYt1HdJ5sFg",
            "id": "Hn7cV2kP9sLq4XwT1mRb6ZdF3gYe",
            "mimeType": "application/pdf",
            "fileUrl": "https://files.example.com/declaracao-ir-2025.pdf",
            "thumbnailLink": "",
            "kind": "drive#file",
            "metadata": []
        }
    ]
}

Modificado em 2026-10-13 09:47:06

Página anterior

Criar pasta nos documentos de um cliente

Próxima página

Editar pasta