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

PiperOrigin-RevId: 341478628 Source-Author: Google APIs <noreply@google.com> Source-Date: Mon Nov 9 13:52:56 2020 -0800 Source-Repo: googleapis/googleapis Source-Sha: 6c0f55f33f882cf97fd3135e93b144ad9c94ebab Source-Link: googleapis/googleapis@6c0f55f
googleapis · Nov 11, 2020 · eeef8a7 · eeef8a7
1 parent 85799ac
commit eeef8a7
Show file tree

Hide file tree

Showing 4 changed files with 185 additions and 130 deletions.
diff --git a/...billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Filter.java b/...billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Filter.java
@@ -450,13 +450,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 at
-   * 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.v1beta1.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.v1beta1.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>
@@ -470,13 +473,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 at
-   * 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.v1beta1.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.v1beta1.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>
@@ -490,13 +496,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 at
-   * 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.v1beta1.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.v1beta1.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>
@@ -511,13 +520,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 at
-   * 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.v1beta1.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.v1beta1.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>
@@ -1574,13 +1586,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1594,13 +1609,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1614,13 +1632,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1635,13 +1656,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1656,13 +1680,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1684,13 +1711,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1711,13 +1741,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1735,13 +1768,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 at
-     * 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.v1beta1.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.v1beta1.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>
@@ -1758,13 +1794,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 at
-     * 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.v1beta1.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.v1beta1.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>