docs: [cloudbilling] update service documentation

java-billing/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.22.0</version>
+      <version>26.23.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-billing.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billing/2.23.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-billing/2.24.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-billing/google-cloud-billing/src/main/java/com/google/cloud/billing/v1/CloudBillingClient.java

@@ -582,8 +582,8 @@ public final BillingAccount updateBillingAccount(UpdateBillingAccountRequest req
    * <p>When creating a subaccount, the current authenticated user must have the
    * `billing.accounts.update` IAM permission on the parent account, which is typically given to
    * billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
-   * This method will return an error if the parent account has not been provisioned as a reseller
-   * account.
+   * This method will return an error if the parent account has not been provisioned for
+   * subaccounts.
    *
    * <p>Sample code:
    *
@@ -623,8 +623,8 @@ public final BillingAccount createBillingAccount(BillingAccount billingAccount)
    * <p>When creating a subaccount, the current authenticated user must have the
    * `billing.accounts.update` IAM permission on the parent account, which is typically given to
    * billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
-   * This method will return an error if the parent account has not been provisioned as a reseller
-   * account.
+   * This method will return an error if the parent account has not been provisioned for
+   * subaccounts.
    *
    * <p>Sample code:
    *
@@ -663,8 +663,8 @@ public final BillingAccount createBillingAccount(CreateBillingAccountRequest req
    * <p>When creating a subaccount, the current authenticated user must have the
    * `billing.accounts.update` IAM permission on the parent account, which is typically given to
    * billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
-   * This method will return an error if the parent account has not been provisioned as a reseller
-   * account.
+   * This method will return an error if the parent account has not been provisioned for
+   * subaccounts.
    *
    * <p>Sample code:
    *

java-billing/grpc-google-cloud-billing-v1/src/main/java/com/google/cloud/billing/v1/CloudBillingGrpc.java

@@ -613,7 +613,7 @@ default void updateBillingAccount(
      * typically given to billing account
      * [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
      * This method will return an error if the parent account has not been
-     * provisioned as a reseller account.
+     * provisioned for subaccounts.
      * </pre>
      */
     default void createBillingAccount(
@@ -864,7 +864,7 @@ public void updateBillingAccount(
      * typically given to billing account
      * [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
      * This method will return an error if the parent account has not been
-     * provisioned as a reseller account.
+     * provisioned for subaccounts.
      * </pre>
      */
     public void createBillingAccount(
@@ -1103,7 +1103,7 @@ public com.google.cloud.billing.v1.BillingAccount updateBillingAccount(
      * typically given to billing account
      * [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
      * This method will return an error if the parent account has not been
-     * provisioned as a reseller account.
+     * provisioned for subaccounts.
      * </pre>
      */
     public com.google.cloud.billing.v1.BillingAccount createBillingAccount(
@@ -1318,7 +1318,7 @@ protected CloudBillingFutureStub build(
      * typically given to billing account
      * [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
      * This method will return an error if the parent account has not been
-     * provisioned as a reseller account.
+     * provisioned for subaccounts.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<

java-billing/proto-google-cloud-billing-v1/src/main/java/com/google/cloud/billing/v1/ListBillingAccountsRequest.java

@@ -146,9 +146,9 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *
    * <pre>
    * Options for how to filter the returned billing accounts.
-   * Currently this only supports filtering for
+   * This only supports filtering for
    * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-   * single provided reseller billing account.
+   * single provided parent billing account.
    * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
    * Boolean algebra and other fields are not currently supported.
    * </pre>
@@ -174,9 +174,9 @@ public java.lang.String getFilter() {
    *
    * <pre>
    * Options for how to filter the returned billing accounts.
-   * Currently this only supports filtering for
+   * This only supports filtering for
    * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-   * single provided reseller billing account.
+   * single provided parent billing account.
    * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
    * Boolean algebra and other fields are not currently supported.
    * </pre>
@@ -765,9 +765,9 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *
      * <pre>
      * Options for how to filter the returned billing accounts.
-     * Currently this only supports filtering for
+     * This only supports filtering for
      * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-     * single provided reseller billing account.
+     * single provided parent billing account.
      * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
      * Boolean algebra and other fields are not currently supported.
      * </pre>
@@ -792,9 +792,9 @@ public java.lang.String getFilter() {
      *
      * <pre>
      * Options for how to filter the returned billing accounts.
-     * Currently this only supports filtering for
+     * This only supports filtering for
      * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-     * single provided reseller billing account.
+     * single provided parent billing account.
      * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
      * Boolean algebra and other fields are not currently supported.
      * </pre>
@@ -819,9 +819,9 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *
      * <pre>
      * Options for how to filter the returned billing accounts.
-     * Currently this only supports filtering for
+     * This only supports filtering for
      * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-     * single provided reseller billing account.
+     * single provided parent billing account.
      * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
      * Boolean algebra and other fields are not currently supported.
      * </pre>
@@ -845,9 +845,9 @@ public Builder setFilter(java.lang.String value) {
      *
      * <pre>
      * Options for how to filter the returned billing accounts.
-     * Currently this only supports filtering for
+     * This only supports filtering for
      * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-     * single provided reseller billing account.
+     * single provided parent billing account.
      * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
      * Boolean algebra and other fields are not currently supported.
      * </pre>
@@ -867,9 +867,9 @@ public Builder clearFilter() {
      *
      * <pre>
      * Options for how to filter the returned billing accounts.
-     * Currently this only supports filtering for
+     * This only supports filtering for
      * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-     * single provided reseller billing account.
+     * single provided parent billing account.
      * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
      * Boolean algebra and other fields are not currently supported.
      * </pre>

java-billing/proto-google-cloud-billing-v1/src/main/java/com/google/cloud/billing/v1/ListBillingAccountsRequestOrBuilder.java

@@ -71,9 +71,9 @@ public interface ListBillingAccountsRequestOrBuilder
    *
    * <pre>
    * Options for how to filter the returned billing accounts.
-   * Currently this only supports filtering for
+   * This only supports filtering for
    * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-   * single provided reseller billing account.
+   * single provided parent billing account.
    * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
    * Boolean algebra and other fields are not currently supported.
    * </pre>
@@ -88,9 +88,9 @@ public interface ListBillingAccountsRequestOrBuilder
    *
    * <pre>
    * Options for how to filter the returned billing accounts.
-   * Currently this only supports filtering for
+   * This only supports filtering for
    * [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-   * single provided reseller billing account.
+   * single provided parent billing account.
    * (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
    * Boolean algebra and other fields are not currently supported.
    * </pre>

java-billing/proto-google-cloud-billing-v1/src/main/proto/google/cloud/billing/v1/cloud_billing.proto

@@ -88,7 +88,7 @@ service CloudBilling {
   // typically given to billing account
   // [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
   // This method will return an error if the parent account has not been
-  // provisioned as a reseller account.
+  // provisioned for subaccounts.
   rpc CreateBillingAccount(CreateBillingAccountRequest)
       returns (BillingAccount) {
     option (google.api.http) = {
@@ -290,9 +290,9 @@ message ListBillingAccountsRequest {
   string page_token = 2;
 
   // Options for how to filter the returned billing accounts.
-  // Currently this only supports filtering for
+  // This only supports filtering for
   // [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-  // single provided reseller billing account.
+  // single provided parent billing account.
   // (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
   // Boolean algebra and other fields are not currently supported.
   string filter = 3;