docs: Reworded comments for the new credit types filter (#311)

PiperOrigin-RevId: 340738401 Source-Author: Google APIs <noreply@google.com> Source-Date: Wed Nov 4 15:25:35 2020 -0800 Source-Repo: googleapis/googleapis Source-Sha: 1f22d1e9654a2588aa32f3802156d965d8d1f10f Source-Link: googleapis/googleapis@1f22d1e
googleapis · Nov 5, 2020 · 76298fe · 76298fe
1 parent 12335fe
commit 76298fe
Show file tree

Hide file tree

Showing 4 changed files with 185 additions and 130 deletions.
diff --git a/...gle-cloud-billingbudgets-v1/src/main/java/com/google/cloud/billing/budgets/v1/Filter.java b/...gle-cloud-billingbudgets-v1/src/main/java/com/google/cloud/billing/budgets/v1/Filter.java
@@ -466,13 +466,16 @@ public com.google.protobuf.ByteString getProjectsBytes(int index) {
    *
    *
    * <pre>
-   * Optional. A list of credit types to be subtracted from gross cost to
-   * determine the spend for threshold calculations if and only if
-   * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-   * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-   * empty. See credits.type on
-   * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-   * for a list of acceptable credit type values in this field.
+   * Optional. If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+   * subtracted from gross cost to determine the spend for threshold
+   * calculations.
+   * If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+   * of acceptable credit type
+   * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
    * </pre>
    *
    * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -486,13 +489,16 @@ public com.google.protobuf.ProtocolStringList getCreditTypesList() {
    *
    *
    * <pre>
-   * Optional. A list of credit types to be subtracted from gross cost to
-   * determine the spend for threshold calculations if and only if
-   * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-   * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-   * empty. See credits.type on
-   * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-   * for a list of acceptable credit type values in this field.
+   * Optional. If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+   * subtracted from gross cost to determine the spend for threshold
+   * calculations.
+   * If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+   * of acceptable credit type
+   * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
    * </pre>
    *
    * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -506,13 +512,16 @@ public int getCreditTypesCount() {
    *
    *
    * <pre>
-   * Optional. A list of credit types to be subtracted from gross cost to
-   * determine the spend for threshold calculations if and only if
-   * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-   * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-   * empty. See credits.type on
-   * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-   * for a list of acceptable credit type values in this field.
+   * Optional. If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+   * subtracted from gross cost to determine the spend for threshold
+   * calculations.
+   * If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+   * of acceptable credit type
+   * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
    * </pre>
    *
    * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -527,13 +536,16 @@ public java.lang.String getCreditTypes(int index) {
    *
    *
    * <pre>
-   * Optional. A list of credit types to be subtracted from gross cost to
-   * determine the spend for threshold calculations if and only if
-   * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-   * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-   * empty. See credits.type on
-   * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-   * for a list of acceptable credit type values in this field.
+   * Optional. If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+   * subtracted from gross cost to determine the spend for threshold
+   * calculations.
+   * If
+   * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+   * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+   * of acceptable credit type
+   * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
    * </pre>
    *
    * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1588,13 +1600,16 @@ private void ensureCreditTypesIsMutable() {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1608,13 +1623,16 @@ public com.google.protobuf.ProtocolStringList getCreditTypesList() {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1628,13 +1646,16 @@ public int getCreditTypesCount() {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1649,13 +1670,16 @@ public java.lang.String getCreditTypes(int index) {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1670,13 +1694,16 @@ public com.google.protobuf.ByteString getCreditTypesBytes(int index) {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1698,13 +1725,16 @@ public Builder setCreditTypes(int index, java.lang.String value) {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1725,13 +1755,16 @@ public Builder addCreditTypes(java.lang.String value) {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1749,13 +1782,16 @@ public Builder addAllCreditTypes(java.lang.Iterable<java.lang.String> values) {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -1772,13 +1808,16 @@ public Builder clearCreditTypes() {
      *
      *
      * <pre>
-     * Optional. A list of credit types to be subtracted from gross cost to
-     * determine the spend for threshold calculations if and only if
-     * credit_types_treatment is INCLUDE_SPECIFIED_CREDITS. If
-     * credit_types_treatment is not INCLUDE_SPECIFIED_CREDITS, this field must be
-     * empty. See credits.type on
-     * https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#data-schema
-     * for a list of acceptable credit type values in this field.
+     * Optional. If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
+     * subtracted from gross cost to determine the spend for threshold
+     * calculations.
+     * If
+     * [Filter.credit_types_treatment][google.cloud.billing.budgets.v1.Filter.credit_types_treatment]
+     * is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty. See [a list
+     * of acceptable credit type
+     * values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
      * </pre>
      *
      * <code>repeated string credit_types = 7 [(.google.api.field_behavior) = OPTIONAL];</code>