feat: [Dataform] Update GCP Client Libraries in v1beta1 to support Folders, TeamFolders, and other relevant APIs (#8913)

* feat: Update GCP Client Libraries in v1beta1 to support Folders, TeamFolders, and other relevant APIs

The v1beta1 API now includes support for Folders and TeamFolders, allowing users to organize repositories and files hierarchically and manage access controls.

New Features:
- Added TeamFolder resource and methods:
CreateTeamFolder, GetTeamFolder, UpdateTeamFolder, DeleteTeamFolder
QueryTeamFolderContents to list folder contents.
SearchTeamFolders to search for TeamFolders.
- Added Folder resource and methods:
CreateFolder, GetFolder, UpdateFolder, DeleteFolder
QueryFolderContents to list folder contents.
Added MoveFolder to move Folders between TeamFolders, other Folders, or the user root folder.
- Added MoveRepository to move Repositories between TeamFolders, Folders, or the user root folder.
- Added QueryUserRootContents to list contents of a user's root folder.
Repository resource now includes containing_folder and team_folder_name fields to indicate its location within the folder hierarchy.
- IAM methods (GetIamPolicy, SetIamPolicy, TestIamPermissions) now support Folder and TeamFolder resources for access control management
docs: A comment for field `force` in message `.google.cloud.dataform.v1beta1.DeleteRepositoryRequest` is changed
PiperOrigin-RevId: 868182714

Source-Link: googleapis/googleapis@e1c1073

Source-Link: googleapis/googleapis-gen@fcbd8c7
Copy-Tag: eyJwIjoiRGF0YWZvcm0vLk93bEJvdC55YW1sIiwiaCI6ImZjYmQ4YzdlMmU4ODA2ZjM4YTQ0NDIwNWFiMGY5NDU4OGI5NDlkZjIifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

Dataform/metadata/V1Beta1/Dataform.php

@@ -0,0 +1,78 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START dataform_v1beta1_generated_Dataform_CancelOperation_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Dataform\V1beta1\Client\DataformClient;
+use Google\LongRunning\CancelOperationRequest;
+
+/**
+ * Starts asynchronous cancellation on a long-running operation.  The server
+ * makes a best effort to cancel the operation, but success is not
+ * guaranteed.  If the server doesn't support this method, it returns
+ * `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+ * [Operations.GetOperation][google.longrunning.Operations.GetOperation] or
+ * other methods to check whether the cancellation succeeded or whether the
+ * operation completed despite cancellation. On successful cancellation,
+ * the operation is not deleted; instead, it becomes an operation with
+ * an [Operation.error][google.longrunning.Operation.error] value with a
+ * [google.rpc.Status.code][google.rpc.Status.code] of `1`, corresponding to
+ * `Code.CANCELLED`.
+ *
+ * @param string $name The name of the operation resource to be cancelled.
+ */
+function cancel_operation_sample(string $name): void
+{
+    // Create a client.
+    $dataformClient = new DataformClient();
+
+    // Prepare the request message.
+    $request = (new CancelOperationRequest())
+        ->setName($name);
+
+    // Call the API and handle any network failures.
+    try {
+        $dataformClient->cancelOperation($request);
+        printf('Call completed successfully.' . PHP_EOL);
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $name = '[NAME]';
+
+    cancel_operation_sample($name);
+}
+// [END dataform_v1beta1_generated_Dataform_CancelOperation_sync]

Dataform/samples/V1beta1/DataformClient/cancel_operation.php

@@ -0,0 +1,77 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START dataform_v1beta1_generated_Dataform_CreateFolder_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Dataform\V1beta1\Client\DataformClient;
+use Google\Cloud\Dataform\V1beta1\CreateFolderRequest;
+use Google\Cloud\Dataform\V1beta1\Folder;
+
+/**
+ * Creates a new Folder in a given project and location.
+ *
+ * @param string $formattedParent   The location in which to create the Folder. Must be in the format
+ *                                  `projects/&#42;/locations/*`. Please see
+ *                                  {@see DataformClient::locationName()} for help formatting this field.
+ * @param string $folderDisplayName The Folder's user-friendly name.
+ */
+function create_folder_sample(string $formattedParent, string $folderDisplayName): void
+{
+    // Create a client.
+    $dataformClient = new DataformClient();
+
+    // Prepare the request message.
+    $folder = (new Folder())
+        ->setDisplayName($folderDisplayName);
+    $request = (new CreateFolderRequest())
+        ->setParent($formattedParent)
+        ->setFolder($folder);
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var Folder $response */
+        $response = $dataformClient->createFolder($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedParent = DataformClient::locationName('[PROJECT]', '[LOCATION]');
+    $folderDisplayName = '[DISPLAY_NAME]';
+
+    create_folder_sample($formattedParent, $folderDisplayName);
+}
+// [END dataform_v1beta1_generated_Dataform_CreateFolder_sync]

Dataform/samples/V1beta1/DataformClient/create_folder.php

@@ -0,0 +1,77 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START dataform_v1beta1_generated_Dataform_CreateTeamFolder_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Dataform\V1beta1\Client\DataformClient;
+use Google\Cloud\Dataform\V1beta1\CreateTeamFolderRequest;
+use Google\Cloud\Dataform\V1beta1\TeamFolder;
+
+/**
+ * Creates a new TeamFolder in a given project and location.
+ *
+ * @param string $formattedParent       The location in which to create the TeamFolder. Must be in the
+ *                                      format `projects/&#42;/locations/*`. Please see
+ *                                      {@see DataformClient::locationName()} for help formatting this field.
+ * @param string $teamFolderDisplayName The TeamFolder's user-friendly name.
+ */
+function create_team_folder_sample(string $formattedParent, string $teamFolderDisplayName): void
+{
+    // Create a client.
+    $dataformClient = new DataformClient();
+
+    // Prepare the request message.
+    $teamFolder = (new TeamFolder())
+        ->setDisplayName($teamFolderDisplayName);
+    $request = (new CreateTeamFolderRequest())
+        ->setParent($formattedParent)
+        ->setTeamFolder($teamFolder);
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var TeamFolder $response */
+        $response = $dataformClient->createTeamFolder($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedParent = DataformClient::locationName('[PROJECT]', '[LOCATION]');
+    $teamFolderDisplayName = '[DISPLAY_NAME]';
+
+    create_team_folder_sample($formattedParent, $teamFolderDisplayName);
+}
+// [END dataform_v1beta1_generated_Dataform_CreateTeamFolder_sync]

Dataform/samples/V1beta1/DataformClient/create_team_folder.php

@@ -0,0 +1,69 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START dataform_v1beta1_generated_Dataform_DeleteFolder_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Dataform\V1beta1\Client\DataformClient;
+use Google\Cloud\Dataform\V1beta1\DeleteFolderRequest;
+
+/**
+ * Deletes a single Folder.
+ *
+ * @param string $formattedName The Folder's name. Please see
+ *                              {@see DataformClient::folderName()} for help formatting this field.
+ */
+function delete_folder_sample(string $formattedName): void
+{
+    // Create a client.
+    $dataformClient = new DataformClient();
+
+    // Prepare the request message.
+    $request = (new DeleteFolderRequest())
+        ->setName($formattedName);
+
+    // Call the API and handle any network failures.
+    try {
+        $dataformClient->deleteFolder($request);
+        printf('Call completed successfully.' . PHP_EOL);
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedName = DataformClient::folderName('[PROJECT]', '[LOCATION]', '[FOLDER]');
+
+    delete_folder_sample($formattedName);
+}
+// [END dataform_v1beta1_generated_Dataform_DeleteFolder_sync]

Dataform/samples/V1beta1/DataformClient/delete_folder.php

@@ -0,0 +1,71 @@
+<?php
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START dataform_v1beta1_generated_Dataform_DeleteOperation_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Dataform\V1beta1\Client\DataformClient;
+use Google\LongRunning\DeleteOperationRequest;
+
+/**
+ * Deletes a long-running operation. This method indicates that the client is
+ * no longer interested in the operation result. It does not cancel the
+ * operation. If the server doesn't support this method, it returns
+ * `google.rpc.Code.UNIMPLEMENTED`.
+ *
+ * @param string $name The name of the operation resource to be deleted.
+ */
+function delete_operation_sample(string $name): void
+{
+    // Create a client.
+    $dataformClient = new DataformClient();
+
+    // Prepare the request message.
+    $request = (new DeleteOperationRequest())
+        ->setName($name);
+
+    // Call the API and handle any network failures.
+    try {
+        $dataformClient->deleteOperation($request);
+        printf('Call completed successfully.' . PHP_EOL);
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $name = '[NAME]';
+
+    delete_operation_sample($name);
+}
+// [END dataform_v1beta1_generated_Dataform_DeleteOperation_sync]