Merge branch 'main' into fix-dashboard-parallelism

Author: diegomarquezp

.github/workflows/codegen.yaml

@@ -10,7 +10,7 @@ jobs:
     # As of November 2023, it returns 269 service names.
     uses: googleapis/discovery-artifact-manager/.github/workflows/list-services.yml@master
   total_service_size_check:
-    runs-on: ubuntu-20.04
+    runs-on: 'ubuntu-24.04'
     needs: discovery
     steps:
       - uses: actions/github-script@v5
@@ -24,7 +24,7 @@ jobs:
               throw new Error(`Total services (${services.length}) exceed limit of ${MAX_SERVICE_SIZE}`)
             }
   batch:
-    runs-on: ubuntu-20.04
+    runs-on: 'ubuntu-24.04'
     needs: discovery
     outputs:
       # As of November 2023, the output of batch job is a 3-element array, which contains a chunk of 100 service names

.github/workflows/generate.yaml

@@ -15,7 +15,7 @@ on:
 name: generate
 jobs:
   generate_one:
-    runs-on: ubuntu-20.04
+    runs-on: 'ubuntu-24.04'
     strategy:
       fail-fast: false
       max-parallel: 4

.github/workflows/requirements.in

@@ -2,3 +2,4 @@ absl-py==2.1.0
 gitdb==4.0.11
 GitPython==3.1.43
 smmap==5.0.1
+lxml==5.3.1

.github/workflows/requirements.txt

@@ -1,26 +0,0 @@
-#
-# This file is autogenerated by pip-compile with Python 3.11
-# by the following command:
-#
-#    pip-compile --generate-hashes
-#
-absl-py==2.1.0 \
-    --hash=sha256:526a04eadab8b4ee719ce68f204172ead1027549089702d99b9059f129ff1308 \
-    --hash=sha256:7820790efbb316739cde8b4e19357243fc3608a152024288513dd968d7d959ff
-    # via -r requirements.in
-gitdb==4.0.11 \
-    --hash=sha256:81a3407ddd2ee8df444cbacea00e2d038e40150acfa3001696fe0dcf1d3adfa4 \
-    --hash=sha256:bf5421126136d6d0af55bc1e7c1af1c397a34f5b7bd79e776cd3e89785c2b04b
-    # via
-    #   -r requirements.in
-    #   gitpython
-gitpython==3.1.43 \
-    --hash=sha256:35f314a9f878467f5453cc1fee295c3e18e52f1b99f10f6cf5b1682e968a9e7c \
-    --hash=sha256:eec7ec56b92aad751f9912a73404bc02ba212a23adb2c7098ee668417051a1ff
-    # via -r requirements.in
-smmap==5.0.1 \
-    --hash=sha256:dceeb6c0028fdb6734471eb07c0cd2aae706ccaecab45965ee83f11c8d3b1f62 \
-    --hash=sha256:e6d8668fa5f93e706934a62d7b4db19c8d9eb8cf2adbb75ef1b675aa332b69da
-    # via
-    #   -r requirements.in
-    #   gitdb

.github/workflows/update-root-readme.py

@@ -24,13 +24,15 @@
 import json
 from git import Repo
 import shutil
+from lxml import etree
 
 
 # global vars
 VERSION_REGEX = r"([^\.]*)\.(.+)\.json$"
 SCRIPT_DIR = Path(path.dirname(path.realpath(__file__)))
 REPO_DIR = Path(str(SCRIPT_DIR / '..' / '..'))
 DISCOVERY_REPO_PATH = Path(path.abspath(path.join(getcwd(), './discovery-artifact-manager')))
+LATEST_VERSION = '2.0.0'
 _discovery_repo = None
 
 
@@ -134,6 +136,31 @@ def all_services():
 
     return services
 
+def maven_metadata(pom_file: str):
+    if not path.isfile(pom_file):
+        print(f'skipping {pom_file} because it doesn\'t exist')
+        return None
+    tree = etree.parse(pom_file)
+    root = tree.getroot()
+    version = root.find("{http://maven.apache.org/POM/4.0.0}version").text
+    group_id = root.find("{http://maven.apache.org/POM/4.0.0}groupId").text
+    artifact_id = root.find("{http://maven.apache.org/POM/4.0.0}artifactId").text
+    return {"groupId": group_id, "artifactId": artifact_id, "version": version}
+
+def write_metadata_file(name: str, version: str, metadata: dict):
+    metadata_file = path.join(REPO_DIR, "clients", name, f'{version}.metadata.json')
+    print(f"Writing json metadata to {metadata_file}")
+    metadata = {"maven": metadata}
+    with open(metadata_file, "w+") as outfile:
+        json.dump(metadata, outfile, indent=2)
+
+def generate_metadata_file(service: list[Service]):
+    library_name = f'google-api-services-{service.id}'
+    metadata = maven_metadata(
+        path.join(REPO_DIR, "clients", library_name, service.version, LATEST_VERSION, "pom.xml")
+    )
+    if metadata is not None:
+        write_metadata_file(library_name, service.version, metadata)
 
 def main(argv: List[str]) -> None:
     if len(argv) > 1:
@@ -142,6 +169,8 @@ def main(argv: List[str]) -> None:
     clone_discovery_repo()
     services = all_services()
     generate_service_list(services)
+    for service in services:
+        generate_metadata_file(service)
     remove_discovery_repo()
 
 

.github/workflows/update-root-readme.yaml

@@ -7,7 +7,7 @@ on:
 name: update root README.md
 jobs:
   update:
-    runs-on: ubuntu-20.04
+    runs-on: 'ubuntu-24.04'
     steps:
       - uses: actions/checkout@v2
         with:

.github/workflows/verify.yaml

@@ -10,7 +10,7 @@ on:
 name: Verify libraries compilation
 jobs:
   verify:
-    runs-on: ubuntu-24.04
+    runs-on: 'ubuntu-24.04'
     strategy:
       matrix:
         variant: [ 1.26.0, 1.27.0, 1.28.0, 1.29.2, 1.30.1, 1.31.0, 2.0.0 ]

clients/google-api-services-abusiveexperiencereport/v1.metadata.json

@@ -2,6 +2,6 @@
   "maven": {
     "groupId": "com.google.apis",
     "artifactId": "google-api-services-abusiveexperiencereport",
-    "version": "v1-rev20200803-1.32.1"
+    "version": "v1-rev20200803-2.0.0"
   }
 }

clients/google-api-services-acceleratedmobilepageurl/v1.metadata.json

@@ -2,6 +2,6 @@
   "maven": {
     "groupId": "com.google.apis",
     "artifactId": "google-api-services-acceleratedmobilepageurl",
-    "version": "v1-rev20200916-1.32.1"
+    "version": "v1-rev20230701-2.0.0"
   }
 }

clients/google-api-services-accessapproval/v1.metadata.json

@@ -2,6 +2,6 @@
   "maven": {
     "groupId": "com.google.apis",
     "artifactId": "google-api-services-accessapproval",
-    "version": "v1-rev20211130-1.32.1"
+    "version": "v1-rev20250206-2.0.0"
   }
 }

clients/google-api-services-accesscontextmanager/v1.metadata.json

@@ -2,6 +2,6 @@
   "maven": {
     "groupId": "com.google.apis",
     "artifactId": "google-api-services-accesscontextmanager",
-    "version": "v1-rev20211203-1.32.1"
+    "version": "v1-rev20250212-2.0.0"
   }
 }

clients/google-api-services-accesscontextmanager/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-accesscontextmanager</artifactId>
-      <version>v1-rev20250212-2.0.0</version>
+      <version>v1-rev20250312-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-accesscontextmanager:v1-rev20250212-2.0.0'
+  implementation 'com.google.apis:google-api-services-accesscontextmanager:v1-rev20250312-2.0.0'
 }
 ```
 

clients/google-api-services-accesscontextmanager/v1/2.0.0/com/google/api/services/accesscontextmanager/v1/model/EgressTo.java

@@ -70,6 +70,14 @@ public final class EgressTo extends com.google.api.client.json.GenericJson {
   @com.google.api.client.util.Key
   private java.util.List<java.lang.String> resources;
 
+  /**
+   * IAM roles that represent the set of operations that the sources specified in the corresponding
+   * EgressFrom. are allowed to perform in this ServicePerimeter.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.util.List<java.lang.String> roles;
+
   /**
    * A list of external resources that are allowed to be accessed. Only AWS and Azure resources are
    * supported. For Amazon S3, the supported formats are s3://BUCKET_NAME, s3a://BUCKET_NAME, and
@@ -137,6 +145,25 @@ public EgressTo setResources(java.util.List<java.lang.String> resources) {
     return this;
   }
 
+  /**
+   * IAM roles that represent the set of operations that the sources specified in the corresponding
+   * EgressFrom. are allowed to perform in this ServicePerimeter.
+   * @return value or {@code null} for none
+   */
+  public java.util.List<java.lang.String> getRoles() {
+    return roles;
+  }
+
+  /**
+   * IAM roles that represent the set of operations that the sources specified in the corresponding
+   * EgressFrom. are allowed to perform in this ServicePerimeter.
+   * @param roles roles or {@code null} for none
+   */
+  public EgressTo setRoles(java.util.List<java.lang.String> roles) {
+    this.roles = roles;
+    return this;
+  }
+
   @Override
   public EgressTo set(String fieldName, Object value) {
     return (EgressTo) super.set(fieldName, value);

clients/google-api-services-accesscontextmanager/v1/2.0.0/com/google/api/services/accesscontextmanager/v1/model/IngressTo.java

@@ -57,6 +57,14 @@ public final class IngressTo extends com.google.api.client.json.GenericJson {
   @com.google.api.client.util.Key
   private java.util.List<java.lang.String> resources;
 
+  /**
+   * IAM roles that represent the set of operations that the sources specified in the corresponding
+   * IngressFrom are allowed to perform in this ServicePerimeter.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.util.List<java.lang.String> roles;
+
   /**
    * A list of ApiOperations allowed to be performed by the sources specified in corresponding
    * IngressFrom in this ServicePerimeter.
@@ -99,6 +107,25 @@ public IngressTo setResources(java.util.List<java.lang.String> resources) {
     return this;
   }
 
+  /**
+   * IAM roles that represent the set of operations that the sources specified in the corresponding
+   * IngressFrom are allowed to perform in this ServicePerimeter.
+   * @return value or {@code null} for none
+   */
+  public java.util.List<java.lang.String> getRoles() {
+    return roles;
+  }
+
+  /**
+   * IAM roles that represent the set of operations that the sources specified in the corresponding
+   * IngressFrom are allowed to perform in this ServicePerimeter.
+   * @param roles roles or {@code null} for none
+   */
+  public IngressTo setRoles(java.util.List<java.lang.String> roles) {
+    this.roles = roles;
+    return this;
+  }
+
   @Override
   public IngressTo set(String fieldName, Object value) {
     return (IngressTo) super.set(fieldName, value);

clients/google-api-services-accesscontextmanager/v1/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-accesscontextmanager</artifactId>
-  <version>v1-rev20250212-2.0.0</version>
-  <name>Access Context Manager API v1-rev20250212-2.0.0</name>
+  <version>v1-rev20250312-2.0.0</version>
+  <name>Access Context Manager API v1-rev20250312-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-accesscontextmanager/v1/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-accesscontextmanager</artifactId>
-      <version>v1-rev20250212-2.0.0</version>
+      <version>v1-rev20250312-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-accesscontextmanager:v1-rev20250212-2.0.0'
+  implementation 'com.google.apis:google-api-services-accesscontextmanager:v1-rev20250312-2.0.0'
 }
 ```
 

clients/google-api-services-addressvalidation/v1.metadata.json

@@ -0,0 +1,7 @@
+{
+  "maven": {
+    "groupId": "com.google.apis",
+    "artifactId": "google-api-services-addressvalidation",
+    "version": "v1-rev20241120-2.0.0"
+  }
+}

clients/google-api-services-addressvalidation/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-addressvalidation</artifactId>
-      <version>v1-rev20241120-2.0.0</version>
+      <version>v1-rev20250323-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-addressvalidation:v1-rev20241120-2.0.0'
+  implementation 'com.google.apis:google-api-services-addressvalidation:v1-rev20250323-2.0.0'
 }
 ```
 

clients/google-api-services-addressvalidation/v1/2.0.0/com/google/api/services/addressvalidation/v1/model/GoogleMapsAddressvalidationV1Address.java

@@ -55,11 +55,15 @@ public final class GoogleMapsAddressvalidationV1Address extends com.google.api.c
 
   /**
    * The types of components that were expected to be present in a correctly formatted mailing
-   * address but were not found in the input AND could not be inferred. Components of this type are
-   * not present in `formatted_address`, `postal_address`, or `address_components`. An example might
-   * be `['street_number', 'route']` for an input like "Boulder, Colorado, 80301, USA". The list of
+   * address but were not found in the input AND could not be inferred. An example might be
+   * `['street_number', 'route']` for an input like "Boulder, Colorado, 80301, USA". The list of
    * possible types can be found
    * [here](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
+   * **Note: you might see a missing component type when you think you've already supplied the
+   * missing component.** For example, this can happen when the input address contains the building
+   * name, but not the premise number. In the address "渋谷区渋谷３丁目　Shibuya Stream", the building name
+   * "Shibuya Stream" has the component type `premise`, but the premise number is missing, so
+   * `missing_component_types` will contain `premise`.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -146,11 +150,15 @@ public GoogleMapsAddressvalidationV1Address setFormattedAddress(java.lang.String
 
   /**
    * The types of components that were expected to be present in a correctly formatted mailing
-   * address but were not found in the input AND could not be inferred. Components of this type are
-   * not present in `formatted_address`, `postal_address`, or `address_components`. An example might
-   * be `['street_number', 'route']` for an input like "Boulder, Colorado, 80301, USA". The list of
+   * address but were not found in the input AND could not be inferred. An example might be
+   * `['street_number', 'route']` for an input like "Boulder, Colorado, 80301, USA". The list of
    * possible types can be found
    * [here](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
+   * **Note: you might see a missing component type when you think you've already supplied the
+   * missing component.** For example, this can happen when the input address contains the building
+   * name, but not the premise number. In the address "渋谷区渋谷３丁目　Shibuya Stream", the building name
+   * "Shibuya Stream" has the component type `premise`, but the premise number is missing, so
+   * `missing_component_types` will contain `premise`.
    * @return value or {@code null} for none
    */
   public java.util.List<java.lang.String> getMissingComponentTypes() {
@@ -159,11 +167,15 @@ public java.util.List<java.lang.String> getMissingComponentTypes() {
 
   /**
    * The types of components that were expected to be present in a correctly formatted mailing
-   * address but were not found in the input AND could not be inferred. Components of this type are
-   * not present in `formatted_address`, `postal_address`, or `address_components`. An example might
-   * be `['street_number', 'route']` for an input like "Boulder, Colorado, 80301, USA". The list of
+   * address but were not found in the input AND could not be inferred. An example might be
+   * `['street_number', 'route']` for an input like "Boulder, Colorado, 80301, USA". The list of
    * possible types can be found
    * [here](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
+   * **Note: you might see a missing component type when you think you've already supplied the
+   * missing component.** For example, this can happen when the input address contains the building
+   * name, but not the premise number. In the address "渋谷区渋谷３丁目　Shibuya Stream", the building name
+   * "Shibuya Stream" has the component type `premise`, but the premise number is missing, so
+   * `missing_component_types` will contain `premise`.
    * @param missingComponentTypes missingComponentTypes or {@code null} for none
    */
   public GoogleMapsAddressvalidationV1Address setMissingComponentTypes(java.util.List<java.lang.String> missingComponentTypes) {