feat: [billingbudgets] Add resource_ancestors field to support filtering by folders & organizations (#9501)

* feat: Add resource_ancestors field to support filtering by folders & organizations

PiperOrigin-RevId: 537931957

Source-Link: googleapis/googleapis@521a7a6

Source-Link: https://github.com/googleapis/googleapis-gen/commit/afb9a0c029dd8047950189db30b2743af177e276
Copy-Tag: eyJwIjoiamF2YS1iaWxsaW5nYnVkZ2V0cy8uT3dsQm90LnlhbWwiLCJoIjoiYWZiOWEwYzAyOWRkODA0Nzk1MDE4OWRiMzBiMjc0M2FmMTc3ZTI3NiJ9

* 🦉 Updates from OwlBot post-processor

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

* feat: Add resource_ancestors field to support filtering by folders & organizations

PiperOrigin-RevId: 537933008

Source-Link: googleapis/googleapis@0429412

Source-Link: https://github.com/googleapis/googleapis-gen/commit/82dfed01a0f18b25ac061c56555a5a066c9d3db3
Copy-Tag: eyJwIjoiamF2YS1iaWxsaW5nYnVkZ2V0cy8uT3dsQm90LnlhbWwiLCJoIjoiODJkZmVkMDFhMGYxOGIyNWFjMDYxYzU2NTU1YTVhMDY2YzlkM2RiMyJ9

* 🦉 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]

java-billingbudgets/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.11.0</version>
+      <version>26.16.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-billingbudgets.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billingbudgets/2.14.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billingbudgets/2.18.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-billingbudgets/proto-google-cloud-billingbudgets-v1/src/main/java/com/google/cloud/billing/budgets/v1/Budget.java

@@ -54,11 +54,6 @@ protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
     return new Budget();
   }
 
-  @java.lang.Override
-  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
-    return this.unknownFields;
-  }
-
   public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
     return com.google.cloud.billing.budgets.v1.BudgetModelProto
         .internal_static_google_cloud_billing_budgets_v1_Budget_descriptor;
@@ -310,6 +305,10 @@ public com.google.cloud.billing.budgets.v1.BudgetAmountOrBuilder getAmountOrBuil
    * <pre>
    * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
+   *
+   * Optional for `pubsubTopic` notifications.
+   *
+   * Required if using email notifications.
    * </pre>
    *
    * <code>
@@ -326,6 +325,10 @@ public java.util.List<com.google.cloud.billing.budgets.v1.ThresholdRule> getThre
    * <pre>
    * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
+   *
+   * Optional for `pubsubTopic` notifications.
+   *
+   * Required if using email notifications.
    * </pre>
    *
    * <code>
@@ -343,6 +346,10 @@ public java.util.List<com.google.cloud.billing.budgets.v1.ThresholdRule> getThre
    * <pre>
    * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
+   *
+   * Optional for `pubsubTopic` notifications.
+   *
+   * Required if using email notifications.
    * </pre>
    *
    * <code>
@@ -359,6 +366,10 @@ public int getThresholdRulesCount() {
    * <pre>
    * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
+   *
+   * Optional for `pubsubTopic` notifications.
+   *
+   * Required if using email notifications.
    * </pre>
    *
    * <code>
@@ -375,6 +386,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRule getThresholdRules(int i
    * <pre>
    * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
+   *
+   * Optional for `pubsubTopic` notifications.
+   *
+   * Required if using email notifications.
    * </pre>
    *
    * <code>
@@ -457,7 +472,7 @@ public com.google.cloud.billing.budgets.v1.NotificationsRule getNotificationsRul
    * <pre>
    * Optional. Etag to validate that the object is unchanged for a
    * read-modify-write operation.
-   * An empty etag will cause an update to overwrite other changes.
+   * An empty etag causes an update to overwrite other changes.
    * </pre>
    *
    * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -482,7 +497,7 @@ public java.lang.String getEtag() {
    * <pre>
    * Optional. Etag to validate that the object is unchanged for a
    * read-modify-write operation.
-   * An empty etag will cause an update to overwrite other changes.
+   * An empty etag causes an update to overwrite other changes.
    * </pre>
    *
    * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1738,6 +1753,10 @@ private void ensureThresholdRulesIsMutable() {
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1758,6 +1777,10 @@ private void ensureThresholdRulesIsMutable() {
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1777,6 +1800,10 @@ public int getThresholdRulesCount() {
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1796,6 +1823,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRule getThresholdRules(int i
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1822,6 +1853,10 @@ public Builder setThresholdRules(
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1845,6 +1880,10 @@ public Builder setThresholdRules(
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1870,6 +1909,10 @@ public Builder addThresholdRules(com.google.cloud.billing.budgets.v1.ThresholdRu
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1896,6 +1939,10 @@ public Builder addThresholdRules(
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1919,6 +1966,10 @@ public Builder addThresholdRules(
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1942,6 +1993,10 @@ public Builder addThresholdRules(
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1965,6 +2020,10 @@ public Builder addAllThresholdRules(
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -1987,6 +2046,10 @@ public Builder clearThresholdRules() {
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2009,6 +2072,10 @@ public Builder removeThresholdRules(int index) {
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2025,6 +2092,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRule.Builder getThresholdRul
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2045,6 +2116,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRuleOrBuilder getThresholdRu
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2065,6 +2140,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRuleOrBuilder getThresholdRu
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2081,6 +2160,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRule.Builder addThresholdRul
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2099,6 +2182,10 @@ public com.google.cloud.billing.budgets.v1.ThresholdRule.Builder addThresholdRul
      * <pre>
      * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
+     *
+     * Optional for `pubsubTopic` notifications.
+     *
+     * Required if using email notifications.
      * </pre>
      *
      * <code>
@@ -2353,7 +2440,7 @@ public Builder clearNotificationsRule() {
      * <pre>
      * Optional. Etag to validate that the object is unchanged for a
      * read-modify-write operation.
-     * An empty etag will cause an update to overwrite other changes.
+     * An empty etag causes an update to overwrite other changes.
      * </pre>
      *
      * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -2377,7 +2464,7 @@ public java.lang.String getEtag() {
      * <pre>
      * Optional. Etag to validate that the object is unchanged for a
      * read-modify-write operation.
-     * An empty etag will cause an update to overwrite other changes.
+     * An empty etag causes an update to overwrite other changes.
      * </pre>
      *
      * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -2401,7 +2488,7 @@ public com.google.protobuf.ByteString getEtagBytes() {
      * <pre>
      * Optional. Etag to validate that the object is unchanged for a
      * read-modify-write operation.
-     * An empty etag will cause an update to overwrite other changes.
+     * An empty etag causes an update to overwrite other changes.
      * </pre>
      *
      * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -2424,7 +2511,7 @@ public Builder setEtag(java.lang.String value) {
      * <pre>
      * Optional. Etag to validate that the object is unchanged for a
      * read-modify-write operation.
-     * An empty etag will cause an update to overwrite other changes.
+     * An empty etag causes an update to overwrite other changes.
      * </pre>
      *
      * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -2443,7 +2530,7 @@ public Builder clearEtag() {
      * <pre>
      * Optional. Etag to validate that the object is unchanged for a
      * read-modify-write operation.
-     * An empty etag will cause an update to overwrite other changes.
+     * An empty etag causes an update to overwrite other changes.
      * </pre>
      *
      * <code>string etag = 7 [(.google.api.field_behavior) = OPTIONAL];</code>

java-billingbudgets/proto-google-cloud-billingbudgets-v1/src/main/java/com/google/cloud/billing/budgets/v1/BudgetAmount.java

@@ -45,11 +45,6 @@ protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
     return new BudgetAmount();
   }
 
-  @java.lang.Override
-  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
-    return this.unknownFields;
-  }
-
   public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
     return com.google.cloud.billing.budgets.v1.BudgetModelProto
         .internal_static_google_cloud_billing_budgets_v1_BudgetAmount_descriptor;
@@ -66,6 +61,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
   }
 
   private int budgetAmountCase_ = 0;
+
+  @SuppressWarnings("serial")
   private java.lang.Object budgetAmount_;
 
   public enum BudgetAmountCase

java-billingbudgets/proto-google-cloud-billingbudgets-v1/src/main/java/com/google/cloud/billing/budgets/v1/BudgetAmountOrBuilder.java

@@ -117,5 +117,5 @@ public interface BudgetAmountOrBuilder
    */
   com.google.cloud.billing.budgets.v1.LastPeriodAmountOrBuilder getLastPeriodAmountOrBuilder();
 
-  public com.google.cloud.billing.budgets.v1.BudgetAmount.BudgetAmountCase getBudgetAmountCase();
+  com.google.cloud.billing.budgets.v1.BudgetAmount.BudgetAmountCase getBudgetAmountCase();
 }