# Google Drive

Google Drive API APIPedia: Unggah, cari, dan kelola berkas Google Drive lewat API APIPedia. Panggil dengan satu token API di `https://api.apipedia.id/v1/toolkits/googledrive`.

Unggah berkas, cari berdasarkan nama atau tipe, dan atur izin akses berkas di Google Drive. Pemanggil selalu memanggil API APIPedia dengan token APIPedia sendiri; Composio hanya broker OAuth di belakang layar dan tidak pernah dipanggil langsung.

- Base URL: `https://api.apipedia.id/v1/toolkits/googledrive`
- Autentikasi: `Authorization: Bearer apk_…` (token dari console.apipedia.id)
- Kategori: Produktivitas
- Halaman: https://apipedia.id/docs/google-drive
- OpenAPI: https://console.apipedia.id/openapi/google-drive.yaml

Semua respons memakai amplop `{ "is_success", "message", "data" }` kecuali disebutkan lain. Kode error umum: lihat https://apipedia.id/docs#kode-status-error.

## Endpoint (1)

- `GET /files`: Daftar berkas di Google Drive

### Daftar berkas di Google Drive

`GET https://api.apipedia.id/v1/toolkits/googledrive/files`

Dieksekusi lewat tool Composio `GOOGLEDRIVE_LIST_FILES`. Memerlukan koneksi aktif di halaman Koneksi (409 bila belum).

Tanpa `q`, `folder_id`, atau `search`, daftar dibatasi ke folder akar dan berkas yang belum dibuang ke Sampah - tanpa itu Google Drive memulangkan SELURUH isi Drive secara datar, termasuk isi tiap subfolder.

| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| `limit` | query | integer | tidak | Jumlah berkas per halaman, 1-1000. Nilai di luar rentang jatuh ke 100. Default `100`. |
| `folder_id` | query | string | tidak | Id folder yang isinya ditampilkan. Kosong = folder akar (`root`). |
| `search` | query | string | tidak | Cari berkas berdasarkan nama di seluruh Drive (mengabaikan folder_id). |
| `page_token` | query | string | tidak | Kursor halaman berikutnya dari `nextPageToken` respons sebelumnya. |
| `q` | query | string | tidak | Kueri mentah sintaks Google Drive; menimpa folder_id dan search. |

Contoh request:

```bash
curl -X GET "https://api.apipedia.id/v1/toolkits/googledrive/files?limit=100&folder_id=root&search=kontrak&q=mimeType%3D'application%2Fpdf'" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx"
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "Google Drive file list retrieved",
  "data": {
    "tool": "GOOGLEDRIVE_LIST_FILES",
    "result": {
      "files": [
        {
          "id": "1QwErTyUiOpAsDfGhJkL",
          "name": "Kontrak 2026.pdf",
          "mimeType": "application/pdf"
        }
      ],
      "nextPageToken": null
    }
  }
}
```
