Struct Files 

pub struct Files { /* private fields */ }

Implementations

impl Files

pub async fn upload( &self, data: Vec<u8>, mime_type: impl Into<String>, ) -> Result<File>

上传文件（直接上传字节数据）。

Errors

当配置无效、请求失败或响应解析失败时返回错误。

pub async fn create(&self, file: File) -> Result<CreateFileResponse>

初始化一个文件的 resumable upload，并返回原始 HTTP headers（含 x-goog-upload-url）。

该方法只执行 start 请求，不会上传文件内容。

Errors

当配置无效、请求失败或响应解析失败时返回错误。

pub async fn create_with_config( &self, file: File, config: CreateFileConfig, ) -> Result<CreateFileResponse>

初始化一个文件的 resumable upload（自定义配置）。

Errors

当配置无效、请求失败或响应解析失败时返回错误。

pub async fn upload_with_config( &self, data: Vec<u8>, config: UploadFileConfig, ) -> Result<File>

上传文件（自定义配置）。

Errors

当配置无效、请求失败或响应解析失败时返回错误。

pub async fn upload_from_path(&self, path: impl AsRef<Path>) -> Result<File>

从文件路径上传。

Errors

当文件无效、请求失败或响应解析失败时返回错误。

pub async fn upload_from_path_with_config( &self, path: impl AsRef<Path>, config: UploadFileConfig, ) -> Result<File>

从文件路径上传（自定义配置）。

Errors

当文件无效、请求失败或响应解析失败时返回错误。

pub async fn download(&self, name_or_uri: impl AsRef<str>) -> Result<Vec<u8>>

下载文件（返回字节内容）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn download_with_config( &self, name_or_uri: impl AsRef<str>, config: DownloadFileConfig, ) -> Result<Vec<u8>>

下载文件（自定义配置）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn list(&self) -> Result<ListFilesResponse>

列出文件。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn list_with_config( &self, config: ListFilesConfig, ) -> Result<ListFilesResponse>

列出文件（自定义配置）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn all(&self) -> Result<Vec<File>>

列出所有文件（自动翻页）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn all_with_config( &self, config: ListFilesConfig, ) -> Result<Vec<File>>

列出所有文件（带配置，自动翻页）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn get(&self, name_or_uri: impl AsRef<str>) -> Result<File>

获取文件元数据。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn get_with_config( &self, name_or_uri: impl AsRef<str>, config: GetFileConfig, ) -> Result<File>

获取文件元数据（自定义配置）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn delete( &self, name_or_uri: impl AsRef<str>, ) -> Result<DeleteFileResponse>

删除文件。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn delete_with_config( &self, name_or_uri: impl AsRef<str>, config: DeleteFileConfig, ) -> Result<DeleteFileResponse>

删除文件（自定义配置）。

Errors

当请求失败或响应解析失败时返回错误。

pub async fn register_files( &self, uris: Vec<String>, ) -> Result<RegisterFilesResponse>

注册 Google Cloud Storage 文件（使其可用于 Gemini Developer API）。

该方法要求客户端使用 OAuth/ADC（即 Credentials::OAuth 或 Credentials::ApplicationDefault）， 不支持 API key 认证。

Errors

当配置无效、请求失败或响应解析失败时返回错误。

pub async fn register_files_with_config( &self, uris: Vec<String>, config: RegisterFilesConfig, ) -> Result<RegisterFilesResponse>

注册 Google Cloud Storage 文件（自定义配置）。

Errors

当配置无效、请求失败或响应解析失败时返回错误。

pub async fn wait_for_active( &self, name_or_uri: impl AsRef<str>, config: WaitForFileConfig, ) -> Result<File>

轮询直到文件状态变为 ACTIVE。

Errors

当请求失败、文件失败或超时返回错误。

Trait Implementations

impl Clone for Files

fn clone(&self) -> Files

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.