Drive Folder Contents — A2UI Atomic Catalog

Responsive grid of files and subfolders inside a Drive folder. Subfolders appear first, each item shows a coloured file-type badge and name, clicking opens in Drive. On GAS uses DriveApp with folder_id; on other surfaces renders from items[] array or Drive REST API with folder_id + auth_token.

Surfaces

apps-script-webmeet-stage

Fields

Field	Type
folder_id	string (gas-native/api). The Google Drive folder ID to browse.	required
title	string. Override for the folder name shown as header.	optional
count	integer. Max items to show. Default 12.	optional
items	array (static connector). File objects for non-GAS surfaces.	required
auth_token	string (api connector). OAuth2 bearer token for REST API.	required

Example payload

{
  "type": "drive_folder_contents",
  "folder_id": "Folder id",
  "items": [
    {
      "label": "Item 1"
    },
    {
      "label": "Item 2"
    }
  ],
  "auth_token": "your-api-token"
}

ARD catalog entry

{
  "identifier": "urn:air:a2uicatalog.ai:atom:drive_folder_contents",
  "displayName": "Drive Folder Contents",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/drive_folder_contents",
  "capabilities": [
    "apps-script-web",
    "meet-stage"
  ],
  "description": "Responsive grid of files and subfolders inside a Drive folder. Subfolders appear first, each item shows a coloured file-type badge and name, clicking opens in Drive. On GAS uses DriveApp with folder_id; on other surfaces renders from items[] array or Drive REST API with folder_id + auth_token.",
  "representativeQueries": [
    "show a Drive folder grid \u2014 live on GAS via folder_id, items[] or api connector on web/meet",
    "responsive grid of files and subfolders inside a drive folder. subfolders appear first, each item sh",
    "render a drive folder contents"
  ]
}

Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy

Full deploy guide →