@maxim_mazurok/gapi.client.cloudtasks-v2beta3 0.0.20221208 → 0.0.20230201

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://cloudtasks.googleapis.com/$discovery/rest?version=v2beta3
-// Revision: 20221208
+// Revision: 20230201
 
 /// <reference types="gapi.client" />
 
@@ -117,19 +117,27 @@ declare namespace gapi.client {
              * Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example,
              * `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service
              * account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. *
-             * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
-             * identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to
-             * `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing
-             * a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value
-             * reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
-             * identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to
-             * `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For
-             * example, `google.com` or `example.com`.
+             * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the
+             * users of that domain. For example, `google.com` or `example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has
+             * been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains
+             * the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently
+             * deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and
+             * the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that
+             * has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group
+             * retains the role in the binding.
              */
             members?: string[];
             /** Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. */
             role?: string;
         }
+        interface BufferTaskRequest {
+            /** Optional. Body of the HTTP request. The body can take any generic value. The value is written to the HttpRequest of the [Task]. */
+            body?: HttpBody;
+        }
+        interface BufferTaskResponse {
+            /** The created task. */
+            task?: Task;
+        }
         interface CreateTaskRequest {
             /**
              * The response_view specifies which subset of the Task will be returned. By default response_view is BASIC; not all information is retrieved by default because some data, such as
@@ -177,16 +185,35 @@ declare namespace gapi.client {
              */
             requestedPolicyVersion?: number;
         }
+        interface Header {
+            /** The Key of the header. */
+            key?: string;
+            /** The Value of the header. */
+            value?: string;
+        }
+        interface HeaderOverride {
+            /** header embodying a key and a value. */
+            header?: Header;
+        }
+        interface HttpBody {
+            /** The HTTP Content-Type header value specifying the content type of the body. */
+            contentType?: string;
+            /** The HTTP request/response body as raw binary. */
+            data?: string;
+            /** Application specific response metadata. Must be set in the first response for streaming APIs. */
+            extensions?: Array<{ [P in string]: any }>;
+        }
         interface HttpRequest {
             /** HTTP request body. A request body is allowed only if the HTTP method is POST, PUT, or PATCH. It is an error to set body on a task with an incompatible HttpMethod. */
             body?: string;
             /**
              * HTTP request headers. This map contains the header field names and values. Headers can be set when the task is created. These headers represent a subset of the headers that will
-             * accompany the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Host: This will be
-             * computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. *
-             * `X-Google-*`: Google use only. * `X-AppEngine-*`: Google use only. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is
-             * created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. Headers which can have multiple values (according to RFC2616) can be
-             * specified using comma-separated values. The size of the headers must be less than 80KB.
+             * accompany the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Any header that is
+             * prefixed with "X-CloudTasks-" will be treated as service header. Service headers define properties of the task and are predefined in CloudTask. * Host: This will be computed by
+             * Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. * `X-Google-*`:
+             * Google use only. * `X-AppEngine-*`: Google use only. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For
+             * example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. Headers which can have multiple values (according to RFC2616) can be specified using
+             * comma-separated values. The size of the headers must be less than 80KB.
              */
             headers?: { [P in string]: string };
             /** The HTTP method to use for the request. The default is POST. */
@@ -208,6 +235,25 @@ declare namespace gapi.client {
              */
             url?: string;
         }
+        interface HttpTarget {
+            /**
+             * HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the
+             * headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: *
+             * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from
+             * HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the
+             * task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This
+             * will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be
+             * less than 80KB. Queue-level headers to override headers of all the tasks in the queue.
+             */
+            headerOverrides?: HeaderOverride[];
+            /**
+             * The HTTP method to use for the request. When specified, it will override HttpRequest for the task. Note that if the value is set to HttpMethod the HttpRequest of the task will be
+             * ignored at execution time.
+             */
+            httpMethod?: string;
+            /** URI override. When specified, modifies the execution URI for all the tasks in the queue. */
+            uriOverride?: UriOverride;
+        }
         interface ListLocationsResponse {
             /** A list of locations that matches the specified filter in the request. */
             locations?: Location[];
@@ -262,6 +308,10 @@ declare namespace gapi.client {
              */
             serviceAccountEmail?: string;
         }
+        interface PathOverride {
+            /** The URI path (e.g., a/b/c). Default is Empty string. */
+            path?: string;
+        }
         // tslint:disable-next-line:no-empty-interface
         interface PauseQueueRequest {
         }
@@ -304,9 +354,15 @@ declare namespace gapi.client {
         // tslint:disable-next-line:no-empty-interface
         interface PurgeQueueRequest {
         }
+        interface QueryOverride {
+            /** The query parameters (e.g., qparam1=123&qparam2=456). Default is Empty string. */
+            queryParams?: string;
+        }
         interface Queue {
             /** AppEngineHttpQueue settings apply only to App Engine tasks in this queue. Http tasks are not affected by this proto. */
             appEngineHttpQueue?: AppEngineHttpQueue;
+            /** Modifies HTTP target for HTTP tasks. */
+            httpTarget?: HttpTarget;
             /**
              * Caller-specified and required in CreateQueue, after which it becomes output only. The queue name. The queue name must have the following format:
              * `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more
@@ -538,7 +594,92 @@ declare namespace gapi.client {
             /** A subset of `TestPermissionsRequest.permissions` that the caller is allowed. */
             permissions?: string[];
         }
+        interface UriOverride {
+            /**
+             * Host override. When specified, will replace the host part of the task URL. For example, if the task URL is "https://www.google.com", and host value is set to "example.net", the
+             * overridden URI will be changed to "https://example.net". Host value cannot be an empty string.
+             */
+            host?: string;
+            /** URI path. When specified, will replace the existing path of the task URL. Setting the path value to an empty string clears the URI path segment. */
+            pathOverride?: PathOverride;
+            /**
+             * Port override. When specified, will replace the port part of the task URI. For instance, for a URI http://www.google.com/foo and port=123, the overridden URI becomes
+             * http://www.google.com:123/foo. Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.
+             */
+            port?: string;
+            /** URI Query. When specified, will replace the query part of the task URI. Setting the query value to an empty string clears the URI query segment. */
+            queryOverride?: QueryOverride;
+            /** Scheme override. When specified, the task URI scheme is replaced by the provided value (HTTP or HTTPS). */
+            scheme?: string;
+            /** URI Override Enforce Mode When specified, determines the Target UriOverride mode. If not specified, it defaults to ALWAYS. */
+            uriOverrideEnforceMode?: string;
+        }
         interface TasksResource {
+            /**
+             * Creates and buffers a new task without the need to explicitly define a Task message. The queue must have HTTP target. To create the task with a custom ID, use the following format
+             * and set TASK_ID to your desired ID: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID:buffer To create the task with an automatically generated ID, use the
+             * following format: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks:buffer. Note: This feature is in its experimental stage. You must request access to the API through
+             * the [Cloud Tasks BufferTask Experiment Signup form](https://forms.gle/X8Zr5hiXH5tTGFqh8).
+             */
+            buffer(request: {
+                /** V1 error format. */
+                "$.xgafv"?: string;
+                /** OAuth access token. */
+                access_token?: string;
+                /** Data format for response. */
+                alt?: string;
+                /** JSONP */
+                callback?: string;
+                /** Selector specifying which fields to include in a partial response. */
+                fields?: string;
+                /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+                key?: string;
+                /** OAuth 2.0 token for the current user. */
+                oauth_token?: string;
+                /** Returns response with indentations and line breaks. */
+                prettyPrint?: boolean;
+                /** Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist. */
+                queue: string;
+                /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+                quotaUser?: string;
+                /** Optional. Task ID for the task being created. If not provided, a random task ID is assigned to the task. */
+                taskId: string;
+                /** Upload protocol for media (e.g. "raw", "multipart"). */
+                upload_protocol?: string;
+                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+                uploadType?: string;
+                /** Request body */
+                resource: BufferTaskRequest;
+            }): Request<BufferTaskResponse>;
+            buffer(request: {
+                /** V1 error format. */
+                "$.xgafv"?: string;
+                /** OAuth access token. */
+                access_token?: string;
+                /** Data format for response. */
+                alt?: string;
+                /** JSONP */
+                callback?: string;
+                /** Selector specifying which fields to include in a partial response. */
+                fields?: string;
+                /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+                key?: string;
+                /** OAuth 2.0 token for the current user. */
+                oauth_token?: string;
+                /** Returns response with indentations and line breaks. */
+                prettyPrint?: boolean;
+                /** Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist. */
+                queue: string;
+                /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+                quotaUser?: string;
+                /** Optional. Task ID for the task being created. If not provided, a random task ID is assigned to the task. */
+                taskId: string;
+                /** Upload protocol for media (e.g. "raw", "multipart"). */
+                upload_protocol?: string;
+                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+                uploadType?: string;
+            },
+            body: BufferTaskRequest): Request<BufferTaskResponse>;
             /** Creates a task and adds it to a queue. Tasks cannot be updated after creation; there is no UpdateTask command. * The maximum task size is 100KB. */
             create(request: {
                 /** V1 error format. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.cloudtasks-v2beta3",
-  "version": "0.0.20221208",
+  "version": "0.0.20230201",
   "description": "TypeScript typings for Cloud Tasks API v2beta3",
   "license": "MIT",
   "author": {

package/tests.ts

@@ -3,7 +3,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 
-// Revision: 20221208
+// Revision: 20230201
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -56,6 +56,29 @@ gapi.load('client', async () => {
                     version: "Test string",
                 },
             },
+            httpTarget: {
+                headerOverrides: [
+                    {
+                        header: {
+                            key: "Test string",
+                            value: "Test string",
+                        },
+                    }
+                ],
+                httpMethod: "Test string",
+                uriOverride: {
+                    host: "Test string",
+                    pathOverride: {
+                        path: "Test string",
+                    },
+                    port: "Test string",
+                    queryOverride: {
+                        queryParams: "Test string",
+                    },
+                    scheme: "Test string",
+                    uriOverrideEnforceMode: "Test string",
+                },
+            },
             name: "Test string",
             purgeTime: "Test string",
             rateLimits: {
@@ -135,6 +158,29 @@ gapi.load('client', async () => {
                     version: "Test string",
                 },
             },
+            httpTarget: {
+                headerOverrides: [
+                    {
+                        header: {
+                            key: "Test string",
+                            value: "Test string",
+                        },
+                    }
+                ],
+                httpMethod: "Test string",
+                uriOverride: {
+                    host: "Test string",
+                    pathOverride: {
+                        path: "Test string",
+                    },
+                    port: "Test string",
+                    queryOverride: {
+                        queryParams: "Test string",
+                    },
+                    scheme: "Test string",
+                    uriOverrideEnforceMode: "Test string",
+                },
+            },
             name: "Test string",
             purgeTime: "Test string",
             rateLimits: {
@@ -226,6 +272,26 @@ gapi.load('client', async () => {
                 "Test string"
             ],
         });
+        /**
+         * Creates and buffers a new task without the need to explicitly define a Task message. The queue must have HTTP target. To create the task with a custom ID, use the following format and
+         * set TASK_ID to your desired ID: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID:buffer To create the task with an automatically generated ID, use the following
+         * format: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks:buffer. Note: This feature is in its experimental stage. You must request access to the API through the [Cloud
+         * Tasks BufferTask Experiment Signup form](https://forms.gle/X8Zr5hiXH5tTGFqh8).
+         */
+        await gapi.client.cloudtasks.projects.locations.queues.tasks.buffer({
+            queue: "Test string",
+            taskId: "Test string",
+        }, {
+            body: {
+                contentType: "Test string",
+                data: "Test string",
+                extensions: [
+                    {
+                        A: 42
+                    }
+                ],
+            },
+        });
         /** Creates a task and adds it to a queue. Tasks cannot be updated after creation; there is no UpdateTask command. * The maximum task size is 100KB. */
         await gapi.client.cloudtasks.projects.locations.queues.tasks.create({
             parent: "Test string",