@google/genai 1.50.0 → 1.51.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -12
- package/dist/genai.d.ts +230 -358
- package/dist/index.cjs +164 -148
- package/dist/index.mjs +165 -149
- package/dist/index.mjs.map +1 -1
- package/dist/node/index.cjs +192 -158
- package/dist/node/index.mjs +193 -159
- package/dist/node/index.mjs.map +1 -1
- package/dist/node/node.d.ts +230 -358
- package/dist/tokenizer/node.cjs +15 -1
- package/dist/tokenizer/node.d.ts +1 -1
- package/dist/tokenizer/node.mjs +15 -1
- package/dist/tokenizer/node.mjs.map +1 -1
- package/dist/vertex_internal/index.cjs +16 -2
- package/dist/vertex_internal/index.cjs.map +1 -1
- package/dist/vertex_internal/index.d.ts +75 -24
- package/dist/vertex_internal/index.js +16 -2
- package/dist/vertex_internal/index.js.map +1 -1
- package/dist/web/index.mjs +158 -147
- package/dist/web/index.mjs.map +1 -1
- package/dist/web/web.d.ts +230 -358
- package/package.json +6 -1
package/dist/genai.d.ts
CHANGED
|
@@ -480,7 +480,7 @@ declare interface AudioContent {
|
|
|
480
480
|
/**
|
|
481
481
|
* The sample rate of the audio.
|
|
482
482
|
*/
|
|
483
|
-
|
|
483
|
+
sample_rate?: number;
|
|
484
484
|
/**
|
|
485
485
|
* The URI of the audio.
|
|
486
486
|
*/
|
|
@@ -655,7 +655,7 @@ declare interface BaseCreateAgentInteractionParams {
|
|
|
655
655
|
/**
|
|
656
656
|
* Body param: The name of the `Agent` used for generating the interaction.
|
|
657
657
|
*/
|
|
658
|
-
agent:
|
|
658
|
+
agent: 'deep-research-pro-preview-12-2025' | 'deep-research-preview-04-2026' | 'deep-research-max-preview-04-2026' | (string & {});
|
|
659
659
|
/**
|
|
660
660
|
* Body param: The input for the interaction.
|
|
661
661
|
*/
|
|
@@ -950,15 +950,11 @@ declare class BaseWebhooks extends APIResource {
|
|
|
950
950
|
/**
|
|
951
951
|
* Creates a new Webhook.
|
|
952
952
|
*/
|
|
953
|
-
create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<
|
|
954
|
-
/**
|
|
955
|
-
* Gets a specific Webhook.
|
|
956
|
-
*/
|
|
957
|
-
retrieve(id: string, params?: WebhookRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<WebhookRetrieveResponse>;
|
|
953
|
+
create(params: WebhookCreateParams, options?: RequestOptions): APIPromise<Webhook>;
|
|
958
954
|
/**
|
|
959
955
|
* Updates an existing Webhook.
|
|
960
956
|
*/
|
|
961
|
-
update(id: string, params
|
|
957
|
+
update(id: string, params?: WebhookUpdateParams | null | undefined, options?: RequestOptions): APIPromise<Webhook>;
|
|
962
958
|
/**
|
|
963
959
|
* Lists all Webhooks.
|
|
964
960
|
*/
|
|
@@ -967,6 +963,10 @@ declare class BaseWebhooks extends APIResource {
|
|
|
967
963
|
* Deletes a Webhook.
|
|
968
964
|
*/
|
|
969
965
|
delete(id: string, params?: WebhookDeleteParams | null | undefined, options?: RequestOptions): APIPromise<WebhookDeleteResponse>;
|
|
966
|
+
/**
|
|
967
|
+
* Gets a specific Webhook.
|
|
968
|
+
*/
|
|
969
|
+
get(id: string, params?: WebhookGetParams | null | undefined, options?: RequestOptions): APIPromise<Webhook>;
|
|
970
970
|
/**
|
|
971
971
|
* Sends a ping event to a Webhook.
|
|
972
972
|
*/
|
|
@@ -1107,7 +1107,7 @@ export declare interface BatchJob {
|
|
|
1107
1107
|
createTime?: string;
|
|
1108
1108
|
/** Output only. Time when the Job for the first time entered the `JOB_STATE_RUNNING` state. */
|
|
1109
1109
|
startTime?: string;
|
|
1110
|
-
/** The time when the BatchJob was completed. This field is for
|
|
1110
|
+
/** The time when the BatchJob was completed. This field is for Gemini Enterprise Agent Platform only.
|
|
1111
1111
|
*/
|
|
1112
1112
|
endTime?: string;
|
|
1113
1113
|
/** The time when the BatchJob was last updated.
|
|
@@ -1116,21 +1116,24 @@ export declare interface BatchJob {
|
|
|
1116
1116
|
/** The name of the model that produces the predictions via the BatchJob.
|
|
1117
1117
|
*/
|
|
1118
1118
|
model?: string;
|
|
1119
|
-
/** Configuration for the input data. This field is for
|
|
1119
|
+
/** Configuration for the input data. This field is for Gemini Enterprise Agent Platform only.
|
|
1120
1120
|
*/
|
|
1121
1121
|
src?: BatchJobSource;
|
|
1122
1122
|
/** Configuration for the output data.
|
|
1123
1123
|
*/
|
|
1124
1124
|
dest?: BatchJobDestination;
|
|
1125
|
-
/** Statistics on completed and failed prediction instances. This field is for
|
|
1125
|
+
/** Statistics on completed and failed prediction instances. This field is for Gemini Enterprise Agent Platform only.
|
|
1126
1126
|
*/
|
|
1127
1127
|
completionStats?: CompletionStats;
|
|
1128
|
+
/** Information further describing the output of this job. Output only.
|
|
1129
|
+
*/
|
|
1130
|
+
outputInfo?: BatchJobOutputInfo;
|
|
1128
1131
|
}
|
|
1129
1132
|
|
|
1130
1133
|
/** Config for `des` parameter. */
|
|
1131
1134
|
export declare interface BatchJobDestination {
|
|
1132
1135
|
/** Storage format of the output files. Must be one of:
|
|
1133
|
-
'jsonl', 'bigquery'.
|
|
1136
|
+
'jsonl', 'bigquery', 'vertex-dataset'.
|
|
1134
1137
|
*/
|
|
1135
1138
|
format?: string;
|
|
1136
1139
|
/** The Google Cloud Storage URI to the output file.
|
|
@@ -1156,14 +1159,27 @@ export declare interface BatchJobDestination {
|
|
|
1156
1159
|
the input requests.
|
|
1157
1160
|
*/
|
|
1158
1161
|
inlinedEmbedContentResponses?: InlinedEmbedContentResponse[];
|
|
1162
|
+
/** This field is experimental and may change in future versions. The Vertex AI dataset destination.
|
|
1163
|
+
*/
|
|
1164
|
+
vertexDataset?: VertexMultimodalDatasetDestination;
|
|
1159
1165
|
}
|
|
1160
1166
|
|
|
1161
1167
|
export declare type BatchJobDestinationUnion = BatchJobDestination | string;
|
|
1162
1168
|
|
|
1169
|
+
/** Represents the `output_info` field in batch jobs. */
|
|
1170
|
+
export declare interface BatchJobOutputInfo {
|
|
1171
|
+
/** This field is experimental and may change in future versions. The Vertex AI dataset name containing the output data. */
|
|
1172
|
+
vertexMultimodalDatasetName?: string;
|
|
1173
|
+
/** The full path of the Cloud Storage directory created, into which the prediction output is written. */
|
|
1174
|
+
gcsOutputDirectory?: string;
|
|
1175
|
+
/** The name of the BigQuery table created, in `predictions_<timestamp>` format, into which the prediction output is written. */
|
|
1176
|
+
bigqueryOutputTable?: string;
|
|
1177
|
+
}
|
|
1178
|
+
|
|
1163
1179
|
/** Config for `src` parameter. */
|
|
1164
1180
|
export declare interface BatchJobSource {
|
|
1165
1181
|
/** Storage format of the input files. Must be one of:
|
|
1166
|
-
'jsonl', 'bigquery'.
|
|
1182
|
+
'jsonl', 'bigquery', 'vertex-dataset'.
|
|
1167
1183
|
*/
|
|
1168
1184
|
format?: string;
|
|
1169
1185
|
/** The Google Cloud Storage URIs to input files.
|
|
@@ -1179,6 +1195,9 @@ export declare interface BatchJobSource {
|
|
|
1179
1195
|
/** The Gemini Developer API's inlined input data to run batch job.
|
|
1180
1196
|
*/
|
|
1181
1197
|
inlinedRequests?: InlinedRequest[];
|
|
1198
|
+
/** This field is experimental and may change in future versions. The Vertex AI dataset resource name to use as input. Must be of type multimodal.
|
|
1199
|
+
*/
|
|
1200
|
+
vertexDatasetName?: string;
|
|
1182
1201
|
}
|
|
1183
1202
|
|
|
1184
1203
|
export declare type BatchJobSourceUnion = BatchJobSource | InlinedRequest[] | string;
|
|
@@ -1322,7 +1341,7 @@ export declare class Caches extends BaseModule {
|
|
|
1322
1341
|
* @remarks
|
|
1323
1342
|
* Context caching is only supported for specific models. See [Gemini
|
|
1324
1343
|
* Developer API reference](https://ai.google.dev/gemini-api/docs/caching?lang=node/context-cac)
|
|
1325
|
-
* and [
|
|
1344
|
+
* and [Gemini Enterprise Agent Platform reference](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview#supported_models)
|
|
1326
1345
|
* for more information.
|
|
1327
1346
|
*
|
|
1328
1347
|
* @param params - The parameters for the create request.
|
|
@@ -1925,9 +1944,13 @@ declare namespace ContentDelta {
|
|
|
1925
1944
|
data?: string;
|
|
1926
1945
|
mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16' | 'audio/opus' | 'audio/alaw' | 'audio/mulaw';
|
|
1927
1946
|
/**
|
|
1928
|
-
*
|
|
1947
|
+
* @deprecated Deprecated. Use sample_rate instead. The value is ignored.
|
|
1929
1948
|
*/
|
|
1930
1949
|
rate?: number;
|
|
1950
|
+
/**
|
|
1951
|
+
* The sample rate of the audio.
|
|
1952
|
+
*/
|
|
1953
|
+
sample_rate?: number;
|
|
1931
1954
|
uri?: string;
|
|
1932
1955
|
}
|
|
1933
1956
|
interface Document {
|
|
@@ -2134,24 +2157,13 @@ declare namespace ContentDelta {
|
|
|
2134
2157
|
* Required. ID to match the ID from the function call block.
|
|
2135
2158
|
*/
|
|
2136
2159
|
call_id: string;
|
|
2137
|
-
result: Array<
|
|
2160
|
+
result: Array<unknown>;
|
|
2138
2161
|
type: 'file_search_result';
|
|
2139
2162
|
/**
|
|
2140
2163
|
* A signature hash for backend validation.
|
|
2141
2164
|
*/
|
|
2142
2165
|
signature?: string;
|
|
2143
2166
|
}
|
|
2144
|
-
namespace FileSearchResult {
|
|
2145
|
-
/**
|
|
2146
|
-
* The result of the File Search.
|
|
2147
|
-
*/
|
|
2148
|
-
interface Result {
|
|
2149
|
-
/**
|
|
2150
|
-
* User provided metadata about the FileSearchResult.
|
|
2151
|
-
*/
|
|
2152
|
-
custom_metadata?: Array<unknown>;
|
|
2153
|
-
}
|
|
2154
|
-
}
|
|
2155
2167
|
interface GoogleMapsResult {
|
|
2156
2168
|
/**
|
|
2157
2169
|
* Required. ID to match the ID from the function call block.
|
|
@@ -2181,7 +2193,7 @@ export declare interface ContentEmbedding {
|
|
|
2181
2193
|
/** A list of floats representing an embedding.
|
|
2182
2194
|
*/
|
|
2183
2195
|
values?: number[];
|
|
2184
|
-
/**
|
|
2196
|
+
/** Gemini Enterprise Agent Platform only. Statistics of the input text associated with this
|
|
2185
2197
|
embedding.
|
|
2186
2198
|
*/
|
|
2187
2199
|
statistics?: ContentEmbeddingStatistics;
|
|
@@ -2189,11 +2201,11 @@ export declare interface ContentEmbedding {
|
|
|
2189
2201
|
|
|
2190
2202
|
/** Statistics of the input text associated with the result of content embedding. */
|
|
2191
2203
|
export declare interface ContentEmbeddingStatistics {
|
|
2192
|
-
/**
|
|
2204
|
+
/** Gemini Enterprise Agent Platform only. If the input text was truncated due to having
|
|
2193
2205
|
a length longer than the allowed maximum input.
|
|
2194
2206
|
*/
|
|
2195
2207
|
truncated?: boolean;
|
|
2196
|
-
/**
|
|
2208
|
+
/** Gemini Enterprise Agent Platform only. Number of tokens of the input text.
|
|
2197
2209
|
*/
|
|
2198
2210
|
tokenCount?: number;
|
|
2199
2211
|
}
|
|
@@ -2687,9 +2699,9 @@ export declare interface CreateTuningJobConfig {
|
|
|
2687
2699
|
adapterSize?: AdapterSize;
|
|
2688
2700
|
/** Tuning mode for tuning. */
|
|
2689
2701
|
tuningMode?: TuningMode;
|
|
2690
|
-
/** Custom base model for tuning. This is only supported for OSS models in
|
|
2702
|
+
/** Custom base model for tuning. This is only supported for OSS models in Gemini Enterprise Agent Platform. */
|
|
2691
2703
|
customBaseModel?: string;
|
|
2692
|
-
/** The batch size hyperparameter for tuning. This is only supported for OSS models in
|
|
2704
|
+
/** The batch size hyperparameter for tuning. This is only supported for OSS models in Gemini Enterprise Agent Platform. */
|
|
2693
2705
|
batchSize?: number;
|
|
2694
2706
|
/** The learning rate for tuning. OSS models only. Mutually exclusive with learning_rate_multiplier. */
|
|
2695
2707
|
learningRate?: number;
|
|
@@ -3027,7 +3039,8 @@ export declare interface DistillationHyperParameters {
|
|
|
3027
3039
|
/** Optional. Multiplier for adjusting the default learning rate. */
|
|
3028
3040
|
learningRateMultiplier?: number;
|
|
3029
3041
|
/** The batch size hyperparameter for tuning.
|
|
3030
|
-
This is only supported for OSS models in
|
|
3042
|
+
This is only supported for OSS models in Gemini Enterprise Agent Platform.
|
|
3043
|
+
*/
|
|
3031
3044
|
batchSize?: number;
|
|
3032
3045
|
/** The learning rate for tuning. OSS models only. */
|
|
3033
3046
|
learningRate?: number;
|
|
@@ -3347,27 +3360,27 @@ export declare interface EmbedContentConfig {
|
|
|
3347
3360
|
using the earlier model (`models/embedding-001`).
|
|
3348
3361
|
*/
|
|
3349
3362
|
outputDimensionality?: number;
|
|
3350
|
-
/**
|
|
3363
|
+
/** Gemini Enterprise Agent Platform only. The MIME type of the input.
|
|
3351
3364
|
*/
|
|
3352
3365
|
mimeType?: string;
|
|
3353
|
-
/**
|
|
3366
|
+
/** Gemini Enterprise Agent Platform only. Whether to silently truncate inputs longer than
|
|
3354
3367
|
the max sequence length. If this option is set to false, oversized inputs
|
|
3355
3368
|
will lead to an INVALID_ARGUMENT error, similar to other text APIs.
|
|
3356
3369
|
*/
|
|
3357
3370
|
autoTruncate?: boolean;
|
|
3358
|
-
/**
|
|
3371
|
+
/** Gemini Enterprise Agent Platform only. Whether to enable OCR for document content.
|
|
3359
3372
|
Only applicable to Gemini Embedding 2 models.
|
|
3360
3373
|
*/
|
|
3361
3374
|
documentOcr?: boolean;
|
|
3362
|
-
/**
|
|
3375
|
+
/** Gemini Enterprise Agent Platform only. Whether to extract audio from video content.
|
|
3363
3376
|
Only applicable to Gemini Embedding 2 models.
|
|
3364
3377
|
*/
|
|
3365
3378
|
audioTrackExtraction?: boolean;
|
|
3366
3379
|
}
|
|
3367
3380
|
|
|
3368
|
-
/** Request-level metadata for the
|
|
3381
|
+
/** Request-level metadata for the Gemini Enterprise Agent Platform Embed Content API. */
|
|
3369
3382
|
export declare interface EmbedContentMetadata {
|
|
3370
|
-
/**
|
|
3383
|
+
/** Gemini Enterprise Agent Platform only. The total number of billable characters included
|
|
3371
3384
|
in the request.
|
|
3372
3385
|
*/
|
|
3373
3386
|
billableCharacterCount?: number;
|
|
@@ -3397,7 +3410,7 @@ export declare interface EmbedContentParametersPrivate {
|
|
|
3397
3410
|
/** The single content to embed. Only the `parts.text` fields will be counted.
|
|
3398
3411
|
*/
|
|
3399
3412
|
content?: ContentUnion;
|
|
3400
|
-
/** The
|
|
3413
|
+
/** The Gemini Enterprise Agent Platform embedding API to use.
|
|
3401
3414
|
*/
|
|
3402
3415
|
embeddingApiType?: EmbeddingApiType;
|
|
3403
3416
|
/** Configuration that contains optional parameters.
|
|
@@ -3413,12 +3426,12 @@ export declare class EmbedContentResponse {
|
|
|
3413
3426
|
the batch request.
|
|
3414
3427
|
*/
|
|
3415
3428
|
embeddings?: ContentEmbedding[];
|
|
3416
|
-
/**
|
|
3429
|
+
/** Gemini Enterprise Agent Platform only. Metadata about the request.
|
|
3417
3430
|
*/
|
|
3418
3431
|
metadata?: EmbedContentMetadata;
|
|
3419
3432
|
}
|
|
3420
3433
|
|
|
3421
|
-
/** Enum representing the
|
|
3434
|
+
/** Enum representing the Gemini Enterprise Agent Platform embedding API to use. */
|
|
3422
3435
|
export declare enum EmbeddingApiType {
|
|
3423
3436
|
/**
|
|
3424
3437
|
* predict API endpoint (default)
|
|
@@ -3701,6 +3714,12 @@ export { File_2 as File }
|
|
|
3701
3714
|
*/
|
|
3702
3715
|
declare interface FileCitation {
|
|
3703
3716
|
type: 'file_citation';
|
|
3717
|
+
/**
|
|
3718
|
+
* User provided metadata about the retrieved context.
|
|
3719
|
+
*/
|
|
3720
|
+
custom_metadata?: {
|
|
3721
|
+
[key: string]: unknown;
|
|
3722
|
+
};
|
|
3704
3723
|
/**
|
|
3705
3724
|
* The URI of the file.
|
|
3706
3725
|
*/
|
|
@@ -3713,6 +3732,14 @@ declare interface FileCitation {
|
|
|
3713
3732
|
* The name of the file.
|
|
3714
3733
|
*/
|
|
3715
3734
|
file_name?: string;
|
|
3735
|
+
/**
|
|
3736
|
+
* Media ID in-case of image citations, if applicable.
|
|
3737
|
+
*/
|
|
3738
|
+
media_id?: string;
|
|
3739
|
+
/**
|
|
3740
|
+
* Page number of the cited document, if applicable.
|
|
3741
|
+
*/
|
|
3742
|
+
page_number?: number;
|
|
3716
3743
|
/**
|
|
3717
3744
|
* Source attributed for a portion of the text.
|
|
3718
3745
|
*/
|
|
@@ -3755,7 +3782,7 @@ export declare class Files extends BaseModule {
|
|
|
3755
3782
|
list: (params?: types.ListFilesParameters) => Promise<Pager<types.File>>;
|
|
3756
3783
|
/**
|
|
3757
3784
|
* Uploads a file asynchronously to the Gemini API.
|
|
3758
|
-
* This method is not available in Vertex AI.
|
|
3785
|
+
* This method is not available in Gemini Enterprise Agent Platform (previously known as Vertex AI).
|
|
3759
3786
|
* Supported upload sources:
|
|
3760
3787
|
* - Node.js: File path (string) or Blob object.
|
|
3761
3788
|
* - Browser: Blob object (e.g., File).
|
|
@@ -3781,7 +3808,7 @@ export declare class Files extends BaseModule {
|
|
|
3781
3808
|
* @see {@link types.UploadFileParameters#config} for the optional
|
|
3782
3809
|
* config in the parameters.
|
|
3783
3810
|
* @return A promise that resolves to a `types.File` object.
|
|
3784
|
-
* @throws An error if called on a Vertex AI client.
|
|
3811
|
+
* @throws An error if called on a Gemini Enterprise Agent Platform (previously known as Vertex AI) client.
|
|
3785
3812
|
* @throws An error if the `mimeType` is not provided and can not be inferred,
|
|
3786
3813
|
* the `mimeType` can be provided in the `params.config` parameter.
|
|
3787
3814
|
* @throws An error occurs if a suitable upload location cannot be established.
|
|
@@ -3888,29 +3915,17 @@ declare interface FileSearchResultContent {
|
|
|
3888
3915
|
* Required. ID to match the ID from the function call block.
|
|
3889
3916
|
*/
|
|
3890
3917
|
call_id: string;
|
|
3918
|
+
type: 'file_search_result';
|
|
3891
3919
|
/**
|
|
3892
|
-
*
|
|
3920
|
+
* Optional. The results of the File Search.
|
|
3893
3921
|
*/
|
|
3894
|
-
result
|
|
3895
|
-
type: 'file_search_result';
|
|
3922
|
+
result?: Array<unknown>;
|
|
3896
3923
|
/**
|
|
3897
3924
|
* A signature hash for backend validation.
|
|
3898
3925
|
*/
|
|
3899
3926
|
signature?: string;
|
|
3900
3927
|
}
|
|
3901
3928
|
|
|
3902
|
-
declare namespace FileSearchResultContent {
|
|
3903
|
-
/**
|
|
3904
|
-
* The result of the File Search.
|
|
3905
|
-
*/
|
|
3906
|
-
interface Result {
|
|
3907
|
-
/**
|
|
3908
|
-
* User provided metadata about the FileSearchResult.
|
|
3909
|
-
*/
|
|
3910
|
-
custom_metadata?: Array<unknown>;
|
|
3911
|
-
}
|
|
3912
|
-
}
|
|
3913
|
-
|
|
3914
3929
|
/** A collection of Documents. */
|
|
3915
3930
|
export declare interface FileSearchStore {
|
|
3916
3931
|
/** The resource name of the FileSearchStore. Example: `fileSearchStores/my-file-search-store-123` */
|
|
@@ -3953,7 +3968,7 @@ declare class FileSearchStores extends BaseModule {
|
|
|
3953
3968
|
list: (params?: types.ListFileSearchStoresParameters) => Promise<Pager<types.FileSearchStore>>;
|
|
3954
3969
|
/**
|
|
3955
3970
|
* Uploads a file asynchronously to a given File Search Store.
|
|
3956
|
-
* This method is not available in Vertex AI.
|
|
3971
|
+
* This method is not available in Gemini Enterprise Agent Platform (previously known as Vertex AI).
|
|
3957
3972
|
* Supported upload sources:
|
|
3958
3973
|
* - Node.js: File path (string) or Blob object.
|
|
3959
3974
|
* - Browser: Blob object (e.g., File).
|
|
@@ -3972,7 +3987,7 @@ declare class FileSearchStores extends BaseModule {
|
|
|
3972
3987
|
* @see {@link types.UploadToFileSearchStoreParameters#config} for the optional
|
|
3973
3988
|
* config in the parameters.
|
|
3974
3989
|
* @return A promise that resolves to a long running operation.
|
|
3975
|
-
* @throws An error if called on a Vertex AI client.
|
|
3990
|
+
* @throws An error if called on a Gemini Enterprise Agent Platform (previously known as Vertex AI) client.
|
|
3976
3991
|
* @throws An error if the `mimeType` is not provided and can not be inferred,
|
|
3977
3992
|
* the `mimeType` can be provided in the `params.config` parameter.
|
|
3978
3993
|
* @throws An error occurs if a suitable upload location cannot be established.
|
|
@@ -4568,7 +4583,7 @@ export declare interface GenerateContentConfig {
|
|
|
4568
4583
|
*/
|
|
4569
4584
|
imageConfig?: ImageConfig;
|
|
4570
4585
|
/** Enables enhanced civic answers. It may not be available for all
|
|
4571
|
-
models. This field is not supported in
|
|
4586
|
+
models. This field is not supported in Gemini Enterprise Agent Platform.
|
|
4572
4587
|
*/
|
|
4573
4588
|
enableEnhancedCivicAnswers?: boolean;
|
|
4574
4589
|
/** Settings for prompt and response sanitization using the Model Armor
|
|
@@ -4949,6 +4964,8 @@ export declare interface GenerateVideosConfig {
|
|
|
4949
4964
|
/** Webhook configuration for receiving notifications when the
|
|
4950
4965
|
video generation operation completes. */
|
|
4951
4966
|
webhookConfig?: WebhookConfig;
|
|
4967
|
+
/** Resize mode of the image input for video generation. */
|
|
4968
|
+
resizeMode?: ImageResizeMode;
|
|
4952
4969
|
}
|
|
4953
4970
|
|
|
4954
4971
|
/** A video generation operation. */
|
|
@@ -5376,8 +5393,23 @@ export declare interface GoogleGenAIOptions {
|
|
|
5376
5393
|
* Optional. Determines whether to use the Vertex AI or the Gemini API.
|
|
5377
5394
|
*
|
|
5378
5395
|
* @remarks
|
|
5396
|
+
* When true, the {@link https://cloud.google.com/vertex-ai/docs/reference/rest | Gemini Enterprise Agent Platform API} will used.
|
|
5397
|
+
* When false, the {@link https://ai.google.dev/api | Gemini API} will be used.
|
|
5398
|
+
* When both enterprise and vertexai are set, and they have different values,
|
|
5399
|
+
* an Error will be thrown.
|
|
5400
|
+
*
|
|
5401
|
+
* If unset, default SDK behavior is to use the Gemini API service.
|
|
5402
|
+
*/
|
|
5403
|
+
enterprise?: boolean;
|
|
5404
|
+
/**
|
|
5405
|
+
* Optional. Determines whether to use the Vertex AI (now Gemini Enterprise Agent Platform) or the Gemini API.
|
|
5406
|
+
* The `enterprise` flag is recommended instead.
|
|
5407
|
+
*
|
|
5408
|
+
* @remarks
|
|
5379
5409
|
* When true, the {@link https://cloud.google.com/vertex-ai/docs/reference/rest | Vertex AI API} will used.
|
|
5380
5410
|
* When false, the {@link https://ai.google.dev/api | Gemini API} will be used.
|
|
5411
|
+
* When both enterprise and vertexai are set, and they have different values,
|
|
5412
|
+
* an Error will be thrown.
|
|
5381
5413
|
*
|
|
5382
5414
|
* If unset, default SDK behavior is to use the Gemini API service.
|
|
5383
5415
|
*/
|
|
@@ -5780,6 +5812,8 @@ export declare interface GroundingChunkRetrievedContext {
|
|
|
5780
5812
|
customMetadata?: GroundingChunkCustomMetadata[];
|
|
5781
5813
|
/** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
|
|
5782
5814
|
fileSearchStore?: string;
|
|
5815
|
+
/** Optional. Page number of the retrieved context. This field is not supported in Vertex AI. */
|
|
5816
|
+
pageNumber?: number;
|
|
5783
5817
|
}
|
|
5784
5818
|
|
|
5785
5819
|
/** A list of string values. This data type is not supported in Vertex AI. */
|
|
@@ -6040,7 +6074,7 @@ export declare interface HttpOptions {
|
|
|
6040
6074
|
timeout?: number;
|
|
6041
6075
|
/** Extra parameters to add to the request body.
|
|
6042
6076
|
The structure must match the backend API's request structure.
|
|
6043
|
-
-
|
|
6077
|
+
- Gemini Enterprise Agent Platform backend API docs: https://cloud.google.com/vertex-ai/docs/reference/rest
|
|
6044
6078
|
- GeminiAPI backend API docs: https://ai.google.dev/api/rest */
|
|
6045
6079
|
extraBody?: Record<string, unknown>;
|
|
6046
6080
|
/** HTTP retry options for the request. */
|
|
@@ -6228,6 +6262,20 @@ export declare enum ImagePromptLanguage {
|
|
|
6228
6262
|
es = "es"
|
|
6229
6263
|
}
|
|
6230
6264
|
|
|
6265
|
+
/** Resize mode for the image input for video generation. */
|
|
6266
|
+
export declare enum ImageResizeMode {
|
|
6267
|
+
/**
|
|
6268
|
+
* Crop the image to fit the correct aspect ratio (so we lose parts
|
|
6269
|
+
of the image in the process).
|
|
6270
|
+
*/
|
|
6271
|
+
CROP = "CROP",
|
|
6272
|
+
/**
|
|
6273
|
+
* Pad the image to fit the correct aspect ratio (so we don't lose
|
|
6274
|
+
any parts of the image in the process).
|
|
6275
|
+
*/
|
|
6276
|
+
PAD = "PAD"
|
|
6277
|
+
}
|
|
6278
|
+
|
|
6231
6279
|
/** Image search for grounding and related configurations. */
|
|
6232
6280
|
export declare interface ImageSearch {
|
|
6233
6281
|
}
|
|
@@ -6351,7 +6399,7 @@ declare interface Interaction {
|
|
|
6351
6399
|
/**
|
|
6352
6400
|
* The name of the `Agent` used for generating the interaction.
|
|
6353
6401
|
*/
|
|
6354
|
-
agent?:
|
|
6402
|
+
agent?: 'deep-research-pro-preview-12-2025' | 'deep-research-preview-04-2026' | 'deep-research-max-preview-04-2026' | (string & {});
|
|
6355
6403
|
/**
|
|
6356
6404
|
* Configuration parameters for the agent interaction.
|
|
6357
6405
|
*/
|
|
@@ -8001,7 +8049,7 @@ export declare interface Model {
|
|
|
8001
8049
|
* The model that will complete your prompt.\n\nSee
|
|
8002
8050
|
* [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
|
|
8003
8051
|
*/
|
|
8004
|
-
declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
|
|
8052
|
+
declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-3.1-flash-tts-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
|
|
8005
8053
|
|
|
8006
8054
|
/** Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks. This data type is not supported in Gemini API. */
|
|
8007
8055
|
export declare interface ModelArmorConfig {
|
|
@@ -8039,7 +8087,7 @@ export declare class Models extends BaseModule {
|
|
|
8039
8087
|
/**
|
|
8040
8088
|
* Makes an API request to generate content with a given model.
|
|
8041
8089
|
*
|
|
8042
|
-
* For the `model` parameter, supported formats for
|
|
8090
|
+
* For the `model` parameter, supported formats for Gemini Enterprise Agent Platform API include:
|
|
8043
8091
|
* - The Gemini model ID, for example: 'gemini-2.0-flash'
|
|
8044
8092
|
* - The full resource name starts with 'projects/', for example:
|
|
8045
8093
|
* 'projects/my-project-id/locations/us-central1/publishers/google/models/gemini-2.0-flash'
|
|
@@ -8087,7 +8135,7 @@ export declare class Models extends BaseModule {
|
|
|
8087
8135
|
* Makes an API request to generate content with a given model and yields the
|
|
8088
8136
|
* response in chunks.
|
|
8089
8137
|
*
|
|
8090
|
-
* For the `model` parameter, supported formats for
|
|
8138
|
+
* For the `model` parameter, supported formats for Gemini Enterprise Agent Platform API include:
|
|
8091
8139
|
* - The Gemini model ID, for example: 'gemini-2.0-flash'
|
|
8092
8140
|
* - The full resource name starts with 'projects/', for example:
|
|
8093
8141
|
* 'projects/my-project-id/locations/us-central1/publishers/google/models/gemini-2.0-flash'
|
|
@@ -8178,7 +8226,7 @@ export declare class Models extends BaseModule {
|
|
|
8178
8226
|
editImage: (params: types.EditImageParameters) => Promise<types.EditImageResponse>;
|
|
8179
8227
|
/**
|
|
8180
8228
|
* Upscales an image based on an image, upscale factor, and configuration.
|
|
8181
|
-
* Only supported in
|
|
8229
|
+
* Only supported in Gemini Enterprise Agent Platform currently.
|
|
8182
8230
|
*
|
|
8183
8231
|
* @param params - The parameters for upscaling an image.
|
|
8184
8232
|
* @return The response from the API.
|
|
@@ -9949,6 +9997,20 @@ export declare interface SessionResumptionConfig {
|
|
|
9949
9997
|
*/
|
|
9950
9998
|
export declare function setDefaultBaseUrls(baseUrlParams: BaseUrlParameters): void;
|
|
9951
9999
|
|
|
10000
|
+
/**
|
|
10001
|
+
* Represents a signing secret used to verify webhook payloads.
|
|
10002
|
+
*/
|
|
10003
|
+
declare interface SigningSecret {
|
|
10004
|
+
/**
|
|
10005
|
+
* Output only. The expiration date of the signing secret.
|
|
10006
|
+
*/
|
|
10007
|
+
expire_time?: string;
|
|
10008
|
+
/**
|
|
10009
|
+
* Output only. The truncated version of the signing secret.
|
|
10010
|
+
*/
|
|
10011
|
+
truncated_secret?: string;
|
|
10012
|
+
}
|
|
10013
|
+
|
|
9952
10014
|
/** Config for `response` parameter. */
|
|
9953
10015
|
export declare class SingleEmbedContentResponse {
|
|
9954
10016
|
/** The response to the request.
|
|
@@ -10757,7 +10819,7 @@ export declare interface TunedModelInfo {
|
|
|
10757
10819
|
export declare interface TuningDataset {
|
|
10758
10820
|
/** GCS URI of the file containing training dataset in JSONL format. */
|
|
10759
10821
|
gcsUri?: string;
|
|
10760
|
-
/** The resource name of the Vertex Multimodal Dataset that is used as training dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
|
|
10822
|
+
/** The resource name of the Gemini Enterprise Agent Platform (previously known as Vertex AI) Multimodal Dataset that is used as training dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
|
|
10761
10823
|
vertexDatasetResource?: string;
|
|
10762
10824
|
/** Inline examples with simple input/output text. */
|
|
10763
10825
|
examples?: TuningExample[];
|
|
@@ -11008,7 +11070,7 @@ export declare enum TuningTask {
|
|
|
11008
11070
|
export declare interface TuningValidationDataset {
|
|
11009
11071
|
/** GCS URI of the file containing validation dataset in JSONL format. */
|
|
11010
11072
|
gcsUri?: string;
|
|
11011
|
-
/** The resource name of the Vertex Multimodal Dataset that is used as validation dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
|
|
11073
|
+
/** The resource name of the Gemini Enterprise Agent Platform (previously known as Vertex AI) Multimodal Dataset that is used as validation dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
|
|
11012
11074
|
vertexDatasetResource?: string;
|
|
11013
11075
|
}
|
|
11014
11076
|
|
|
@@ -11256,6 +11318,7 @@ declare namespace types {
|
|
|
11256
11318
|
VideoGenerationReferenceType,
|
|
11257
11319
|
VideoGenerationMaskMode,
|
|
11258
11320
|
VideoCompressionQuality,
|
|
11321
|
+
ImageResizeMode,
|
|
11259
11322
|
TuningMethod,
|
|
11260
11323
|
FileState,
|
|
11261
11324
|
FileSource,
|
|
@@ -11573,6 +11636,7 @@ declare namespace types {
|
|
|
11573
11636
|
RegisterFilesResponse,
|
|
11574
11637
|
InlinedRequest,
|
|
11575
11638
|
BatchJobSource,
|
|
11639
|
+
VertexMultimodalDatasetDestination,
|
|
11576
11640
|
JobError,
|
|
11577
11641
|
InlinedResponse,
|
|
11578
11642
|
SingleEmbedContentResponse,
|
|
@@ -11580,6 +11644,7 @@ declare namespace types {
|
|
|
11580
11644
|
BatchJobDestination,
|
|
11581
11645
|
CreateBatchJobConfig,
|
|
11582
11646
|
CreateBatchJobParameters,
|
|
11647
|
+
BatchJobOutputInfo,
|
|
11583
11648
|
CompletionStats,
|
|
11584
11649
|
BatchJob,
|
|
11585
11650
|
EmbedContentBatch,
|
|
@@ -12116,6 +12181,10 @@ declare interface Usage {
|
|
|
12116
12181
|
* A breakdown of cached token usage by modality.
|
|
12117
12182
|
*/
|
|
12118
12183
|
cached_tokens_by_modality?: Array<Usage.CachedTokensByModality>;
|
|
12184
|
+
/**
|
|
12185
|
+
* Grounding tool count.
|
|
12186
|
+
*/
|
|
12187
|
+
grounding_tool_count?: Array<Usage.GroundingToolCount>;
|
|
12119
12188
|
/**
|
|
12120
12189
|
* A breakdown of input token usage by modality.
|
|
12121
12190
|
*/
|
|
@@ -12169,6 +12238,19 @@ declare namespace Usage {
|
|
|
12169
12238
|
*/
|
|
12170
12239
|
tokens?: number;
|
|
12171
12240
|
}
|
|
12241
|
+
/**
|
|
12242
|
+
* The number of grounding tool counts.
|
|
12243
|
+
*/
|
|
12244
|
+
interface GroundingToolCount {
|
|
12245
|
+
/**
|
|
12246
|
+
* The number of grounding tool counts.
|
|
12247
|
+
*/
|
|
12248
|
+
count?: number;
|
|
12249
|
+
/**
|
|
12250
|
+
* The grounding tool type associated with the count.
|
|
12251
|
+
*/
|
|
12252
|
+
type?: 'google_search' | 'google_maps' | 'retrieval';
|
|
12253
|
+
}
|
|
12172
12254
|
/**
|
|
12173
12255
|
* The token count for a single response modality.
|
|
12174
12256
|
*/
|
|
@@ -12297,6 +12379,16 @@ export declare interface VertexAISearchDataStoreSpec {
|
|
|
12297
12379
|
filter?: string;
|
|
12298
12380
|
}
|
|
12299
12381
|
|
|
12382
|
+
/** This class is experimental and may change in future versions.
|
|
12383
|
+
|
|
12384
|
+
The specification for an output Vertex AI multimodal dataset. */
|
|
12385
|
+
export declare interface VertexMultimodalDatasetDestination {
|
|
12386
|
+
/** The BigQuery destination for the multimodal dataset. */
|
|
12387
|
+
bigqueryDestination?: string;
|
|
12388
|
+
/** The display name of the multimodal dataset. */
|
|
12389
|
+
displayName?: string;
|
|
12390
|
+
}
|
|
12391
|
+
|
|
12300
12392
|
/** Retrieve from Vertex RAG Store for grounding. This data type is not supported in Gemini API. */
|
|
12301
12393
|
export declare interface VertexRagStore {
|
|
12302
12394
|
/** Optional. Deprecated. Please use rag_resources instead. */
|
|
@@ -12477,6 +12569,56 @@ export declare interface VoiceConfig {
|
|
|
12477
12569
|
prebuiltVoiceConfig?: PrebuiltVoiceConfig;
|
|
12478
12570
|
}
|
|
12479
12571
|
|
|
12572
|
+
/**
|
|
12573
|
+
* A Webhook resource.
|
|
12574
|
+
*/
|
|
12575
|
+
declare interface Webhook {
|
|
12576
|
+
/**
|
|
12577
|
+
* Required. The events that the webhook is subscribed to. Available events:
|
|
12578
|
+
*
|
|
12579
|
+
* - batch.succeeded
|
|
12580
|
+
* - batch.expired
|
|
12581
|
+
* - batch.failed
|
|
12582
|
+
* - interaction.requires_action
|
|
12583
|
+
* - interaction.completed
|
|
12584
|
+
* - interaction.failed
|
|
12585
|
+
* - video.generated
|
|
12586
|
+
*/
|
|
12587
|
+
subscribed_events: Array<'batch.succeeded' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'video.generated' | (string & {})>;
|
|
12588
|
+
/**
|
|
12589
|
+
* Required. The URI to which webhook events will be sent.
|
|
12590
|
+
*/
|
|
12591
|
+
uri: string;
|
|
12592
|
+
/**
|
|
12593
|
+
* Output only. The ID of the webhook.
|
|
12594
|
+
*/
|
|
12595
|
+
id?: string;
|
|
12596
|
+
/**
|
|
12597
|
+
* Output only. The timestamp when the webhook was created.
|
|
12598
|
+
*/
|
|
12599
|
+
create_time?: string;
|
|
12600
|
+
/**
|
|
12601
|
+
* Optional. The user-provided name of the webhook.
|
|
12602
|
+
*/
|
|
12603
|
+
name?: string;
|
|
12604
|
+
/**
|
|
12605
|
+
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
12606
|
+
*/
|
|
12607
|
+
new_signing_secret?: string;
|
|
12608
|
+
/**
|
|
12609
|
+
* Output only. The signing secrets associated with this webhook.
|
|
12610
|
+
*/
|
|
12611
|
+
signing_secrets?: Array<SigningSecret>;
|
|
12612
|
+
/**
|
|
12613
|
+
* Output only. The state of the webhook.
|
|
12614
|
+
*/
|
|
12615
|
+
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12616
|
+
/**
|
|
12617
|
+
* Output only. The timestamp when the webhook was last updated.
|
|
12618
|
+
*/
|
|
12619
|
+
update_time?: string;
|
|
12620
|
+
}
|
|
12621
|
+
|
|
12480
12622
|
/** Configuration for webhook notifications.
|
|
12481
12623
|
|
|
12482
12624
|
Used to configure webhook endpoints that will receive notifications
|
|
@@ -12519,97 +12661,22 @@ declare interface WebhookCreateParams {
|
|
|
12519
12661
|
* events:
|
|
12520
12662
|
*
|
|
12521
12663
|
* - batch.succeeded
|
|
12522
|
-
* - batch.cancelled
|
|
12523
12664
|
* - batch.expired
|
|
12524
12665
|
* - batch.failed
|
|
12525
12666
|
* - interaction.requires_action
|
|
12526
12667
|
* - interaction.completed
|
|
12527
12668
|
* - interaction.failed
|
|
12528
|
-
* - interaction.cancelled
|
|
12529
12669
|
* - video.generated
|
|
12530
12670
|
*/
|
|
12531
|
-
subscribed_events: Array<'batch.succeeded' | 'batch.
|
|
12671
|
+
subscribed_events: Array<'batch.succeeded' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'video.generated' | (string & {})>;
|
|
12532
12672
|
/**
|
|
12533
12673
|
* Body param: Required. The URI to which webhook events will be sent.
|
|
12534
12674
|
*/
|
|
12535
12675
|
uri: string;
|
|
12536
12676
|
/**
|
|
12537
|
-
*
|
|
12538
|
-
* the server will generate a unique ID.
|
|
12539
|
-
*/
|
|
12540
|
-
webhook_id?: string;
|
|
12541
|
-
/**
|
|
12542
|
-
* Body param: Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
|
|
12677
|
+
* Body param: Optional. The user-provided name of the webhook.
|
|
12543
12678
|
*/
|
|
12544
12679
|
name?: string;
|
|
12545
|
-
/**
|
|
12546
|
-
* Body param: The state of the webhook.
|
|
12547
|
-
*/
|
|
12548
|
-
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12549
|
-
}
|
|
12550
|
-
|
|
12551
|
-
/**
|
|
12552
|
-
* A Webhook resource.
|
|
12553
|
-
*/
|
|
12554
|
-
declare interface WebhookCreateResponse {
|
|
12555
|
-
/**
|
|
12556
|
-
* Required. The events that the webhook is subscribed to. Available events:
|
|
12557
|
-
*
|
|
12558
|
-
* - batch.succeeded
|
|
12559
|
-
* - batch.cancelled
|
|
12560
|
-
* - batch.expired
|
|
12561
|
-
* - batch.failed
|
|
12562
|
-
* - interaction.requires_action
|
|
12563
|
-
* - interaction.completed
|
|
12564
|
-
* - interaction.failed
|
|
12565
|
-
* - interaction.cancelled
|
|
12566
|
-
* - video.generated
|
|
12567
|
-
*/
|
|
12568
|
-
subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
|
|
12569
|
-
/**
|
|
12570
|
-
* Required. The URI to which webhook events will be sent.
|
|
12571
|
-
*/
|
|
12572
|
-
uri: string;
|
|
12573
|
-
/**
|
|
12574
|
-
* Output only. The timestamp when the webhook was created.
|
|
12575
|
-
*/
|
|
12576
|
-
create_time?: string;
|
|
12577
|
-
/**
|
|
12578
|
-
* Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
|
|
12579
|
-
*/
|
|
12580
|
-
name?: string;
|
|
12581
|
-
/**
|
|
12582
|
-
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
12583
|
-
*/
|
|
12584
|
-
new_signing_secret?: string;
|
|
12585
|
-
/**
|
|
12586
|
-
* Output only. The signing secrets associated with this webhook.
|
|
12587
|
-
*/
|
|
12588
|
-
signing_secrets?: Array<WebhookCreateResponse.SigningSecret>;
|
|
12589
|
-
/**
|
|
12590
|
-
* The state of the webhook.
|
|
12591
|
-
*/
|
|
12592
|
-
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12593
|
-
/**
|
|
12594
|
-
* Output only. The timestamp when the webhook was last updated.
|
|
12595
|
-
*/
|
|
12596
|
-
update_time?: string;
|
|
12597
|
-
}
|
|
12598
|
-
|
|
12599
|
-
declare namespace WebhookCreateResponse {
|
|
12600
|
-
/**
|
|
12601
|
-
* Represents a signing secret used to verify webhook payloads.
|
|
12602
|
-
*/
|
|
12603
|
-
interface SigningSecret {
|
|
12604
|
-
/**
|
|
12605
|
-
* Output only. The expiration date of the signing secret.
|
|
12606
|
-
*/
|
|
12607
|
-
expire_time?: string;
|
|
12608
|
-
/**
|
|
12609
|
-
* Output only. The truncated version of the signing secret.
|
|
12610
|
-
*/
|
|
12611
|
-
truncated_secret?: string;
|
|
12612
|
-
}
|
|
12613
12680
|
}
|
|
12614
12681
|
|
|
12615
12682
|
declare interface WebhookDeleteParams {
|
|
@@ -12631,6 +12698,13 @@ declare interface WebhookDeleteParams {
|
|
|
12631
12698
|
declare interface WebhookDeleteResponse {
|
|
12632
12699
|
}
|
|
12633
12700
|
|
|
12701
|
+
declare interface WebhookGetParams {
|
|
12702
|
+
/**
|
|
12703
|
+
* Which version of the API to use.
|
|
12704
|
+
*/
|
|
12705
|
+
api_version?: string;
|
|
12706
|
+
}
|
|
12707
|
+
|
|
12634
12708
|
declare interface WebhookListParams {
|
|
12635
12709
|
/**
|
|
12636
12710
|
* Path param: Which version of the API to use.
|
|
@@ -12661,72 +12735,7 @@ declare interface WebhookListResponse {
|
|
|
12661
12735
|
/**
|
|
12662
12736
|
* The webhooks.
|
|
12663
12737
|
*/
|
|
12664
|
-
webhooks?: Array<
|
|
12665
|
-
}
|
|
12666
|
-
|
|
12667
|
-
declare namespace WebhookListResponse {
|
|
12668
|
-
/**
|
|
12669
|
-
* A Webhook resource.
|
|
12670
|
-
*/
|
|
12671
|
-
interface Webhook {
|
|
12672
|
-
/**
|
|
12673
|
-
* Required. The events that the webhook is subscribed to. Available events:
|
|
12674
|
-
*
|
|
12675
|
-
* - batch.succeeded
|
|
12676
|
-
* - batch.cancelled
|
|
12677
|
-
* - batch.expired
|
|
12678
|
-
* - batch.failed
|
|
12679
|
-
* - interaction.requires_action
|
|
12680
|
-
* - interaction.completed
|
|
12681
|
-
* - interaction.failed
|
|
12682
|
-
* - interaction.cancelled
|
|
12683
|
-
* - video.generated
|
|
12684
|
-
*/
|
|
12685
|
-
subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
|
|
12686
|
-
/**
|
|
12687
|
-
* Required. The URI to which webhook events will be sent.
|
|
12688
|
-
*/
|
|
12689
|
-
uri: string;
|
|
12690
|
-
/**
|
|
12691
|
-
* Output only. The timestamp when the webhook was created.
|
|
12692
|
-
*/
|
|
12693
|
-
create_time?: string;
|
|
12694
|
-
/**
|
|
12695
|
-
* Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
|
|
12696
|
-
*/
|
|
12697
|
-
name?: string;
|
|
12698
|
-
/**
|
|
12699
|
-
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
12700
|
-
*/
|
|
12701
|
-
new_signing_secret?: string;
|
|
12702
|
-
/**
|
|
12703
|
-
* Output only. The signing secrets associated with this webhook.
|
|
12704
|
-
*/
|
|
12705
|
-
signing_secrets?: Array<Webhook.SigningSecret>;
|
|
12706
|
-
/**
|
|
12707
|
-
* The state of the webhook.
|
|
12708
|
-
*/
|
|
12709
|
-
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12710
|
-
/**
|
|
12711
|
-
* Output only. The timestamp when the webhook was last updated.
|
|
12712
|
-
*/
|
|
12713
|
-
update_time?: string;
|
|
12714
|
-
}
|
|
12715
|
-
namespace Webhook {
|
|
12716
|
-
/**
|
|
12717
|
-
* Represents a signing secret used to verify webhook payloads.
|
|
12718
|
-
*/
|
|
12719
|
-
interface SigningSecret {
|
|
12720
|
-
/**
|
|
12721
|
-
* Output only. The expiration date of the signing secret.
|
|
12722
|
-
*/
|
|
12723
|
-
expire_time?: string;
|
|
12724
|
-
/**
|
|
12725
|
-
* Output only. The truncated version of the signing secret.
|
|
12726
|
-
*/
|
|
12727
|
-
truncated_secret?: string;
|
|
12728
|
-
}
|
|
12729
|
-
}
|
|
12738
|
+
webhooks?: Array<Webhook>;
|
|
12730
12739
|
}
|
|
12731
12740
|
|
|
12732
12741
|
declare interface WebhookPingParams {
|
|
@@ -12754,77 +12763,6 @@ declare namespace WebhookPingParams {
|
|
|
12754
12763
|
declare interface WebhookPingResponse {
|
|
12755
12764
|
}
|
|
12756
12765
|
|
|
12757
|
-
declare interface WebhookRetrieveParams {
|
|
12758
|
-
/**
|
|
12759
|
-
* Which version of the API to use.
|
|
12760
|
-
*/
|
|
12761
|
-
api_version?: string;
|
|
12762
|
-
}
|
|
12763
|
-
|
|
12764
|
-
/**
|
|
12765
|
-
* A Webhook resource.
|
|
12766
|
-
*/
|
|
12767
|
-
declare interface WebhookRetrieveResponse {
|
|
12768
|
-
/**
|
|
12769
|
-
* Required. The events that the webhook is subscribed to. Available events:
|
|
12770
|
-
*
|
|
12771
|
-
* - batch.succeeded
|
|
12772
|
-
* - batch.cancelled
|
|
12773
|
-
* - batch.expired
|
|
12774
|
-
* - batch.failed
|
|
12775
|
-
* - interaction.requires_action
|
|
12776
|
-
* - interaction.completed
|
|
12777
|
-
* - interaction.failed
|
|
12778
|
-
* - interaction.cancelled
|
|
12779
|
-
* - video.generated
|
|
12780
|
-
*/
|
|
12781
|
-
subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
|
|
12782
|
-
/**
|
|
12783
|
-
* Required. The URI to which webhook events will be sent.
|
|
12784
|
-
*/
|
|
12785
|
-
uri: string;
|
|
12786
|
-
/**
|
|
12787
|
-
* Output only. The timestamp when the webhook was created.
|
|
12788
|
-
*/
|
|
12789
|
-
create_time?: string;
|
|
12790
|
-
/**
|
|
12791
|
-
* Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
|
|
12792
|
-
*/
|
|
12793
|
-
name?: string;
|
|
12794
|
-
/**
|
|
12795
|
-
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
12796
|
-
*/
|
|
12797
|
-
new_signing_secret?: string;
|
|
12798
|
-
/**
|
|
12799
|
-
* Output only. The signing secrets associated with this webhook.
|
|
12800
|
-
*/
|
|
12801
|
-
signing_secrets?: Array<WebhookRetrieveResponse.SigningSecret>;
|
|
12802
|
-
/**
|
|
12803
|
-
* The state of the webhook.
|
|
12804
|
-
*/
|
|
12805
|
-
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12806
|
-
/**
|
|
12807
|
-
* Output only. The timestamp when the webhook was last updated.
|
|
12808
|
-
*/
|
|
12809
|
-
update_time?: string;
|
|
12810
|
-
}
|
|
12811
|
-
|
|
12812
|
-
declare namespace WebhookRetrieveResponse {
|
|
12813
|
-
/**
|
|
12814
|
-
* Represents a signing secret used to verify webhook payloads.
|
|
12815
|
-
*/
|
|
12816
|
-
interface SigningSecret {
|
|
12817
|
-
/**
|
|
12818
|
-
* Output only. The expiration date of the signing secret.
|
|
12819
|
-
*/
|
|
12820
|
-
expire_time?: string;
|
|
12821
|
-
/**
|
|
12822
|
-
* Output only. The truncated version of the signing secret.
|
|
12823
|
-
*/
|
|
12824
|
-
truncated_secret?: string;
|
|
12825
|
-
}
|
|
12826
|
-
}
|
|
12827
|
-
|
|
12828
12766
|
declare interface WebhookRotateSigningSecretParams {
|
|
12829
12767
|
/**
|
|
12830
12768
|
* Path param: Which version of the API to use.
|
|
@@ -12850,7 +12788,7 @@ export declare class Webhooks extends BaseWebhooks {
|
|
|
12850
12788
|
}
|
|
12851
12789
|
|
|
12852
12790
|
export declare namespace Webhooks {
|
|
12853
|
-
export { type
|
|
12791
|
+
export { type SigningSecret as SigningSecret, type Webhook as Webhook, type WebhookListResponse as WebhookListResponse, type WebhookDeleteResponse as WebhookDeleteResponse, type WebhookPingResponse as WebhookPingResponse, type WebhookRotateSigningSecretResponse as WebhookRotateSigningSecretResponse, type WebhookCreateParams as WebhookCreateParams, type WebhookUpdateParams as WebhookUpdateParams, type WebhookListParams as WebhookListParams, type WebhookDeleteParams as WebhookDeleteParams, type WebhookGetParams as WebhookGetParams, type WebhookPingParams as WebhookPingParams, type WebhookRotateSigningSecretParams as WebhookRotateSigningSecretParams, };
|
|
12854
12792
|
}
|
|
12855
12793
|
|
|
12856
12794
|
declare interface WebhookUpdateParams {
|
|
@@ -12858,101 +12796,35 @@ declare interface WebhookUpdateParams {
|
|
|
12858
12796
|
* Path param: Which version of the API to use.
|
|
12859
12797
|
*/
|
|
12860
12798
|
api_version?: string;
|
|
12861
|
-
/**
|
|
12862
|
-
* Body param: Required. The events that the webhook is subscribed to. Available
|
|
12863
|
-
* events:
|
|
12864
|
-
*
|
|
12865
|
-
* - batch.succeeded
|
|
12866
|
-
* - batch.cancelled
|
|
12867
|
-
* - batch.expired
|
|
12868
|
-
* - batch.failed
|
|
12869
|
-
* - interaction.requires_action
|
|
12870
|
-
* - interaction.completed
|
|
12871
|
-
* - interaction.failed
|
|
12872
|
-
* - interaction.cancelled
|
|
12873
|
-
* - video.generated
|
|
12874
|
-
*/
|
|
12875
|
-
subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
|
|
12876
|
-
/**
|
|
12877
|
-
* Body param: Required. The URI to which webhook events will be sent.
|
|
12878
|
-
*/
|
|
12879
|
-
uri: string;
|
|
12880
12799
|
/**
|
|
12881
12800
|
* Query param: Optional. The list of fields to update.
|
|
12882
12801
|
*/
|
|
12883
12802
|
update_mask?: string;
|
|
12884
12803
|
/**
|
|
12885
|
-
* Body param:
|
|
12804
|
+
* Body param: Optional. The user-provided name of the webhook.
|
|
12886
12805
|
*/
|
|
12887
12806
|
name?: string;
|
|
12888
12807
|
/**
|
|
12889
|
-
* Body param: The state of the webhook.
|
|
12808
|
+
* Body param: Optional. The state of the webhook.
|
|
12890
12809
|
*/
|
|
12891
12810
|
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12892
|
-
}
|
|
12893
|
-
|
|
12894
|
-
/**
|
|
12895
|
-
* A Webhook resource.
|
|
12896
|
-
*/
|
|
12897
|
-
declare interface WebhookUpdateResponse {
|
|
12898
12811
|
/**
|
|
12899
|
-
*
|
|
12812
|
+
* Body param: Optional. The events that the webhook is subscribed to. Available
|
|
12813
|
+
* events:
|
|
12900
12814
|
*
|
|
12901
12815
|
* - batch.succeeded
|
|
12902
|
-
* - batch.cancelled
|
|
12903
12816
|
* - batch.expired
|
|
12904
12817
|
* - batch.failed
|
|
12905
12818
|
* - interaction.requires_action
|
|
12906
12819
|
* - interaction.completed
|
|
12907
12820
|
* - interaction.failed
|
|
12908
|
-
* - interaction.cancelled
|
|
12909
12821
|
* - video.generated
|
|
12910
12822
|
*/
|
|
12911
|
-
subscribed_events
|
|
12912
|
-
/**
|
|
12913
|
-
* Required. The URI to which webhook events will be sent.
|
|
12914
|
-
*/
|
|
12915
|
-
uri: string;
|
|
12916
|
-
/**
|
|
12917
|
-
* Output only. The timestamp when the webhook was created.
|
|
12918
|
-
*/
|
|
12919
|
-
create_time?: string;
|
|
12920
|
-
/**
|
|
12921
|
-
* Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
|
|
12922
|
-
*/
|
|
12923
|
-
name?: string;
|
|
12924
|
-
/**
|
|
12925
|
-
* Output only. The new signing secret for the webhook. Only populated on create.
|
|
12926
|
-
*/
|
|
12927
|
-
new_signing_secret?: string;
|
|
12928
|
-
/**
|
|
12929
|
-
* Output only. The signing secrets associated with this webhook.
|
|
12930
|
-
*/
|
|
12931
|
-
signing_secrets?: Array<WebhookUpdateResponse.SigningSecret>;
|
|
12932
|
-
/**
|
|
12933
|
-
* The state of the webhook.
|
|
12934
|
-
*/
|
|
12935
|
-
state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
|
|
12936
|
-
/**
|
|
12937
|
-
* Output only. The timestamp when the webhook was last updated.
|
|
12938
|
-
*/
|
|
12939
|
-
update_time?: string;
|
|
12940
|
-
}
|
|
12941
|
-
|
|
12942
|
-
declare namespace WebhookUpdateResponse {
|
|
12823
|
+
subscribed_events?: Array<'batch.succeeded' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'video.generated' | (string & {})>;
|
|
12943
12824
|
/**
|
|
12944
|
-
*
|
|
12825
|
+
* Body param: Optional. The URI to which webhook events will be sent.
|
|
12945
12826
|
*/
|
|
12946
|
-
|
|
12947
|
-
/**
|
|
12948
|
-
* Output only. The expiration date of the signing secret.
|
|
12949
|
-
*/
|
|
12950
|
-
expire_time?: string;
|
|
12951
|
-
/**
|
|
12952
|
-
* Output only. The truncated version of the signing secret.
|
|
12953
|
-
*/
|
|
12954
|
-
truncated_secret?: string;
|
|
12955
|
-
}
|
|
12827
|
+
uri?: string;
|
|
12956
12828
|
}
|
|
12957
12829
|
|
|
12958
12830
|
/** Standard web search for grounding and related configurations. Only text results are returned. */
|