google-apis-billingbudgets_v1 0.8.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27f6a7121ce8801cb1f94dffadeadfcc747c2cc68f1a6eef93928f10afa59c10
-  data.tar.gz: 7b55a4a6b1a4a312363b3573202c4f303a597bb48a977d1b222fe6ca9774a2e3
+  metadata.gz: d56fe84917e91d0aed6fea0372b84af7407a174a9fcbbb3de7623629fb522d4d
+  data.tar.gz: c49f73a92d54680f45450349e09510feec20b14c9943636fbe5a04fbd2ccffc5
 SHA512:
-  metadata.gz: 663ee8ed47a86d13f999c4a177cd3c6b64afb8fb58d9588e80087d92e6931c2fee90d6a89a4ce981761102ed74b8171b2e4f383892e72ff14e6d1ddc835dc1f1
-  data.tar.gz: d7f013ad0bdf58d6437baaa963dc6a4976e9a6c89e3877e2efa504742543eaac9bbc3a31d49b328444f31c5522f351a130e5b5d39f7c2addda96ee1cac605aab
+  metadata.gz: f39071462f66ac9869ed3b04215ca9423469a35947e63201d7e7673a3f0ecc31b206936a4f39448c4b67e0b862956f7ab6e5bc594983ce0551fae07b3d67b0fd
+  data.tar.gz: d03dc74bd44dc722de1fda5c272da53fd7d4629af60dc5954579b78e9d96c16d1e5f2c5aba1d8fc9e68ccd7e08e859a4c15d3a6bafbb149f67474f2a69a8b8ae

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release history for google-apis-billingbudgets_v1
 
+### v0.12.0 (2021-12-14)
+
+* Unspecified changes
+
+### 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

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/billingbudgets_v1"
 client = Google::Apis::BillingbudgetsV1::CloudBillingBudgetService.new
 
 # Authenticate calls
-client.authentication = # ... use the googleauth gem to create credentials
+client.authorization = # ... use the googleauth gem to create credentials
 ```
 
 See the class reference docs for information on the methods you can call from a client.
@@ -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
@@ -94,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
@@ -162,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
@@ -191,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
@@ -219,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
@@ -244,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
       
@@ -300,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

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.8.0"
+      GEM_VERSION = "0.12.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.3.0"
+      GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210621"
+      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,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-billingbudgets_v1
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-28 00:00:00.000000000 Z
+date: 2022-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -57,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.8.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.12.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:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.4
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Billing Budget API V1