feat: [Dataform] Add Developer Connect integration for Git repository authentication (#9303)

* feat: Add Developer Connect integration for Git repository authentication

feat: Add effective default branch field for repositories

docs: Clarify field usage guidelines and default values in API reference documentation
PiperOrigin-RevId: 939094745

Source-Link: googleapis/googleapis@1a9328c

Source-Link: googleapis/googleapis-gen@0211e8b
Copy-Tag: eyJwIjoiRGF0YWZvcm0vLk93bEJvdC55YW1sIiwiaCI6IjAyMTFlOGJlZjNhNGUyNGYzZjMxMTExN2RiMzgxNzUwNGY2ZmQ0NTkifQ==

* 🦉 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>
Co-authored-by: Brent Shaffer <betterbrent@google.com>

Author: gcf-owl-bot[bot]

Dataform/metadata/V1/Dataform.php

@@ -33,9 +33,8 @@
  * Lists information about the supported locations for this service.
  *
  * This method lists locations based on the resource scope provided in
- * the [ListLocationsRequest.name] field:
- *
- * * **Global locations**: If `name` is empty, the method lists the
+ * the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
+ * **Global locations**: If `name` is empty, the method lists the
  * public locations available to all projects. * **Project-specific
  * locations**: If `name` follows the format
  * `projects/{project}`, the method lists locations visible to that

Dataform/samples/V1/DataformClient/list_locations.php

@@ -32,7 +32,7 @@
 /**
  * Returns the contents of a given Folder.
  *
- * @param string $formattedFolder Name of the folder whose contents to list.
+ * @param string $formattedFolder Resource name of the Folder to list contents for.
  *                                Format: projects/*/locations/*/folders/*
  *                                Please see {@see DataformClient::folderName()} for help formatting this field.
  */

Dataform/samples/V1/DataformClient/query_folder_contents.php

@@ -32,7 +32,7 @@
 /**
  * Returns the contents of a given TeamFolder.
  *
- * @param string $formattedTeamFolder Name of the team_folder whose contents to list.
+ * @param string $formattedTeamFolder Resource name of the TeamFolder to list contents for.
  *                                    Format: `projects/*/locations/*/teamFolders/*`. Please see
  *                                    {@see DataformClient::teamFolderName()} for help formatting this field.
  */

Dataform/samples/V1/DataformClient/query_team_folder_contents.php

@@ -34,7 +34,7 @@
  * The root folder contains all resources that are created by the user and not
  * contained in any other folder.
  *
- * @param string $formattedLocation Location of the user root folder whose contents to list.
+ * @param string $formattedLocation Location of the user root folder to list contents for.
  *                                  Format: projects/*/locations/*
  *                                  Please see {@see DataformClient::locationName()} for help formatting this field.
  */

Dataform/samples/V1/DataformClient/query_user_root_contents.php

@@ -452,6 +452,31 @@ public static function folderName(string $project, string $location, string $fol
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * git_repository_link resource.
+     *
+     * @param string $project
+     * @param string $location
+     * @param string $connection
+     * @param string $gitRepositoryLink
+     *
+     * @return string The formatted git_repository_link resource.
+     */
+    public static function gitRepositoryLinkName(
+        string $project,
+        string $location,
+        string $connection,
+        string $gitRepositoryLink
+    ): string {
+        return self::getPathTemplate('gitRepositoryLink')->render([
+            'project' => $project,
+            'location' => $location,
+            'connection' => $connection,
+            'git_repository_link' => $gitRepositoryLink,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a location
      * resource.
@@ -657,6 +682,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}
      * - folder: projects/{project}/locations/{location}/folders/{folder}
+     * - gitRepositoryLink: projects/{project}/locations/{location}/connections/{connection}/gitRepositoryLinks/{git_repository_link}
      * - location: projects/{project}/locations/{location}
      * - notebookRuntimeTemplate: projects/{project}/locations/{location}/notebookRuntimeTemplates/{notebook_runtime_template}
      * - releaseConfig: projects/{project}/locations/{location}/repositories/{repository}/releaseConfigs/{release_config}
@@ -2899,9 +2925,8 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
      * Lists information about the supported locations for this service.
      *
      * This method lists locations based on the resource scope provided in
-     * the [ListLocationsRequest.name] field:
-     *
-     * * **Global locations**: If `name` is empty, the method lists the
+     * the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
+     * **Global locations**: If `name` is empty, the method lists the
      * public locations available to all projects. * **Project-specific
      * locations**: If `name` follows the format
      * `projects/{project}`, the method lists locations visible to that