google-api-client 0.9.pre3 → 0.9.pre4

data/generated/google/apis/cloudbilling_v1.rb

@@ -0,0 +1,35 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/cloudbilling_v1/service.rb'
+require 'google/apis/cloudbilling_v1/classes.rb'
+require 'google/apis/cloudbilling_v1/representations.rb'
+
+module Google
+  module Apis
+    # Google Cloud Billing API
+    #
+    # Retrieves Google Developers Console billing accounts and associates them with
+    # projects.
+    #
+    # @see https://cloud.google.com/billing/
+    module CloudbillingV1
+      VERSION = 'V1'
+      REVISION = '20150903'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+    end
+  end
+end

data/generated/google/apis/cloudbilling_v1/classes.rb

@@ -0,0 +1,169 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudbillingV1
+      
+      # A billing account in [Google Developers Console](https://console.developers.
+      # google.com/). You can assign a billing account to one or more projects.
+      class BillingAccount
+        include Google::Apis::Core::Hashable
+      
+        # The resource name of the billing account. The resource name has the form `
+        # billingAccounts/`billing_account_id``. For example, `billingAccounts/012345-
+        # 567890-ABCDEF` would be the resource name for billing account `012345-567890-
+        # ABCDEF`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # True if the billing account is open, and will therefore be charged for any
+        # usage on associated projects. False if the billing account is closed, and
+        # therefore projects associated with it will be unable to use paid services.
+        # Corresponds to the JSON property `open`
+        # @return [Boolean]
+        attr_accessor :open
+        alias_method :open?, :open
+      
+        # The display name given to the billing account, such as `My Billing Account`.
+        # This name is displayed in the Google Developers Console.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] unless args[:name].nil?
+          @open = args[:open] unless args[:open].nil?
+          @display_name = args[:display_name] unless args[:display_name].nil?
+        end
+      end
+      
+      # Response message for `ListBillingAccounts`.
+      class ListBillingAccountsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of billing accounts.
+        # Corresponds to the JSON property `billingAccounts`
+        # @return [Array<Google::Apis::CloudbillingV1::BillingAccount>]
+        attr_accessor :billing_accounts
+      
+        # A token to retrieve the next page of results. To retrieve the next page, call `
+        # ListBillingAccounts` again with the `page_token` field set to this value. This
+        # field is empty if there are no more results to retrieve.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @billing_accounts = args[:billing_accounts] unless args[:billing_accounts].nil?
+          @next_page_token = args[:next_page_token] unless args[:next_page_token].nil?
+        end
+      end
+      
+      # Request message for `ListProjectBillingInfoResponse`.
+      class ListProjectBillingInfoResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of `ProjectBillingInfo` resources representing the projects associated
+        # with the billing account.
+        # Corresponds to the JSON property `projectBillingInfo`
+        # @return [Array<Google::Apis::CloudbillingV1::ProjectBillingInfo>]
+        attr_accessor :project_billing_info
+      
+        # A token to retrieve the next page of results. To retrieve the next page, call `
+        # ListProjectBillingInfo` again with the `page_token` field set to this value.
+        # This field is empty if there are no more results to retrieve.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @project_billing_info = args[:project_billing_info] unless args[:project_billing_info].nil?
+          @next_page_token = args[:next_page_token] unless args[:next_page_token].nil?
+        end
+      end
+      
+      # Encapsulation of billing information for a Developers Console project. A
+      # project has at most one associated billing account at a time (but a billing
+      # account can be assigned to multiple projects).
+      class ProjectBillingInfo
+        include Google::Apis::Core::Hashable
+      
+        # The resource name for the `ProjectBillingInfo`; has the form `projects/`
+        # project_id`/billingInfo`. For example, the resource name for the billing
+        # information for project `tokyo-rain-123` would be `projects/tokyo-rain-123/
+        # billingInfo`. This field is read-only.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The ID of the project that this `ProjectBillingInfo` represents, such as `
+        # tokyo-rain-123`. This is a convenience field so that you don't need to parse
+        # the `name` field to obtain a project ID. This field is read-only.
+        # Corresponds to the JSON property `projectId`
+        # @return [String]
+        attr_accessor :project_id
+      
+        # The resource name of the billing account associated with the project, if any.
+        # For example, `billingAccounts/012345-567890-ABCDEF`.
+        # Corresponds to the JSON property `billingAccountName`
+        # @return [String]
+        attr_accessor :billing_account_name
+      
+        # True if the project is associated with an open billing account, to which usage
+        # on the project is charged. False if the project is associated with a closed
+        # billing account, or no billing account at all, and therefore cannot use paid
+        # services. This field is read-only.
+        # Corresponds to the JSON property `billingEnabled`
+        # @return [Boolean]
+        attr_accessor :billing_enabled
+        alias_method :billing_enabled?, :billing_enabled
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] unless args[:name].nil?
+          @project_id = args[:project_id] unless args[:project_id].nil?
+          @billing_account_name = args[:billing_account_name] unless args[:billing_account_name].nil?
+          @billing_enabled = args[:billing_enabled] unless args[:billing_enabled].nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/cloudbilling_v1/representations.rb

@@ -0,0 +1,79 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudbillingV1
+      
+      class BillingAccount
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListBillingAccountsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListProjectBillingInfoResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ProjectBillingInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class BillingAccount
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :open, as: 'open'
+          property :display_name, as: 'displayName'
+        end
+      end
+      
+      class ListBillingAccountsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :billing_accounts, as: 'billingAccounts', class: Google::Apis::CloudbillingV1::BillingAccount, decorator: Google::Apis::CloudbillingV1::BillingAccount::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class ListProjectBillingInfoResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :project_billing_info, as: 'projectBillingInfo', class: Google::Apis::CloudbillingV1::ProjectBillingInfo, decorator: Google::Apis::CloudbillingV1::ProjectBillingInfo::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class ProjectBillingInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :project_id, as: 'projectId'
+          property :billing_account_name, as: 'billingAccountName'
+          property :billing_enabled, as: 'billingEnabled'
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/cloudbilling_v1/service.rb

@@ -0,0 +1,258 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudbillingV1
+      # Google Cloud Billing API
+      #
+      # Retrieves Google Developers Console billing accounts and associates them with
+      #  projects.
+      #
+      # @example
+      #    require 'google/apis/cloudbilling_v1'
+      #
+      #    Cloudbilling = Google::Apis::CloudbillingV1 # Alias the module
+      #    service = Cloudbilling::CloudbillingService.new
+      #
+      # @see https://cloud.google.com/billing/
+      class CloudbillingService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://cloudbilling.googleapis.com/', '')
+        end
+        
+        # Gets information about a billing account. The current authenticated user must
+        # be an [owner of the billing account](https://support.google.com/cloud/answer/
+        # 4430947).
+        # @param [String] name
+        #   The resource name of the billing account to retrieve. For example, `
+        #   billingAccounts/012345-567890-ABCDEF`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_billing_account(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the billing accounts that the current authenticated user [owns](https://
+        # support.google.com/cloud/answer/4430947).
+        # @param [Fixnum] page_size
+        #   Requested page size. The maximum page size is 100; this is also the default.
+        # @param [String] page_token
+        #   A token identifying a page of results to return. This should be a `
+        #   next_page_token` value returned from a previous `ListBillingAccounts` call. If
+        #   unspecified, the first page of results is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::ListBillingAccountsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::ListBillingAccountsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_billing_accounts(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/billingAccounts', options)
+          command.response_representation = Google::Apis::CloudbillingV1::ListBillingAccountsResponse::Representation
+          command.response_class = Google::Apis::CloudbillingV1::ListBillingAccountsResponse
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the projects associated with a billing account. The current
+        # authenticated user must be an [owner of the billing account](https://support.
+        # google.com/cloud/answer/4430947).
+        # @param [String] name
+        #   The resource name of the billing account associated with the projects that you
+        #   want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
+        # @param [Fixnum] page_size
+        #   Requested page size. The maximum page size is 100; this is also the default.
+        # @param [String] page_token
+        #   A token identifying a page of results to be returned. This should be a `
+        #   next_page_token` value returned from a previous `ListProjectBillingInfo` call.
+        #   If unspecified, the first page of results is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::ListProjectBillingInfoResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::ListProjectBillingInfoResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_billing_account_projects(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}/projects', options)
+          command.response_representation = Google::Apis::CloudbillingV1::ListProjectBillingInfoResponse::Representation
+          command.response_class = Google::Apis::CloudbillingV1::ListProjectBillingInfoResponse
+          command.params['name'] = name unless name.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the billing information for a project. The current authenticated user
+        # must have [permission to view the project](https://cloud.google.com/docs/
+        # permissions-overview#h.bgs0oxofvnoo ).
+        # @param [String] name
+        #   The resource name of the project for which billing information is retrieved.
+        #   For example, `projects/tokyo-rain-123`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::ProjectBillingInfo] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::ProjectBillingInfo]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_billing_info(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}/billingInfo', options)
+          command.response_representation = Google::Apis::CloudbillingV1::ProjectBillingInfo::Representation
+          command.response_class = Google::Apis::CloudbillingV1::ProjectBillingInfo
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sets or updates the billing account associated with a project. You specify the
+        # new billing account by setting the `billing_account_name` in the `
+        # ProjectBillingInfo` resource to the resource name of a billing account.
+        # Associating a project with an open billing account enables billing on the
+        # project and allows charges for resource usage. If the project already had a
+        # billing account, this method changes the billing account used for resource
+        # usage charges. *Note:* Incurred charges that have not yet been reported in the
+        # transaction history of the Google Developers Console may be billed to the new
+        # billing account, even if the charge occurred before the new billing account
+        # was assigned to the project. The current authenticated user must have
+        # ownership privileges for both the [project](https://cloud.google.com/docs/
+        # permissions-overview#h.bgs0oxofvnoo ) and the [billing account](https://
+        # support.google.com/cloud/answer/4430947). You can disable billing on the
+        # project by setting the `billing_account_name` field to empty. This action
+        # disassociates the current billing account from the project. Any billable
+        # activity of your in-use services will stop, and your application could stop
+        # functioning as expected. Any unbilled charges to date will be billed to the
+        # previously associated account. The current authenticated user must be either
+        # an owner of the project or an owner of the billing account for the project.
+        # Note that associating a project with a *closed* billing account will have much
+        # the same effect as disabling billing on the project: any paid resources used
+        # by the project will be shut down. Thus, unless you wish to disable billing,
+        # you should always call this method with the name of an *open* billing account.
+        # @param [String] name
+        #   The resource name of the project associated with the billing information that
+        #   you want to update. For example, `projects/tokyo-rain-123`.
+        # @param [Google::Apis::CloudbillingV1::ProjectBillingInfo] project_billing_info_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::ProjectBillingInfo] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::ProjectBillingInfo]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_project_billing_info(name, project_billing_info_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'v1/{+name}/billingInfo', options)
+          command.request_representation = Google::Apis::CloudbillingV1::ProjectBillingInfo::Representation
+          command.request_object = project_billing_info_object
+          command.response_representation = Google::Apis::CloudbillingV1::ProjectBillingInfo::Representation
+          command.response_class = Google::Apis::CloudbillingV1::ProjectBillingInfo
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end