getFiles

abstract suspend fun getFiles(ids: List<String> = emptyList(), pageToken: String? = null, concurrency: Int = 10): ApiFilesList

Retrieves file objects by their IDs.

If ids is empty, returns all files. Failed retrievals are silently skipped.

Return

An ApiFilesList containing the retrieved files.

Parameters

ids

The list of file IDs to retrieve.

pageToken

Pagination token, if supported by the provider.

concurrency

Maximum number of concurrent requests.

Samples

// For get all files use getFiles() function.
val files: ApiFilesList = client.getFiles()
// pageToken is required for providers that distribute files across pages.
println(files.printableOutput())
// For get files by ids use parameter "filesIds" in getFiles() function.
val filesForGet = listOf<String>("file_1", "file_2", "file_3", "file_4", "file_5")
val files: ApiFilesList = client.getFiles(
    ids = filesForGet,
    concurrency = 5 // Number of concurrently open connections (default: 10).
)
println(files.printableOutput())
// For get a file use a getFiles() function.
val files: ApiFilesList = client.getFiles(ids = listOf("file_id"))
println(files.files.firstOrNull()?.name)