tamar-file-hub-client 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

file_hub_client/rpc/gen/file_service_pb2.py

@@ -26,7 +26,7 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdf\x01\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\"\xf3\x01\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"\x07\n\x05\x45mpty2\xc8\x05\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponseb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdf\x01\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\"\xf3\x01\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"{\n\x17\x42\x61tchDownloadUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x13\n\x06is_cdn\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"#\n\x10GetGcsUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\")\n\x15\x42\x61tchGetGcsUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"H\n\x18\x42\x61tchDownloadUrlResponse\x12,\n\rdownload_urls\x18\x01 \x03(\x0b\x32\x15.file.DownloadUrlInfo\"M\n\x0f\x44ownloadUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x12\n\x05\x65rror\x18\x03 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"7\n\x11GetGcsUrlResponse\x12\x0f\n\x07gcs_url\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\"<\n\x16\x42\x61tchGetGcsUrlResponse\x12\"\n\x08gcs_urls\x18\x01 \x03(\x0b\x32\x10.file.GcsUrlInfo\"_\n\nGcsUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0f\n\x07gcs_url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"\x07\n\x05\x45mpty2\xae\x07\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12Y\n\x18\x42\x61tchGenerateDownloadUrl\x12\x1d.file.BatchDownloadUrlRequest\x1a\x1e.file.BatchDownloadUrlResponse\x12<\n\tGetGcsUrl\x12\x16.file.GetGcsUrlRequest\x1a\x17.file.GetGcsUrlResponse\x12K\n\x0e\x42\x61tchGetGcsUrl\x12\x1b.file.BatchGetGcsUrlRequest\x1a\x1c.file.BatchGetGcsUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponseb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -57,20 +57,36 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_DELETEFILEREQUEST']._serialized_end=1688
   _globals['_LISTFILESREQUEST']._serialized_start=1691
   _globals['_LISTFILESREQUEST']._serialized_end=1960
-  _globals['_UPLOADFILERESPONSE']._serialized_start=1962
-  _globals['_UPLOADFILERESPONSE']._serialized_end=2047
-  _globals['_UPLOADURLRESPONSE']._serialized_start=2049
-  _globals['_UPLOADURLRESPONSE']._serialized_end=2146
-  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2148
-  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2182
-  _globals['_SHARELINKRESPONSE']._serialized_start=2184
-  _globals['_SHARELINKRESPONSE']._serialized_end=2226
-  _globals['_FILELISTRESPONSE']._serialized_start=2228
-  _globals['_FILELISTRESPONSE']._serialized_end=2273
-  _globals['_GETFILERESPONSE']._serialized_start=2275
-  _globals['_GETFILERESPONSE']._serialized_end=2378
-  _globals['_EMPTY']._serialized_start=2380
-  _globals['_EMPTY']._serialized_end=2387
-  _globals['_FILESERVICE']._serialized_start=2390
-  _globals['_FILESERVICE']._serialized_end=3102
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_start=1962
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_end=2085
+  _globals['_GETGCSURLREQUEST']._serialized_start=2087
+  _globals['_GETGCSURLREQUEST']._serialized_end=2122
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_start=2124
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_end=2165
+  _globals['_UPLOADFILERESPONSE']._serialized_start=2167
+  _globals['_UPLOADFILERESPONSE']._serialized_end=2252
+  _globals['_UPLOADURLRESPONSE']._serialized_start=2254
+  _globals['_UPLOADURLRESPONSE']._serialized_end=2351
+  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2353
+  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2387
+  _globals['_SHARELINKRESPONSE']._serialized_start=2389
+  _globals['_SHARELINKRESPONSE']._serialized_end=2431
+  _globals['_FILELISTRESPONSE']._serialized_start=2433
+  _globals['_FILELISTRESPONSE']._serialized_end=2478
+  _globals['_GETFILERESPONSE']._serialized_start=2480
+  _globals['_GETFILERESPONSE']._serialized_end=2583
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_start=2585
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_end=2657
+  _globals['_DOWNLOADURLINFO']._serialized_start=2659
+  _globals['_DOWNLOADURLINFO']._serialized_end=2736
+  _globals['_GETGCSURLRESPONSE']._serialized_start=2738
+  _globals['_GETGCSURLRESPONSE']._serialized_end=2793
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_start=2795
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_end=2855
+  _globals['_GCSURLINFO']._serialized_start=2857
+  _globals['_GCSURLINFO']._serialized_end=2952
+  _globals['_EMPTY']._serialized_start=2954
+  _globals['_EMPTY']._serialized_end=2961
+  _globals['_FILESERVICE']._serialized_start=2964
+  _globals['_FILESERVICE']._serialized_end=3906
 # @@protoc_insertion_point(module_scope)

file_hub_client/rpc/gen/file_service_pb2_grpc.py

@@ -61,6 +61,21 @@ class FileServiceStub(object):
                 request_serializer=file__service__pb2.DownloadUrlRequest.SerializeToString,
                 response_deserializer=file__service__pb2.DownloadUrlResponse.FromString,
                 _registered_method=True)
+        self.BatchGenerateDownloadUrl = channel.unary_unary(
+                '/file.FileService/BatchGenerateDownloadUrl',
+                request_serializer=file__service__pb2.BatchDownloadUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.BatchDownloadUrlResponse.FromString,
+                _registered_method=True)
+        self.GetGcsUrl = channel.unary_unary(
+                '/file.FileService/GetGcsUrl',
+                request_serializer=file__service__pb2.GetGcsUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.GetGcsUrlResponse.FromString,
+                _registered_method=True)
+        self.BatchGetGcsUrl = channel.unary_unary(
+                '/file.FileService/BatchGetGcsUrl',
+                request_serializer=file__service__pb2.BatchGetGcsUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.BatchGetGcsUrlResponse.FromString,
+                _registered_method=True)
         self.GenerateShareLink = channel.unary_unary(
                 '/file.FileService/GenerateShareLink',
                 request_serializer=file__service__pb2.ShareLinkRequest.SerializeToString,
@@ -128,6 +143,24 @@ class FileServiceServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def BatchGenerateDownloadUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetGcsUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def BatchGetGcsUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def GenerateShareLink(self, request, context):
         """Missing associated documentation comment in .proto file."""
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
@@ -192,6 +225,21 @@ def add_FileServiceServicer_to_server(servicer, server):
                     request_deserializer=file__service__pb2.DownloadUrlRequest.FromString,
                     response_serializer=file__service__pb2.DownloadUrlResponse.SerializeToString,
             ),
+            'BatchGenerateDownloadUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.BatchGenerateDownloadUrl,
+                    request_deserializer=file__service__pb2.BatchDownloadUrlRequest.FromString,
+                    response_serializer=file__service__pb2.BatchDownloadUrlResponse.SerializeToString,
+            ),
+            'GetGcsUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetGcsUrl,
+                    request_deserializer=file__service__pb2.GetGcsUrlRequest.FromString,
+                    response_serializer=file__service__pb2.GetGcsUrlResponse.SerializeToString,
+            ),
+            'BatchGetGcsUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.BatchGetGcsUrl,
+                    request_deserializer=file__service__pb2.BatchGetGcsUrlRequest.FromString,
+                    response_serializer=file__service__pb2.BatchGetGcsUrlResponse.SerializeToString,
+            ),
             'GenerateShareLink': grpc.unary_unary_rpc_method_handler(
                     servicer.GenerateShareLink,
                     request_deserializer=file__service__pb2.ShareLinkRequest.FromString,
@@ -370,6 +418,87 @@ class FileService(object):
             metadata,
             _registered_method=True)
 
+    @staticmethod
+    def BatchGenerateDownloadUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/BatchGenerateDownloadUrl',
+            file__service__pb2.BatchDownloadUrlRequest.SerializeToString,
+            file__service__pb2.BatchDownloadUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetGcsUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/GetGcsUrl',
+            file__service__pb2.GetGcsUrlRequest.SerializeToString,
+            file__service__pb2.GetGcsUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def BatchGetGcsUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/BatchGetGcsUrl',
+            file__service__pb2.BatchGetGcsUrlRequest.SerializeToString,
+            file__service__pb2.BatchGetGcsUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
     @staticmethod
     def GenerateShareLink(request,
             target,

file_hub_client/rpc/protos/file_service.proto

@@ -13,6 +13,9 @@ service FileService {
     rpc GenerateResumableUploadUrl (UploadUrlRequest) returns (UploadUrlResponse);
     rpc ConfirmUploadCompleted (UploadCompletedRequest) returns (Empty);
     rpc GenerateDownloadUrl (DownloadUrlRequest) returns (DownloadUrlResponse);
+    rpc BatchGenerateDownloadUrl (BatchDownloadUrlRequest) returns (BatchDownloadUrlResponse);
+    rpc GetGcsUrl (GetGcsUrlRequest) returns (GetGcsUrlResponse);
+    rpc BatchGetGcsUrl (BatchGetGcsUrlRequest) returns (BatchGetGcsUrlResponse);
     rpc GenerateShareLink (ShareLinkRequest) returns (ShareLinkResponse);
     rpc VisitFile (FileVisitRequest) returns (Empty);
     rpc GetFile (GetFileRequest) returns (GetFileResponse);
@@ -120,6 +123,20 @@ message ListFilesRequest {
     optional int32 page = 7;
 }
 
+message BatchDownloadUrlRequest {
+    repeated string file_ids = 1;
+    optional bool is_cdn = 2;
+    optional int32 expire_seconds = 3;
+}
+
+message GetGcsUrlRequest {
+    string file_id = 1;
+}
+
+message BatchGetGcsUrlRequest {
+    repeated string file_ids = 1;
+}
+
 // ========= 响应结构 =========
 
 message UploadFileResponse {
@@ -150,4 +167,30 @@ message GetFileResponse {
     optional UploadFile upload_file = 2;
 }
 
+message BatchDownloadUrlResponse {
+    repeated DownloadUrlInfo download_urls = 1;
+}
+
+message DownloadUrlInfo {
+    string file_id = 1;
+    string url = 2;
+    optional string error = 3;
+}
+
+message GetGcsUrlResponse {
+    string gcs_url = 1;
+    string mime_type = 2;
+}
+
+message BatchGetGcsUrlResponse {
+    repeated GcsUrlInfo gcs_urls = 1;
+}
+
+message GcsUrlInfo {
+    string file_id = 1;
+    string gcs_url = 2;
+    string mime_type = 3;
+    optional string error = 4;
+}
+
 message Empty {}

file_hub_client/schemas/__init__.py

@@ -11,6 +11,11 @@ from .file import (
     FileListRequest,
     FileListResponse,
     GetFileResponse,
+    DownloadUrlInfo,
+    BatchDownloadUrlResponse,
+    GcsUrlInfo,
+    GetGcsUrlResponse,
+    BatchGcsUrlResponse,
 )
 from .folder import (
     FolderInfo,
@@ -63,6 +68,11 @@ __all__ = [
     "FileListRequest",
     "FileListResponse",
     "GetFileResponse",
+    "DownloadUrlInfo",
+    "BatchDownloadUrlResponse",
+    "GcsUrlInfo",
+    "GetGcsUrlResponse",
+    "BatchGcsUrlResponse",
 
     # 文件夹相关
     "FolderInfo",

file_hub_client/schemas/file.py

@@ -93,3 +93,34 @@ class GetFileResponse(BaseModel):
     """获取文件响应"""
     file: File = Field(..., description="文件信息")
     upload_file: Optional[UploadFile] = Field(None, description="上传文件信息")
+
+
+class DownloadUrlInfo(BaseModel):
+    """下载URL信息"""
+    file_id: str = Field(..., description="文件ID")
+    url: str = Field(..., description="下载URL")
+    error: Optional[str] = Field(None, description="错误信息")
+
+
+class BatchDownloadUrlResponse(BaseModel):
+    """批量下载URL响应"""
+    download_urls: List[DownloadUrlInfo] = Field(default_factory=list, description="下载URL列表")
+
+
+class GcsUrlInfo(BaseModel):
+    """GCS URL信息"""
+    file_id: str = Field(..., description="文件ID")
+    gcs_url: str = Field(..., description="GCS URL")
+    mime_type: str = Field(..., description="MIME类型")
+    error: Optional[str] = Field(None, description="错误信息")
+
+
+class GetGcsUrlResponse(BaseModel):
+    """获取GCS URL响应"""
+    gcs_url: str = Field(..., description="GCS URL")
+    mime_type: str = Field(..., description="MIME类型")
+
+
+class BatchGcsUrlResponse(BaseModel):
+    """批量GCS URL响应"""
+    gcs_urls: List[GcsUrlInfo] = Field(default_factory=list, description="GCS URL列表")

file_hub_client/services/file/async_blob_service.py

@@ -5,13 +5,13 @@ import asyncio
 import hashlib
 
 from pathlib import Path
-from typing import Optional, Union, BinaryIO, AsyncIterator
+from typing import Optional, Union, BinaryIO, AsyncIterator, List
 
 from .base_file_service import BaseFileService
 from ...enums import UploadMode
 from ...errors import ValidationError
 from ...rpc import AsyncGrpcClient
-from ...schemas import FileUploadResponse, UploadUrlResponse
+from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, GetGcsUrlResponse, BatchGcsUrlResponse
 from ...utils import AsyncHttpUploader, AsyncHttpDownloader, retry_with_backoff, get_file_mime_type
 
 
@@ -568,3 +568,126 @@ class AsyncBlobService(BaseFileService):
             save_path=save_path,
             chunk_size=chunk_size,
         )
+
+    async def batch_generate_download_url(
+            self,
+            file_ids: List[str],
+            *,
+            is_cdn: Optional[bool] = True,
+            expire_seconds: Optional[int] = None,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchDownloadUrlResponse:
+        """
+        批量生成下载URL
+
+        Args:
+            file_ids: 文件ID列表
+            is_cdn: 是否返回CDN的URL
+            expire_seconds: 过期时间（秒）
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量下载URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchDownloadUrlRequest(
+            file_ids=file_ids,
+            is_cdn=is_cdn,
+            expire_seconds=expire_seconds if expire_seconds else None
+        )
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = await stub.BatchGenerateDownloadUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        download_urls = []
+        for url_info in response.download_urls:
+            download_urls.append(DownloadUrlInfo(
+                file_id=url_info.file_id,
+                url=url_info.url,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchDownloadUrlResponse(download_urls=download_urls)
+
+    async def get_gcs_url(
+            self,
+            file_id: str,
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> GetGcsUrlResponse:
+        """
+        获取文件的GCS URL
+
+        Args:
+            file_id: 文件ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            GCS URL响应，包含URL和MIME类型
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.GetGcsUrlRequest(file_id=file_id)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = await stub.GetGcsUrl(request, metadata=grpc_metadata)
+
+        return GetGcsUrlResponse(
+            gcs_url=response.gcs_url,
+            mime_type=response.mime_type
+        )
+
+    async def batch_get_gcs_url(
+            self,
+            file_ids: List[str],
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchGcsUrlResponse:
+        """
+        批量获取文件的GCS URL
+
+        Args:
+            file_ids: 文件ID列表
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量GCS URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = await self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchGetGcsUrlRequest(file_ids=file_ids)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = await stub.BatchGetGcsUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        gcs_urls = []
+        for url_info in response.gcs_urls:
+            gcs_urls.append(GcsUrlInfo(
+                file_id=url_info.file_id,
+                gcs_url=url_info.gcs_url,
+                mime_type=url_info.mime_type,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchGcsUrlResponse(gcs_urls=gcs_urls)

file_hub_client/services/file/sync_blob_service.py

@@ -3,13 +3,13 @@
 """
 import hashlib
 from pathlib import Path
-from typing import Optional, Union, BinaryIO, Iterator
+from typing import Optional, Union, BinaryIO, Iterator, List
 
 from .base_file_service import BaseFileService
 from ...enums import UploadMode
 from ...errors import ValidationError
 from ...rpc import SyncGrpcClient
-from ...schemas import FileUploadResponse, UploadUrlResponse
+from ...schemas import FileUploadResponse, UploadUrlResponse, BatchDownloadUrlResponse, DownloadUrlInfo, GcsUrlInfo, GetGcsUrlResponse, BatchGcsUrlResponse
 from ...utils import HttpUploader, HttpDownloader, retry_with_backoff, get_file_mime_type
 
 
@@ -565,3 +565,126 @@ class SyncBlobService(BaseFileService):
             save_path=save_path,
             chunk_size=chunk_size,
         )
+
+    def batch_generate_download_url(
+            self,
+            file_ids: List[str],
+            *,
+            is_cdn: Optional[bool] = True,
+            expire_seconds: Optional[int] = None,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchDownloadUrlResponse:
+        """
+        批量生成下载URL
+
+        Args:
+            file_ids: 文件ID列表
+            is_cdn: 是否返回CDN的URL
+            expire_seconds: 过期时间（秒）
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量下载URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchDownloadUrlRequest(
+            file_ids=file_ids,
+            is_cdn=is_cdn,
+            expire_seconds=expire_seconds if expire_seconds else None
+        )
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = stub.BatchGenerateDownloadUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        download_urls = []
+        for url_info in response.download_urls:
+            download_urls.append(DownloadUrlInfo(
+                file_id=url_info.file_id,
+                url=url_info.url,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchDownloadUrlResponse(download_urls=download_urls)
+
+    def get_gcs_url(
+            self,
+            file_id: str,
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> GetGcsUrlResponse:
+        """
+        获取文件的GCS URL
+
+        Args:
+            file_id: 文件ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            GCS URL响应，包含URL和MIME类型
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.GetGcsUrlRequest(file_id=file_id)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = stub.GetGcsUrl(request, metadata=grpc_metadata)
+
+        return GetGcsUrlResponse(
+            gcs_url=response.gcs_url,
+            mime_type=response.mime_type
+        )
+
+    def batch_get_gcs_url(
+            self,
+            file_ids: List[str],
+            *,
+            request_id: Optional[str] = None,
+            **metadata
+    ) -> BatchGcsUrlResponse:
+        """
+        批量获取文件的GCS URL
+
+        Args:
+            file_ids: 文件ID列表
+            request_id: 请求ID（可选，如果不提供则自动生成）
+            **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
+
+        Returns:
+            批量GCS URL响应
+        """
+        from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
+
+        stub = self.client.get_stub(file_service_pb2_grpc.FileServiceStub)
+
+        request = file_service_pb2.BatchGetGcsUrlRequest(file_ids=file_ids)
+
+        # 构建元数据
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
+
+        response = stub.BatchGetGcsUrl(request, metadata=grpc_metadata)
+
+        # 转换响应
+        gcs_urls = []
+        for url_info in response.gcs_urls:
+            gcs_urls.append(GcsUrlInfo(
+                file_id=url_info.file_id,
+                gcs_url=url_info.gcs_url,
+                mime_type=url_info.mime_type,
+                error=url_info.error if url_info.HasField('error') else None
+            ))
+
+        return BatchGcsUrlResponse(gcs_urls=gcs_urls)

{tamar_file_hub_client-0.1.0.dist-info → tamar_file_hub_client-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -682,6 +682,137 @@ async with AsyncTamarFileHubClient() as client:
     print(f"文件已保存到: {save_path}")
 ```
 
+#### 高级下载功能
+
+File Hub Client 提供了高级的下载URL管理功能，支持批量操作和直接获取GCS URL：
+
+##### 批量生成下载URL
+
+当需要为多个文件生成下载URL时，使用批量接口可以显著提高效率：
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量生成下载URL
+    file_ids = ["file-001", "file-002", "file-003"]
+    
+    result = await client.blobs.batch_generate_download_url(
+        file_ids=file_ids,
+        is_cdn=True,           # 使用CDN加速（可选，默认为True）
+        expire_seconds=3600    # URL有效期1小时（可选）
+    )
+    
+    # 处理结果
+    for url_info in result.download_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 生成URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id} 的下载URL: {url_info.url}")
+```
+
+同步客户端示例：
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    result = client.blobs.batch_generate_download_url(
+        file_ids=["file-001", "file-002"],
+        is_cdn=False  # 不使用CDN，直接返回源站URL
+    )
+```
+
+##### 获取GCS URL
+
+对于需要直接访问Google Cloud Storage的场景，可以获取文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 获取单个文件的GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    gcs_response = await client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    # 输出示例：
+    # GCS URL: gs://bucket-name/path/to/file.pdf
+    # MIME类型: application/pdf
+```
+
+**注意**：`get_gcs_url` 方法现在返回一个 `GetGcsUrlResponse` 对象，包含：
+- `gcs_url`: Google Cloud Storage 的完整路径
+- `mime_type`: 文件的MIME类型，便于正确处理文件内容
+
+##### 批量获取GCS URL
+
+批量获取多个文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 批量获取GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    file_ids = ["file-001", "file-002", "file-003"]
+    result = await client.blobs.batch_get_gcs_url(file_ids)
+    
+    # 处理结果
+    for url_info in result.gcs_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 获取GCS URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id}:")
+            print(f"  GCS URL: {url_info.gcs_url}")
+            print(f"  MIME类型: {url_info.mime_type}")
+            # 根据MIME类型处理文件
+            if url_info.mime_type.startswith('image/'):
+                print(f"  这是一个图片文件")
+            elif url_info.mime_type == 'application/pdf':
+                print(f"  这是一个PDF文件")
+```
+
+同步客户端示例：
+
+```python
+# 同步客户端 - 批量获取GCS URL
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 获取单个GCS URL
+    gcs_response = client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    
+    # 批量获取GCS URL
+    result = client.blobs.batch_get_gcs_url(["file-001", "file-002"])
+```
+
+##### 使用场景说明
+
+1. **批量下载URL生成**：
+   - 适用于需要同时下载多个文件的场景
+   - 支持CDN加速，提供更好的下载体验
+   - 可设置URL有效期，增强安全性
+   - 批量操作减少网络往返，提高效率
+
+2. **GCS URL获取**：
+   - 适用于需要与Google Cloud服务集成的场景
+   - 可用于数据分析、批处理等后端处理
+   - 支持使用GCS工具进行文件操作
+   - 返回的是永久有效的存储路径
+   - 同时返回MIME类型信息，便于正确处理不同类型的文件
+   - 可根据MIME类型选择合适的处理方式（如图片处理、文档解析等）
+
+3. **错误处理**：
+   - 每个文件独立处理，部分失败不影响其他文件
+   - 错误信息通过 `error` 字段返回
+   - 建议在批量操作时做好错误处理和重试逻辑
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2019,6 +2150,12 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

{tamar_file_hub_client-0.1.0.dist-info → tamar_file_hub_client-0.1.2.dist-info}/RECORD

@@ -13,26 +13,26 @@ file_hub_client/rpc/generate_grpc.py,sha256=opzstxWdW7vqR9OxrgUCSUkZe8IqgcOdruqW
 file_hub_client/rpc/interceptors.py,sha256=UeQ8u-olMiYwScXJrlzqPS-odGomH-h3xJqOwPznRUo,22071
 file_hub_client/rpc/sync_client.py,sha256=ZWBmP-TU8eeAfl2lV8sLu9nsxo_aOPAVmt9ww_T8Hwg,14054
 file_hub_client/rpc/gen/__init__.py,sha256=NJLqr9ezUXeOyy1J0sMPn3Kl_8IyGw7GAzzzewO3MIw,45
-file_hub_client/rpc/gen/file_service_pb2.py,sha256=i8RsHLj8Vzoj0SXBNDtAVuUG6vwj96iTqOMoHE94-24,8733
-file_hub_client/rpc/gen/file_service_pb2_grpc.py,sha256=KSf-kiA6M5YOmhySAMJIfLj3-cQamS59wEnULOP-DhI,20756
+file_hub_client/rpc/gen/file_service_pb2.py,sha256=f6PkMS-JGFtDSpbqv77Bf-QqOGY__osHg6WmUtuxlLY,11009
+file_hub_client/rpc/gen/file_service_pb2_grpc.py,sha256=F7u-n6doSz1HxmaYAL0y_nNB1NVR8CRlZVKAMe63P4A,26083
 file_hub_client/rpc/gen/folder_service_pb2.py,sha256=OPNYHThmL1k2KH1ll2L_Gj76oWBWqcymXKHu8mk1Zvk,4126
 file_hub_client/rpc/gen/folder_service_pb2_grpc.py,sha256=pOHFsVThdAu5DAKd8QK3_zQvUmFgGlh4KBqIYnYDZ_U,10411
 file_hub_client/rpc/gen/taple_service_pb2.py,sha256=8BJCFRFJ_khl_Uaw-5jWCabljWJo6zaqOYWe1368xEw,48254
 file_hub_client/rpc/gen/taple_service_pb2_grpc.py,sha256=DCL-45PlEZ0guLz1u2fFH_sDIT_awuSvp9Ak6fa2GO8,64773
-file_hub_client/rpc/protos/file_service.proto,sha256=Rs57mVJ7Tl5NM2wXU8LcUBxvboHKcyzQiAhEt5_Ryq0,3799
+file_hub_client/rpc/protos/file_service.proto,sha256=d6xMVohY3_tLJOQv1nV04pNUlgTM-9v9bkZYnebzraE,4821
 file_hub_client/rpc/protos/folder_service.proto,sha256=cgIbJT2slXMMRGrtrzN3kjae9-4CB1zXCmceiUgE6fI,1542
 file_hub_client/rpc/protos/taple_service.proto,sha256=0mwhyBwD3yvFhMiiSA6J3Ni6pyHc369iD4oDXXl7DIU,29765
-file_hub_client/schemas/__init__.py,sha256=IpWfQe71MJLt9lK5Bh0PDIhmWGzLAQTa9qSUWbRz3xc,2146
+file_hub_client/schemas/__init__.py,sha256=9BvyqWBkeEav47vUBZ6eDyCt_iKATCOwakcrmOTdVWA,2396
 file_hub_client/schemas/context.py,sha256=bs-KXGBBo_9i1KbvozY8KjYzV5ZtMbjqpPW_ssN7qMs,5516
-file_hub_client/schemas/file.py,sha256=xn-5l8MqEhm78qbcddDvwAWITz9O4uuq-MJzBM_x2LQ,3829
+file_hub_client/schemas/file.py,sha256=s4_gYriOn_UP9gcDRqB2YNvNN-FqEZEbfJCOVE5JUTQ,4899
 file_hub_client/schemas/folder.py,sha256=D7UFsLCou-7CCXCQvuRObaBQEGmETsm1cgGOG1ceSrk,1026
 file_hub_client/schemas/taple.py,sha256=LYsECsDbcioPXcvjRBcCEbh083iEB-eFCapJrGMJ8w0,17790
 file_hub_client/services/__init__.py,sha256=yh5mir0dKB_LtJMk2hTpQI9WSlguaxtVD2KomMnzxdM,514
 file_hub_client/services/file/__init__.py,sha256=aJygo_AzYk5NN-ezp-a9YlugJ82wVIP9e5e54fl0UsI,342
-file_hub_client/services/file/async_blob_service.py,sha256=kIsz-tGDLgmk4J5I-h95Aummz1UPo55ffy5vIAFQxaU,20578
+file_hub_client/services/file/async_blob_service.py,sha256=St0FdvzSpJJErhJ3V1vCSSbRN14jggEMS9U8QPqZFiQ,24716
 file_hub_client/services/file/async_file_service.py,sha256=wJuoy-3CiIow5Xef_4JNJRKEOoMTKfs9nxqbkaYI4Ig,9110
 file_hub_client/services/file/base_file_service.py,sha256=wTxplrTk9klfwIHOPfTL0TQd6gX4nEmkYtIhpiZ3GVo,4791
-file_hub_client/services/file/sync_blob_service.py,sha256=I2_fcdpE6jyZ4Bs7-zWzr5PhWWPMfKQLcYMuYV2cDiE,20359
+file_hub_client/services/file/sync_blob_service.py,sha256=3VbJGuW7PHCQFK-ip0Y2NRnU39ps3rHnQoxFQp46e3s,24443
 file_hub_client/services/file/sync_file_service.py,sha256=fMTq91dXwZzuMsPTZ1whaQBxzpyHfSP-A4W15pWSNfs,8964
 file_hub_client/services/folder/__init__.py,sha256=vGbMOlNiEBdnWZB1xE74RJtoroI28hKHCWfQV1GqKQc,210
 file_hub_client/services/folder/async_folder_service.py,sha256=uFEmtW8EXYvaKYT2JCitWbdTGR1EtHlx_eBN5P3JUZg,7293
@@ -51,7 +51,7 @@ file_hub_client/utils/logging.py,sha256=IxcvWkA0G9s9BMiXIeFAdJX5G-Lc5-JFlS2yxOX1
 file_hub_client/utils/retry.py,sha256=A2MBdJCEY-Ks0guq8dd5wXX22sD27N30Qy3nQIW1B_s,18019
 file_hub_client/utils/smart_retry.py,sha256=RjBhyG6SNDfMXxNxKU_qayWDD6Ihp7ow6_BPjhgflM0,16465
 file_hub_client/utils/upload_helper.py,sha256=gEtn9OXVJiGUpVev_fqrDnRQ6AFiiP9goLzFrVpqXmU,22569
-tamar_file_hub_client-0.1.0.dist-info/METADATA,sha256=nqxmyLYky2aZi1vvmHEDVE6lZDVRF0akTnreQ2_GocY,65575
-tamar_file_hub_client-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tamar_file_hub_client-0.1.0.dist-info/top_level.txt,sha256=9wcR7hyAJQdJg_kuH6WR3nmpJ8O-j8aJNK8f_kcFy6U,16
-tamar_file_hub_client-0.1.0.dist-info/RECORD,,
+tamar_file_hub_client-0.1.2.dist-info/METADATA,sha256=IDzFkdNun5NF-ugAkJ7URmNpga0Hh9e9RzsYCFp3aAU,70429
+tamar_file_hub_client-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tamar_file_hub_client-0.1.2.dist-info/top_level.txt,sha256=9wcR7hyAJQdJg_kuH6WR3nmpJ8O-j8aJNK8f_kcFy6U,16
+tamar_file_hub_client-0.1.2.dist-info/RECORD,,