google-apis-billingbudgets_v1 0.7.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a92ba50f50b2b51991447825eef007f178726d665597a25d663c74034a9efc70
-  data.tar.gz: c80d3dc628b3117f9ef63adc4fa974650230d30ebc3460774bd229f644b0b7b6
+  metadata.gz: 822ea03ca5b99d42c52aefe2bb10f68a295de63e1cac50e492dc2268fe9cfc13
+  data.tar.gz: 5ea0263c1237464244cbff3e86bb2570f1af827b00d958ada638e3d73d2b22f1
 SHA512:
-  metadata.gz: 26374bfe6749025991423044239271c671748e0703bf1d76a9c61eeb495d008ceb7476114b3e6d0066856ba1d8da5b829538aee7850c57ab68cc8ba7981d6b81
-  data.tar.gz: e52bbfb9c640aa0871d34a653fa5eba5d66929fce549a42dbfdf73fc0f280b08241cda55beb0ee03e8cd38da531eb31cf7d4a5197fc5438a6dcad2c13bec8516
+  metadata.gz: bfc05afaa25c2dd2e0d1b296c0090e3b2c0d8bea4e300e789a4ed98ca35a99b0759108f7ffcbd0b8469d635e8970755e94acedad3eafb3ff39d33f6c7f9d7d3d
+  data.tar.gz: 639db8331ac2673c9ba1882d07a0ac636050fccf42453b0f215d0101b5c0f8b9f618c512fc59327e8d511e44d8d781a67aa950b0581bbba9a79872e2f3256f99

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Release history for google-apis-billingbudgets_v1
 
+### v0.11.0 (2021-10-20)
+
+* Unspecified changes
+
+### v0.10.0 (2021-09-01)
+
+* Regenerated from discovery document revision 20210813
+
+### v0.9.0 (2021-06-29)
+
+* Regenerated using generator version 0.4.0
+
+### v0.8.0 (2021-06-24)
+
+* Regenerated from discovery document revision 20210621
+* Regenerated using generator version 0.3.0
+
 ### v0.7.0 (2021-05-19)
 
 * Unspecified changes

data/OVERVIEW.md

@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Billingbudgets service in particular.)
 

data/lib/google/apis/billingbudgets_v1/classes.rb

@@ -47,7 +47,7 @@ module Google
         attr_accessor :display_name
       
         # 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.
+        # write operation. An empty etag causes an update to overwrite other changes.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -66,7 +66,8 @@ module Google
         attr_accessor :notifications_rule
       
         # Optional. Rules that trigger alerts (notifications of thresholds being crossed)
-        # when spend exceeds the specified percentages of the budget.
+        # when spend exceeds the specified percentages of the budget. Optional for `
+        # pubsubTopic` notifications. Required if using email notifications.
         # Corresponds to the JSON property `thresholdRules`
         # @return [Array<Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1ThresholdRule>]
         attr_accessor :threshold_rules
@@ -93,10 +94,8 @@ module Google
       
         # Describes a budget amount targeted to the last Filter.calendar_period spend.
         # At this time, the amount is automatically 100% of the last calendar period's
-        # spend; that is, there are no other options yet. Future configuration options
-        # will be described here (for example, configuring a percentage of last period's
-        # spend). LastPeriodAmount cannot be set for a budget configured with a Filter.
-        # custom_period.
+        # spend; that is, there are no other options yet. LastPeriodAmount cannot be set
+        # for a budget configured with a Filter.custom_period.
         # Corresponds to the JSON property `lastPeriodAmount`
         # @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1LastPeriodAmount]
         attr_accessor :last_period_amount
@@ -161,10 +160,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Specifies to track usage for recurring calendar period. For example,
-        # assume that CalendarPeriod.QUARTER is set. The budget will track usage from
-        # April 1 to June 30, when the current calendar month is April, May, June. After
-        # that, it will track usage from July 1 to September 30 when the current
-        # calendar month is July, August, September, so on.
+        # assume that CalendarPeriod.QUARTER is set. The budget tracks usage from April
+        # 1 to June 30, when the current calendar month is April, May, June. After that,
+        # it tracks usage from July 1 to September 30 when the current calendar month is
+        # July, August, September, so on.
         # Corresponds to the JSON property `calendarPeriod`
         # @return [String]
         attr_accessor :calendar_period
@@ -190,27 +189,28 @@ module Google
         attr_accessor :custom_period
       
         # Optional. A single label and value pair specifying that usage from only this
-        # set of labeled resources should be included in the budget. Currently, multiple
-        # entries or multiple values per entry are not allowed. If omitted, the report
-        # will include all labeled and unlabeled usage.
+        # set of labeled resources should be included in the budget. If omitted, the
+        # report includes all labeled and unlabeled usage. An object containing a single
+        # `"key": value` pair. Example: `` "name": "wrench" ``. _Currently, multiple
+        # entries or multiple values per entry are not allowed._
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,Array<Object>>]
         attr_accessor :labels
       
         # Optional. A set of projects of the form `projects/`project``, specifying that
         # usage from only this set of projects should be included in the budget. If
-        # omitted, the report will include all usage for the billing account, regardless
-        # of which project the usage occurred on. Only zero or one project can be
-        # specified currently.
+        # omitted, the report includes all usage for the billing account, regardless of
+        # which project the usage occurred on. Only zero or one project can be specified
+        # currently.
         # Corresponds to the JSON property `projects`
         # @return [Array<String>]
         attr_accessor :projects
       
         # Optional. A set of services of the form `services/`service_id``, specifying
         # that usage from only this set of services should be included in the budget. If
-        # omitted, the report will include usage for all the services. The service names
-        # are available through the Catalog API: https://cloud.google.com/billing/v1/how-
-        # tos/catalog-api.
+        # omitted, the report includes usage for all the services. The service names are
+        # available through the Catalog API: https://cloud.google.com/billing/v1/how-tos/
+        # catalog-api.
         # Corresponds to the JSON property `services`
         # @return [Array<String>]
         attr_accessor :services
@@ -218,8 +218,8 @@ module Google
         # Optional. A set of subaccounts of the form `billingAccounts/`account_id``,
         # specifying that usage from only this set of subaccounts should be included in
         # the budget. If a subaccount is set to the name of the parent account, usage
-        # from the parent account will be included. If the field is omitted, the report
-        # will include usage from the parent account and all subaccounts, if they exist.
+        # from the parent account is included. If the field is omitted, the report
+        # includes usage from the parent account and all subaccounts, if they exist.
         # Corresponds to the JSON property `subaccounts`
         # @return [Array<String>]
         attr_accessor :subaccounts
@@ -243,10 +243,8 @@ module Google
       
       # Describes a budget amount targeted to the last Filter.calendar_period spend.
       # At this time, the amount is automatically 100% of the last calendar period's
-      # spend; that is, there are no other options yet. Future configuration options
-      # will be described here (for example, configuring a percentage of last period's
-      # spend). LastPeriodAmount cannot be set for a budget configured with a Filter.
-      # custom_period.
+      # spend; that is, there are no other options yet. LastPeriodAmount cannot be set
+      # for a budget configured with a Filter.custom_period.
       class GoogleCloudBillingBudgetsV1LastPeriodAmount
         include Google::Apis::Core::Hashable
       
@@ -299,25 +297,46 @@ module Google
         attr_accessor :disable_default_iam_recipients
         alias_method :disable_default_iam_recipients?, :disable_default_iam_recipients
       
-        # Optional. Targets to send notifications to when a threshold is exceeded. This
-        # is in addition to default recipients who have billing account IAM roles. The
-        # value is the full REST resource name of a monitoring notification channel with
-        # the form `projects/`project_id`/notificationChannels/`channel_id``. A maximum
-        # of 5 channels are allowed. See https://cloud.google.com/billing/docs/how-to/
-        # budgets-notification-recipients for more details.
+        # Optional. Email targets to send notifications to when a threshold is exceeded.
+        # This is in addition to the `DefaultIamRecipients` who receive alert emails
+        # based on their billing account IAM role. The value is the full REST resource
+        # name of a Cloud Monitoring email notification channel with the form `projects/`
+        # project_id`/notificationChannels/`channel_id``. A maximum of 5 email
+        # notifications are allowed. To customize budget alert email recipients with
+        # monitoring notification channels, you _must create the monitoring notification
+        # channels before you link them to a budget_. For guidance on setting up
+        # notification channels to use with budgets, see [Customize budget alert email
+        # recipients](https://cloud.google.com/billing/docs/how-to/budgets-notification-
+        # recipients). For Cloud Billing budget alerts, you _must use email notification
+        # channels_. The other types of notification channels are _not_ supported, such
+        # as Slack, SMS, or PagerDuty. If you want to [send budget notifications to
+        # Slack](https://cloud.google.com/billing/docs/how-to/notify#
+        # send_notifications_to_slack), use a pubsubTopic and configure [programmatic
+        # notifications](https://cloud.google.com/billing/docs/how-to/budgets-
+        # programmatic-notifications).
         # Corresponds to the JSON property `monitoringNotificationChannels`
         # @return [Array<String>]
         attr_accessor :monitoring_notification_channels
       
-        # Optional. The name of the Pub/Sub topic where budget related messages will be
+        # Optional. The name of the Pub/Sub topic where budget-related messages are
         # published, in the form `projects/`project_id`/topics/`topic_id``. Updates are
-        # sent at regular intervals to the topic. The topic needs to be created before
-        # the budget is created; see https://cloud.google.com/billing/docs/how-to/
-        # budgets#manage-notifications for more details. Caller is expected to have `
-        # pubsub.topics.setIamPolicy` permission on the topic when it's set for a budget,
-        # otherwise, the API call will fail with PERMISSION_DENIED. See https://cloud.
-        # google.com/billing/docs/how-to/budgets-programmatic-notifications for more
-        # details on Pub/Sub roles and permissions.
+        # sent to the topic at regular intervals; the timing of the updates is not
+        # dependent on the [threshold rules](#thresholdrule) you've set. Note that if
+        # you want your [Pub/Sub JSON object](https://cloud.google.com/billing/docs/how-
+        # to/budgets-programmatic-notifications#notification_format) to contain data for
+        # `alertThresholdExceeded`, you need at least one [alert threshold rule](#
+        # thresholdrule). When you set threshold rules, you must also enable at least
+        # one of the email notification options, either using the default IAM recipients
+        # or Cloud Monitoring email notification channels. To use Pub/Sub topics with
+        # budgets, you must do the following: 1. Create the Pub/Sub topic before
+        # connecting it to your budget. For guidance, see [Manage programmatic budget
+        # alert notifications](https://cloud.google.com/billing/docs/how-to/budgets-
+        # programmatic-notifications). 2. Grant the API caller the `pubsub.topics.
+        # setIamPolicy` permission on the Pub/Sub topic. If not set, the API call fails
+        # with PERMISSION_DENIED. For additional details on Pub/Sub roles and
+        # permissions, see [Permissions required for this task](https://cloud.google.com/
+        # billing/docs/how-to/budgets-programmatic-notifications#
+        # permissions_required_for_this_task).
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
         attr_accessor :pubsub_topic
@@ -343,12 +362,19 @@ module Google
         end
       end
       
-      # ThresholdRule contains a definition of a threshold which triggers an alert (a
-      # notification of a threshold being crossed) to be sent when spend goes above
-      # the specified amount. Alerts are automatically e-mailed to users with the
-      # Billing Account Administrator role or the Billing Account User role. The
-      # thresholds here have no effect on notifications sent to anything configured
-      # under `Budget.all_updates_rule`.
+      # ThresholdRule contains the definition of a threshold. Threshold rules define
+      # the triggering events used to generate a budget notification email. When a
+      # threshold is crossed (spend exceeds the specified percentages of the budget),
+      # budget alert emails are sent to the email recipients you specify in the [
+      # NotificationsRule](#notificationsrule). Threshold rules also affect the fields
+      # included in the [JSON data object](https://cloud.google.com/billing/docs/how-
+      # to/budgets-programmatic-notifications#notification_format) sent to a Pub/Sub
+      # topic. Threshold rules are _required_ if using email notifications. Threshold
+      # rules are _optional_ if only setting a [`pubsubTopic` NotificationsRule](#
+      # NotificationsRule), unless you want your JSON data object to include data
+      # about the thresholds you set. For more information, see [set budget threshold
+      # rules and actions](https://cloud.google.com/billing/docs/how-to/budgets#budget-
+      # actions).
       class GoogleCloudBillingBudgetsV1ThresholdRule
         include Google::Apis::Core::Hashable
       

data/lib/google/apis/billingbudgets_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module BillingbudgetsV1
       # Version of the google-apis-billingbudgets_v1 gem
-      GEM_VERSION = "0.7.0"
+      GEM_VERSION = "0.11.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.2.0"
+      GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210412"
+      REVISION = "20210813"
     end
   end
 end

data/lib/google/apis/billingbudgets_v1.rb

@@ -33,7 +33,7 @@ module Google
       # View and manage your Google Cloud Platform billing accounts
       AUTH_CLOUD_BILLING = 'https://www.googleapis.com/auth/cloud-billing'
 
-      # See, edit, configure, and delete your Google Cloud Platform data
+      # See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-billingbudgets_v1
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-24 00:00:00.000000000 Z
+date: 2021-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 2.a
 description: This is the simple REST client for Cloud Billing Budget API V1. Simple
   REST clients are Ruby client libraries that provide access to Google services via
   their HTTP REST API endpoints. These libraries are generated and updated automatically
@@ -51,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-billingbudgets_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-billingbudgets_v1/v0.7.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-billingbudgets_v1
+  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-billingbudgets_v1/CHANGELOG.md
+  documentation_uri: https://googleapis.dev/ruby/google-apis-billingbudgets_v1/v0.11.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-billingbudgets_v1
 post_install_message: 
 rdoc_options: []
 require_paths: