feat(dataflow): update the API

#### dataflow:v1b3

The following keys were added:
- schemas.LeaseWorkItemRequest.properties.projectNumber.description
- schemas.LeaseWorkItemRequest.properties.projectNumber.format
- schemas.LeaseWorkItemRequest.properties.projectNumber.type
- schemas.ReportWorkItemStatusRequest.properties.projectNumber.description
- schemas.ReportWorkItemStatusRequest.properties.projectNumber.format
- schemas.ReportWorkItemStatusRequest.properties.projectNumber.type
- schemas.StreamingConfigTask.properties.userWorkerRunnerV1Settings.description
- schemas.StreamingConfigTask.properties.userWorkerRunnerV1Settings.format
- schemas.StreamingConfigTask.properties.userWorkerRunnerV1Settings.type
- schemas.StreamingConfigTask.properties.userWorkerRunnerV2Settings.description
- schemas.StreamingConfigTask.properties.userWorkerRunnerV2Settings.format
- schemas.StreamingConfigTask.properties.userWorkerRunnerV2Settings.type

The following keys were changed:
- endpoints
- resources.projects.resources.locations.resources.templates.methods.create.description
- resources.projects.resources.locations.resources.templates.methods.get.description
- resources.projects.resources.locations.resources.templates.methods.launch.description
- resources.projects.resources.templates.methods.create.description
- resources.projects.resources.templates.methods.get.description
- resources.projects.resources.templates.methods.launch.description

Author: yoshi-automation

discovery/dataflow-v1b3.json

@@ -84,6 +84,11 @@
       "endpointUrl": "https://dataflow.us-west2.rep.googleapis.com/",
       "location": "us-west2"
     },
+    {
+      "description": "Regional Endpoint",
+      "endpointUrl": "https://dataflow.us-west3.rep.googleapis.com/",
+      "location": "us-west3"
+    },
     {
       "description": "Regional Endpoint",
       "endpointUrl": "https://dataflow.us-west4.rep.googleapis.com/",
@@ -1852,7 +1857,7 @@
             "templates": {
               "methods": {
                 "create": {
-                  "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.",
+                  "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`.",
                   "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates",
                   "httpMethod": "POST",
                   "id": "dataflow.projects.locations.templates.create",
@@ -1887,7 +1892,7 @@
                   ]
                 },
                 "get": {
-                  "description": "Get the template associated with a template.",
+                  "description": "Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved.",
                   "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates:get",
                   "httpMethod": "GET",
                   "id": "dataflow.projects.locations.templates.get",
@@ -1935,7 +1940,7 @@
                   ]
                 },
                 "launch": {
-                  "description": "Launch a template.",
+                  "description": "Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`.",
                   "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates:launch",
                   "httpMethod": "POST",
                   "id": "dataflow.projects.locations.templates.launch",
@@ -2072,7 +2077,7 @@
         "templates": {
           "methods": {
             "create": {
-              "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.",
+              "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`.",
               "flatPath": "v1b3/projects/{projectId}/templates",
               "httpMethod": "POST",
               "id": "dataflow.projects.templates.create",
@@ -2100,7 +2105,7 @@
               ]
             },
             "get": {
-              "description": "Get the template associated with a template.",
+              "description": "Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved.",
               "flatPath": "v1b3/projects/{projectId}/templates:get",
               "httpMethod": "GET",
               "id": "dataflow.projects.templates.get",
@@ -2146,7 +2151,7 @@
               ]
             },
             "launch": {
-              "description": "Launch a template.",
+              "description": "Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`.",
               "flatPath": "v1b3/projects/{projectId}/templates:launch",
               "httpMethod": "POST",
               "id": "dataflow.projects.templates.launch",
@@ -2203,7 +2208,7 @@
       }
     }
   },
-  "revision": "20240709",
+  "revision": "20240817",
   "rootUrl": "https://dataflow.googleapis.com/",
   "schemas": {
     "ApproximateProgress": {
@@ -4413,6 +4418,11 @@
           "description": "The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the WorkItem's job.",
           "type": "string"
         },
+        "projectNumber": {
+          "description": "Optional. The project number of the project this worker belongs to.",
+          "format": "int64",
+          "type": "string"
+        },
         "requestedLeaseDuration": {
           "description": "The initial lease period.",
           "format": "google-duration",
@@ -5375,6 +5385,11 @@
           "description": "The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the WorkItem's job.",
           "type": "string"
         },
+        "projectNumber": {
+          "description": "Optional. The project number of the project which owns the WorkItem's job.",
+          "format": "int64",
+          "type": "string"
+        },
         "unifiedWorkerRequest": {
           "additionalProperties": {
             "description": "Properties of the object. Contains field @type with type URL.",
@@ -6746,6 +6761,16 @@
           "description": "Map from user step names to state families.",
           "type": "object"
         },
+        "userWorkerRunnerV1Settings": {
+          "description": "Binary encoded proto to control runtime behavior of the java runner v1 user worker.",
+          "format": "byte",
+          "type": "string"
+        },
+        "userWorkerRunnerV2Settings": {
+          "description": "Binary encoded proto to control runtime behavior of the runner v2 user worker.",
+          "format": "byte",
+          "type": "string"
+        },
         "windmillServiceEndpoint": {
           "description": "If present, the worker must use this endpoint to communicate with Windmill Service dispatchers, otherwise the worker must continue to use whatever endpoint it had been using.",
           "type": "string"

src/apis/dataflow/v1b3.ts

@@ -1655,6 +1655,10 @@ export namespace dataflow_v1b3 {
      * The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the WorkItem's job.
      */
     location?: string | null;
+    /**
+     * Optional. The project number of the project this worker belongs to.
+     */
+    projectNumber?: string | null;
     /**
      * The initial lease period.
      */
@@ -2345,6 +2349,10 @@ export namespace dataflow_v1b3 {
      * The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the WorkItem's job.
      */
     location?: string | null;
+    /**
+     * Optional. The project number of the project which owns the WorkItem's job.
+     */
+    projectNumber?: string | null;
     /**
      * Untranslated bag-of-bytes WorkProgressUpdateRequest from UnifiedWorker.
      */
@@ -3253,6 +3261,14 @@ export namespace dataflow_v1b3 {
      * Map from user step names to state families.
      */
     userStepToStateFamilyNameMap?: {[key: string]: string} | null;
+    /**
+     * Binary encoded proto to control runtime behavior of the java runner v1 user worker.
+     */
+    userWorkerRunnerV1Settings?: string | null;
+    /**
+     * Binary encoded proto to control runtime behavior of the runner v2 user worker.
+     */
+    userWorkerRunnerV2Settings?: string | null;
     /**
      * If present, the worker must use this endpoint to communicate with Windmill Service dispatchers, otherwise the worker must continue to use whatever endpoint it had been using.
      */
@@ -8034,7 +8050,7 @@ export namespace dataflow_v1b3 {
     }
 
     /**
-     * Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.
+     * Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8122,7 +8138,7 @@ export namespace dataflow_v1b3 {
     }
 
     /**
-     * Get the template associated with a template.
+     * Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8213,7 +8229,7 @@ export namespace dataflow_v1b3 {
     }
 
     /**
-     * Launch a template.
+     * Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8599,7 +8615,7 @@ export namespace dataflow_v1b3 {
     }
 
     /**
-     * Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.
+     * Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8687,7 +8703,7 @@ export namespace dataflow_v1b3 {
     }
 
     /**
-     * Get the template associated with a template.
+     * Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8778,7 +8794,7 @@ export namespace dataflow_v1b3 {
     }
 
     /**
-     * Launch a template.
+     * Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.