List Folder Files
Files synced from a Drive folder, ordered by name the way a person reads it — 1, 2, 3 … 10, not 1, 10, 2. The files are named after the task’s creatives, so the variation number in the name is what the listing counts along; Drive’s own clock only breaks ties between files sharing a name.
parents is the ancestor chain rather than the immediate parent, so files sitting in a subfolder
are listed too — and it is the indexed path. Unlike the other collections here the page is
offset-based: a folder holds tens of files, not a feed.
A row carries everything the file dialog shows, not just the tile: the dialog is opened on a file this page already described, and a folder is stepped through with the arrow keys.
GET
/api/v1/gdrive-files/folders/{folder_id}Authorization
AuthorizationBearer token · headerrequiredor
AuthorizationOAuth2 access token · headerrequiredPath parameters
folder_idstringrequiredDrive folder id, e.g. a task's `drive_folder_id`
min length 1
Query parameters
limitintegermin 1 · max 100 · default: 50
offsetintegermin 0 · default: 0
Responses
200Successful Response
successbooleandefault: true
dataGdriveFolderFiles | anyShow propertiesHide properties
Any of:
GdriveFolderFiles
filesGdriveFolderFile[]requiredShow propertiesHide properties
Array of
GdriveFolderFiledrive_file_idstringrequirednamestringrequiredmime_typestring | anyShow propertiesHide properties
Any of:
string
stringany
anysizeinteger | anyShow propertiesHide properties
Any of:
integer
integerany
anyfile_created_atstring<date-time> | anyShow propertiesHide properties
Any of:
string<date-time>
string<date-time>any
anyupdated_atstring<date-time> | anyShow propertiesHide properties
Any of:
string<date-time>
string<date-time>any
anyduplicates_countintegerdefault: 0
probeProbeInfo | anyShow propertiesHide properties
Any of:
ProbeInfo
duration_msinteger | anyShow propertiesHide properties
Any of:
integer
integerany
anywidthinteger | anyShow propertiesHide properties
Any of:
integer
integerany
anyheightinteger | anyShow propertiesHide properties
Any of:
integer
integerany
anycodecstring | anyShow propertiesHide properties
Any of:
string
stringany
anybitrateinteger | anyShow propertiesHide properties
Any of:
integer
integerany
anyhas_audioboolean | anyShow propertiesHide properties
Any of:
boolean
booleanany
anyany
anyvideo_urlstring | anyShow propertiesHide properties
Any of:
string
stringany
anyoriginal_urlstring | anyShow propertiesHide properties
Any of:
string
stringany
anypreview_urlstring | anyShow propertiesHide properties
Any of:
string
stringany
anymetaPaginationMetarequiredShow propertiesHide properties
totalintegerrequiredlimitintegerrequiredoffsetintegerrequiredany
anymessagestring | anyShow propertiesHide properties
Any of:
string
stringany
anyerrorsstring[] | anyShow propertiesHide properties
Any of:
string[]
Array of
stringstringany
any422Validation Error
detailValidationError[]Show propertiesHide properties
Array of
ValidationErrorlocstring | integer[]requiredShow propertiesHide properties
Array of
string | integerAny of:
string
stringinteger
integermsgstringrequiredtypestringrequiredinputanyctxobjectRequest
curl -X GET "/api/v1/gdrive-files/folders/string" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("/api/v1/gdrive-files/folders/string", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"/api/v1/gdrive-files/folders/string",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"success": true,
"data": {
"files": [
{
"drive_file_id": "string",
"name": "string",
"mime_type": "string",
"size": 0,
"file_created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"duplicates_count": 0,
"probe": {
"duration_ms": 0,
"width": 0,
"height": 0,
"codec": "string",
"bitrate": 0,
"has_audio": true
},
"video_url": "string",
"original_url": "string",
"preview_url": "string"
}
],
"meta": {
"total": 0,
"limit": 0,
"offset": 0
}
},
"message": "string",
"errors": [
"string"
]
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}