Support File URLs in GenAI File API for Direct Upload #130

.changeset/slick-dolls-hunt.md

@@ -0,0 +1,5 @@
+---
+"@google/generative-ai": patch
+---
+
+Added a new feature GoogleAIFileManager.uploadRemoteFile

common/api-review/generative-ai-server.api.md

@@ -4,6 +4,8 @@
 
 ```ts
 
+/// <reference types="node" />
+
 // Warning: (ae-incompatible-release-tags) The symbol "ArraySchema" is marked as @public, but its signature references "BaseSchema" which is marked as @internal
 //
 // @public
@@ -31,8 +33,6 @@ export interface BooleanSchema extends BaseSchema {
     type: typeof SchemaType.BOOLEAN;
 }
 
-/// <reference types="node" />
-
 // @public
 export interface CachedContent extends CachedContentBase {
     createTime?: string;
@@ -387,6 +387,7 @@ export class GoogleAIFileManager {
     getFile(fileId: string, requestOptions?: SingleRequestOptions): Promise<FileMetadataResponse>;
     listFiles(listParams?: ListParams, requestOptions?: SingleRequestOptions): Promise<ListFilesResponse>;
     uploadFile(fileData: string | Buffer, fileMetadata: FileMetadata): Promise<UploadFileResponse>;
+    uploadRemoteFile(fileUrl: string, fileName: string): Promise<UploadFileResponse>;
 }
 
 // @public

docs/reference/main/generative-ai.arrayschema.md

@@ -15,10 +15,99 @@ export interface ArraySchema extends BaseSchema
 
 ## Properties
 
-|  Property | Modifiers | Type | Description |
-|  --- | --- | --- | --- |
-|  [items](./generative-ai.arrayschema.items.md) |  | [Schema](./generative-ai.schema.md) | A schema describing the entries in the array. |
-|  [maxItems?](./generative-ai.arrayschema.maxitems.md) |  | number | _(Optional)_ The maximum number of items in the array. |
-|  [minItems?](./generative-ai.arrayschema.minitems.md) |  | number | _(Optional)_ The minimum number of items in the array. |
-|  [type](./generative-ai.arrayschema.type.md) |  | typeof [SchemaType.ARRAY](./generative-ai.schematype.md) |  |
+<table><thead><tr><th>
 
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[items](./generative-ai.arrayschema.items.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[Schema](./generative-ai.schema.md)
+
+
+</td><td>
+
+A schema describing the entries in the array.
+
+
+</td></tr>
+<tr><td>
+
+[maxItems?](./generative-ai.arrayschema.maxitems.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_ The maximum number of items in the array.
+
+
+</td></tr>
+<tr><td>
+
+[minItems?](./generative-ai.arrayschema.minitems.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_ The minimum number of items in the array.
+
+
+</td></tr>
+<tr><td>
+
+[type](./generative-ai.arrayschema.type.md)
+
+
+</td><td>
+
+
+</td><td>
+
+typeof [SchemaType.ARRAY](./generative-ai.schematype.md)
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

docs/reference/main/generative-ai.baseparams.md

@@ -14,8 +14,63 @@ export interface BaseParams
 
 ## Properties
 
-|  Property | Modifiers | Type | Description |
-|  --- | --- | --- | --- |
-|  [generationConfig?](./generative-ai.baseparams.generationconfig.md) |  | [GenerationConfig](./generative-ai.generationconfig.md) | _(Optional)_ |
-|  [safetySettings?](./generative-ai.baseparams.safetysettings.md) |  | [SafetySetting](./generative-ai.safetysetting.md)<!-- -->\[\] | _(Optional)_ |
+<table><thead><tr><th>
 
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[generationConfig?](./generative-ai.baseparams.generationconfig.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[GenerationConfig](./generative-ai.generationconfig.md)
+
+
+</td><td>
+
+_(Optional)_
+
+
+</td></tr>
+<tr><td>
+
+[safetySettings?](./generative-ai.baseparams.safetysettings.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[SafetySetting](./generative-ai.safetysetting.md)<!-- -->\[\]
+
+
+</td><td>
+
+_(Optional)_
+
+
+</td></tr>
+</tbody></table>

docs/reference/main/generative-ai.batchembedcontentsrequest.md

@@ -14,7 +14,42 @@ export interface BatchEmbedContentsRequest
 
 ## Properties
 
-|  Property | Modifiers | Type | Description |
-|  --- | --- | --- | --- |
-|  [requests](./generative-ai.batchembedcontentsrequest.requests.md) |  | [EmbedContentRequest](./generative-ai.embedcontentrequest.md)<!-- -->\[\] |  |
+<table><thead><tr><th>
 
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[requests](./generative-ai.batchembedcontentsrequest.requests.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[EmbedContentRequest](./generative-ai.embedcontentrequest.md)<!-- -->\[\]
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

docs/reference/main/generative-ai.batchembedcontentsresponse.md

@@ -14,7 +14,42 @@ export interface BatchEmbedContentsResponse
 
 ## Properties
 
-|  Property | Modifiers | Type | Description |
-|  --- | --- | --- | --- |
-|  [embeddings](./generative-ai.batchembedcontentsresponse.embeddings.md) |  | [ContentEmbedding](./generative-ai.contentembedding.md)<!-- -->\[\] |  |
+<table><thead><tr><th>
 
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[embeddings](./generative-ai.batchembedcontentsresponse.embeddings.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[ContentEmbedding](./generative-ai.contentembedding.md)<!-- -->\[\]
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

docs/reference/main/generative-ai.blockreason.md

@@ -14,9 +14,62 @@ export declare enum BlockReason
 
 ## Enumeration Members
 
-|  Member | Value | Description |
-|  --- | --- | --- |
-|  BLOCKED\_REASON\_UNSPECIFIED | <code>&quot;BLOCKED_REASON_UNSPECIFIED&quot;</code> |  |
-|  OTHER | <code>&quot;OTHER&quot;</code> |  |
-|  SAFETY | <code>&quot;SAFETY&quot;</code> |  |
+<table><thead><tr><th>
 
+Member
+
+
+</th><th>
+
+Value
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+BLOCKED\_REASON\_UNSPECIFIED
+
+
+</td><td>
+
+`"BLOCKED_REASON_UNSPECIFIED"`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+OTHER
+
+
+</td><td>
+
+`"OTHER"`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+SAFETY
+
+
+</td><td>
+
+`"SAFETY"`
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>