feat: [Dataform] Support adding a workflow action to execute a Data Preparation node

Dataform/samples/V1beta1/DataformClient/list_repositories.php

@@ -32,6 +32,9 @@
 /**
  * Lists Repositories in a given project and location.
  *
+ * **Note:** *This method can return repositories not shown in the [Dataform
+ * UI](https://console.cloud.google.com/bigquery/dataform)*.
+ *
  * @param string $formattedParent The location in which to list repositories. Must be in the format
  *                                `projects/*/locations/*`. Please see
  *                                {@see DataformClient::locationName()} for help formatting this field.

Dataform/samples/V1beta1/DataformClient/update_config.php

@@ -31,11 +31,10 @@
 /**
  * Update default config for a given project and location.
  *
- * **Note:** This method does not fully implement
- * [AIP-134](https://google.aip.dev/134); in particular:
- * - The wildcard entry (**\***) is treated as a bad request
- * - When the **field_mask** is omitted, instead of only updating the set
- * fields, the request is treated as a full update on all modifiable fields
+ * **Note:** *This method does not fully implement
+ * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+ * as a bad request, and when the `field_mask` is omitted, the request is
+ * treated as a full update on all modifiable fields.*
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Dataform/samples/V1beta1/DataformClient/update_release_config.php

@@ -31,11 +31,10 @@
 /**
  * Updates a single ReleaseConfig.
  *
- * **Note:** This method does not fully implement
- * [AIP-134](https://google.aip.dev/134); in particular:
- * - The wildcard entry (**\***) is treated as a bad request
- * - When the **field_mask** is omitted, instead of only updating the set
- * fields, the request is treated as a full update on all modifiable fields
+ * **Note:** *This method does not fully implement
+ * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+ * as a bad request, and when the `field_mask` is omitted, the request is
+ * treated as a full update on all modifiable fields.*
  *
  * @param string $releaseConfigGitCommitish Git commit/tag/branch name at which the repository should be
  *                                          compiled. Must exist in the remote repository. Examples:

Dataform/samples/V1beta1/DataformClient/update_repository.php

@@ -31,11 +31,10 @@
 /**
  * Updates a single Repository.
  *
- * **Note:** This method does not fully implement
- * [AIP-134](https://google.aip.dev/134); in particular:
- * - The wildcard entry (**\***) is treated as a bad request
- * - When the **field_mask** is omitted, instead of only updating the set
- * fields, the request is treated as a full update on all modifiable fields
+ * **Note:** *This method does not fully implement
+ * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+ * as a bad request, and when the `field_mask` is omitted, the request is
+ * treated as a full update on all modifiable fields.*
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

Dataform/samples/V1beta1/DataformClient/update_workflow_config.php

@@ -31,11 +31,10 @@
 /**
  * Updates a single WorkflowConfig.
  *
- * **Note:** This method does not fully implement
- * [AIP-134](https://google.aip.dev/134); in particular:
- * - The wildcard entry (**\***) is treated as a bad request
- * - When the **field_mask** is omitted, instead of only updating the set
- * fields, the request is treated as a full update on all modifiable fields
+ * **Note:** *This method does not fully implement
+ * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+ * as a bad request, and when the `field_mask` is omitted, the request is
+ * treated as a full update on all modifiable fields.*
  *
  * @param string $formattedWorkflowConfigReleaseConfig The name of the release config whose release_compilation_result
  *                                                     should be executed. Must be in the format

Dataform/src/V1beta1/Client/DataformClient.php

@@ -368,6 +368,30 @@ public static function locationName(string $project, string $location): string
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * notebook_runtime_template resource.
+     *
+     * @param string $project
+     * @param string $location
+     * @param string $notebookRuntimeTemplate
+     *
+     * @return string The formatted notebook_runtime_template resource.
+     *
+     * @experimental
+     */
+    public static function notebookRuntimeTemplateName(
+        string $project,
+        string $location,
+        string $notebookRuntimeTemplate
+    ): string {
+        return self::getPathTemplate('notebookRuntimeTemplate')->render([
+            'project' => $project,
+            'location' => $location,
+            'notebook_runtime_template' => $notebookRuntimeTemplate,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a
      * release_config resource.
@@ -527,6 +551,7 @@ public static function workspaceName(
      * - cryptoKey: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}
      * - cryptoKeyVersion: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}
      * - location: projects/{project}/locations/{location}
+     * - notebookRuntimeTemplate: projects/{project}/locations/{location}/notebookRuntimeTemplates/{notebook_runtime_template}
      * - releaseConfig: projects/{project}/locations/{location}/repositories/{repository}/releaseConfigs/{release_config}
      * - repository: projects/{project}/locations/{location}/repositories/{repository}
      * - secretVersion: projects/{project}/secrets/{secret}/versions/{version}
@@ -1500,6 +1525,9 @@ public function listReleaseConfigs(ListReleaseConfigsRequest $request, array $ca
     /**
      * Lists Repositories in a given project and location.
      *
+     * **Note:** *This method can return repositories not shown in the [Dataform
+     * UI](https://console.cloud.google.com/bigquery/dataform)*.
+     *
      * The async variant is {@see DataformClient::listRepositoriesAsync()} .
      *
      * @example samples/V1beta1/DataformClient/list_repositories.php
@@ -2052,11 +2080,10 @@ public function searchFiles(SearchFilesRequest $request, array $callOptions = []
     /**
      * Update default config for a given project and location.
      *
-     * **Note:** This method does not fully implement
-     * [AIP-134](https://google.aip.dev/134); in particular:
-     * - The wildcard entry (**\***) is treated as a bad request
-     * - When the **field_mask** is omitted, instead of only updating the set
-     * fields, the request is treated as a full update on all modifiable fields
+     * **Note:** *This method does not fully implement
+     * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+     * as a bad request, and when the `field_mask` is omitted, the request is
+     * treated as a full update on all modifiable fields.*
      *
      * The async variant is {@see DataformClient::updateConfigAsync()} .
      *
@@ -2086,11 +2113,10 @@ public function updateConfig(UpdateConfigRequest $request, array $callOptions =
     /**
      * Updates a single ReleaseConfig.
      *
-     * **Note:** This method does not fully implement
-     * [AIP-134](https://google.aip.dev/134); in particular:
-     * - The wildcard entry (**\***) is treated as a bad request
-     * - When the **field_mask** is omitted, instead of only updating the set
-     * fields, the request is treated as a full update on all modifiable fields
+     * **Note:** *This method does not fully implement
+     * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+     * as a bad request, and when the `field_mask` is omitted, the request is
+     * treated as a full update on all modifiable fields.*
      *
      * The async variant is {@see DataformClient::updateReleaseConfigAsync()} .
      *
@@ -2120,11 +2146,10 @@ public function updateReleaseConfig(UpdateReleaseConfigRequest $request, array $
     /**
      * Updates a single Repository.
      *
-     * **Note:** This method does not fully implement
-     * [AIP-134](https://google.aip.dev/134); in particular:
-     * - The wildcard entry (**\***) is treated as a bad request
-     * - When the **field_mask** is omitted, instead of only updating the set
-     * fields, the request is treated as a full update on all modifiable fields
+     * **Note:** *This method does not fully implement
+     * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+     * as a bad request, and when the `field_mask` is omitted, the request is
+     * treated as a full update on all modifiable fields.*
      *
      * The async variant is {@see DataformClient::updateRepositoryAsync()} .
      *
@@ -2154,11 +2179,10 @@ public function updateRepository(UpdateRepositoryRequest $request, array $callOp
     /**
      * Updates a single WorkflowConfig.
      *
-     * **Note:** This method does not fully implement
-     * [AIP-134](https://google.aip.dev/134); in particular:
-     * - The wildcard entry (**\***) is treated as a bad request
-     * - When the **field_mask** is omitted, instead of only updating the set
-     * fields, the request is treated as a full update on all modifiable fields
+     * **Note:** *This method does not fully implement
+     * [AIP/134](https://google.aip.dev/134). The wildcard entry (\*) is treated
+     * as a bad request, and when the `field_mask` is omitted, the request is
+     * treated as a full update on all modifiable fields.*
      *
      * The async variant is {@see DataformClient::updateWorkflowConfigAsync()} .
      *