google-api-client 0.19.8 → 0.20.0

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

@@ -0,0 +1,261 @@
+# 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 GenomicsV2alpha1
+      # Genomics API
+      #
+      # Upload, process, query, and search Genomics data in the cloud.
+      #
+      # @example
+      #    require 'google/apis/genomics_v2alpha1'
+      #
+      #    Genomics = Google::Apis::GenomicsV2alpha1 # Alias the module
+      #    service = Genomics::GenomicsService.new
+      #
+      # @see https://cloud.google.com/genomics
+      class GenomicsService < 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://genomics.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Runs a pipeline.
+        # **Note:** In order to use this method, the Genomics Service Agent
+        # must have access to your project.  This is done automatically when the
+        # Genomics API is first enabled, but if you delete this permission, or if
+        # you have already enabled the Genomics API prior to the launch of the
+        # v2alpha1 API, you must disable and re-enable the API to grant the Genomics
+        # Service Agent the required permissions.
+        # [1]: /genomics/gsa
+        # @param [Google::Apis::GenomicsV2alpha1::RunPipelineRequest] run_pipeline_request_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::GenomicsV2alpha1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV2alpha1::Operation]
+        #
+        # @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 run_pipeline(run_pipeline_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2alpha1/pipelines:run', options)
+          command.request_representation = Google::Apis::GenomicsV2alpha1::RunPipelineRequest::Representation
+          command.request_object = run_pipeline_request_object
+          command.response_representation = Google::Apis::GenomicsV2alpha1::Operation::Representation
+          command.response_class = Google::Apis::GenomicsV2alpha1::Operation
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. Clients
+        # may use Operations.GetOperation or Operations.ListOperations to check whether
+        # the cancellation succeeded or the operation completed despite cancellation.
+        # @param [String] name
+        #   The name of the operation resource to be cancelled.
+        # @param [Google::Apis::GenomicsV2alpha1::CancelOperationRequest] cancel_operation_request_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::GenomicsV2alpha1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV2alpha1::Empty]
+        #
+        # @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 cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2alpha1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::GenomicsV2alpha1::CancelOperationRequest::Representation
+          command.request_object = cancel_operation_request_object
+          command.response_representation = Google::Apis::GenomicsV2alpha1::Empty::Representation
+          command.response_class = Google::Apis::GenomicsV2alpha1::Empty
+          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
+        
+        # Gets the latest state of a long-running operation.  Clients can use this
+        # method to poll the operation result at intervals as recommended by the API
+        # service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @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::GenomicsV2alpha1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV2alpha1::Operation]
+        #
+        # @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_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2alpha1/{+name}', options)
+          command.response_representation = Google::Apis::GenomicsV2alpha1::Operation::Representation
+          command.response_class = Google::Apis::GenomicsV2alpha1::Operation
+          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 operations that match the specified filter in the request.
+        # @param [String] name
+        #   The name of the operation's parent resource.
+        # @param [String] filter
+        #   A string for filtering Operations.
+        #   In v2alpha1, the following filter fields are supported&#58;
+        #   * createTime&#58; The time this job was created
+        #   * events&#58; The set of event (names) that have occurred while running
+        #   the pipeline.  The &#58; operator can be used to determine if a
+        #   particular event has occurred.
+        #   * error&#58; If the pipeline is running, this value is NULL.  Once the
+        #   pipeline finishes, the value is the standard Google error code.
+        #   * labels.key or labels."key with space" where key is a label key.
+        #   In v1 and v1alpha2, the following filter fields are supported&#58;
+        #   * projectId&#58; Required. Corresponds to
+        #   OperationMetadata.projectId.
+        #   * createTime&#58; The time this job was created, in seconds from the
+        #   [epoch](http://en.wikipedia.org/wiki/Unix_time). Can use `>=` and/or `<=`
+        #   operators.
+        #   * status&#58; Can be `RUNNING`, `SUCCESS`, `FAILURE`, or `CANCELED`. Only
+        #   one status may be specified.
+        #   * labels.key where key is a label key.
+        #   Examples&#58;
+        #   * `projectId = my-project AND createTime >= 1432140000`
+        #   * `projectId = my-project AND createTime >= 1432140000 AND createTime <=
+        #   1432150000 AND status = RUNNING`
+        #   * `projectId = my-project AND labels.color = *`
+        #   * `projectId = my-project AND labels.color = red`
+        # @param [Fixnum] page_size
+        #   The maximum number of results to return. If unspecified, defaults to
+        #   256. The maximum value is 2048.
+        # @param [String] page_token
+        #   The standard list page token.
+        # @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::GenomicsV2alpha1::ListOperationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV2alpha1::ListOperationsResponse]
+        #
+        # @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_project_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2alpha1/{+name}', options)
+          command.response_representation = Google::Apis::GenomicsV2alpha1::ListOperationsResponse::Representation
+          command.response_class = Google::Apis::GenomicsV2alpha1::ListOperationsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['filter'] = filter unless filter.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
+        
+        # The worker uses this method to retrieve the assigned operation and
+        # provide periodic status updates.
+        # @param [String] id
+        #   The worker id, assigned when it was created.
+        # @param [Google::Apis::GenomicsV2alpha1::CheckInRequest] check_in_request_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::GenomicsV2alpha1::CheckInResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GenomicsV2alpha1::CheckInResponse]
+        #
+        # @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 check_worker_in(id, check_in_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2alpha1/workers/{id}:checkIn', options)
+          command.request_representation = Google::Apis::GenomicsV2alpha1::CheckInRequest::Representation
+          command.request_object = check_in_request_object
+          command.response_representation = Google::Apis::GenomicsV2alpha1::CheckInResponse::Representation
+          command.response_class = Google::Apis::GenomicsV2alpha1::CheckInResponse
+          command.params['id'] = id unless id.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

data/generated/google/apis/gmail_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/gmail/api/
     module GmailV1
       VERSION = 'V1'
-      REVISION = '20180131'
+      REVISION = '20180319'
 
       # Read, send, delete, and manage your email
       AUTH_SCOPE = 'https://mail.google.com/'

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

@@ -1147,7 +1147,8 @@ module Google
         # A name that appears in the "From:" header for mail sent using this alias. For
         # custom "from" addresses, when this is empty, Gmail will populate the "From:"
         # header with the name that is used for the primary address associated with the
-        # account.
+        # account. If the admin has disabled the ability for users to update their name
+        # format, requests to update this field for the primary login will silently fail.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name

data/generated/google/apis/iam_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/iam/
     module IamV1
       VERSION = 'V1'
-      REVISION = '20180202'
+      REVISION = '20180223'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -930,7 +930,7 @@ module Google
         # The private key data. Only provided in `CreateServiceAccountKey`
         # responses. Make sure to keep the private key data secure because it
         # allows for the assertion of the service account identity.
-        # When decoded, the private key data can be used to authenticate with
+        # When base64 decoded, the private key data can be used to authenticate with
         # Google API client libraries and with
         # <a href="/sdk/gcloud/reference/auth/activate-service-account">gcloud
         # auth activate-service-account</a>.

data/generated/google/apis/language_v1.rb

@@ -18,7 +18,7 @@ require 'google/apis/language_v1/representations.rb'
 
 module Google
   module Apis
-    # Google Cloud Natural Language API
+    # Cloud Natural Language API
     #
     # Provides natural language understanding technologies to developers. Examples
     # include sentiment analysis, entity recognition, entity sentiment analysis, and
@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/natural-language/
     module LanguageV1
       VERSION = 'V1'
-      REVISION = '20171023'
+      REVISION = '20180322'
 
       # Apply machine learning models to reveal the structure and meaning of text
       AUTH_CLOUD_LANGUAGE = 'https://www.googleapis.com/auth/cloud-language'

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

@@ -348,7 +348,8 @@ module Google
         # @return [Float]
         attr_accessor :confidence
       
-        # The name of the category representing the document.
+        # The name of the category representing the document, from the [predefined
+        # taxonomy](/natural-language/docs/categories).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module LanguageV1
-      # Google Cloud Natural Language API
+      # Cloud Natural Language API
       #
       # Provides natural language understanding technologies to developers. Examples
       #  include sentiment analysis, entity recognition, entity sentiment analysis, and

data/generated/google/apis/language_v1beta1.rb

@@ -18,7 +18,7 @@ require 'google/apis/language_v1beta1/representations.rb'
 
 module Google
   module Apis
-    # Google Cloud Natural Language API
+    # Cloud Natural Language API
     #
     # Provides natural language understanding technologies to developers. Examples
     # include sentiment analysis, entity recognition, entity sentiment analysis, and
@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/natural-language/
     module LanguageV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20170911'
+      REVISION = '20180221'
 
       # Apply machine learning models to reveal the structure and meaning of text
       AUTH_CLOUD_LANGUAGE = 'https://www.googleapis.com/auth/cloud-language'

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module LanguageV1beta1
-      # Google Cloud Natural Language API
+      # Cloud Natural Language API
       #
       # Provides natural language understanding technologies to developers. Examples
       #  include sentiment analysis, entity recognition, entity sentiment analysis, and

data/generated/google/apis/language_v1beta2.rb

@@ -18,7 +18,7 @@ require 'google/apis/language_v1beta2/representations.rb'
 
 module Google
   module Apis
-    # Google Cloud Natural Language API
+    # Cloud Natural Language API
     #
     # Provides natural language understanding technologies to developers. Examples
     # include sentiment analysis, entity recognition, entity sentiment analysis, and
@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/natural-language/
     module LanguageV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20171031'
+      REVISION = '20180322'
 
       # Apply machine learning models to reveal the structure and meaning of text
       AUTH_CLOUD_LANGUAGE = 'https://www.googleapis.com/auth/cloud-language'

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

@@ -349,7 +349,8 @@ module Google
         # @return [Float]
         attr_accessor :confidence
       
-        # The name of the category representing the document.
+        # The name of the category representing the document, from the [predefined
+        # taxonomy](/natural-language/docs/categories).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module LanguageV1beta2
-      # Google Cloud Natural Language API
+      # Cloud Natural Language API
       #
       # Provides natural language understanding technologies to developers. Examples
       #  include sentiment analysis, entity recognition, entity sentiment analysis, and

data/generated/google/apis/logging_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2
       VERSION = 'V2'
-      REVISION = '20180213'
+      REVISION = '20180326'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/logging_v2beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20180213'
+      REVISION = '20180326'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/manufacturers_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/manufacturers/
     module ManufacturersV1
       VERSION = 'V1'
-      REVISION = '20180215'
+      REVISION = '20180316'
 
       # Manage your product listings for Google Manufacturer Center
       AUTH_MANUFACTURERCENTER = 'https://www.googleapis.com/auth/manufacturercenter'

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

@@ -43,7 +43,7 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://manufacturers.googleapis.com/', '')
+          super('https://content-manufacturers.googleapis.com/', '')
           @batch_path = 'batch'
         end
         
@@ -172,16 +172,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Uploads the product in a Manufacturer Center account.
-        # The checks at upload time are minimal. All required attributes need to be
-        # present for a product to be valid. Issues may show up later
-        # after the API has accepted a new upload for a product and it is possible to
-        # overwrite an existing valid product with an invalid product. To detect
-        # this, you should retrieve the product and check it for issues once the
-        # new version is available.
-        # Uploaded products first need to be processed before they can be
+        # Inserts or updates the attributes of the product in a Manufacturer Center
+        # account.
+        # Creates a product with the provided attributes. If the product already
+        # exists, then all attributes are replaced with the new ones. The checks at
+        # upload time are minimal. All required attributes need to be present for a
+        # product to be valid. Issues may show up later after the API has accepted a
+        # new upload for a product and it is possible to overwrite an existing valid
+        # product with an invalid product. To detect this, you should retrieve the
+        # product and check it for issues once the new version is available.
+        # Uploaded attributes first need to be processed before they can be
         # retrieved. Until then, new products will be unavailable, and retrieval
-        # of uploaded products will return the original state of the product.
+        # of previously uploaded products will return the original state of the
+        # product.
         # @param [String] parent
         #   Parent ID in the format `accounts/`account_id``.
         #   `account_id` - The ID of the Manufacturer Center account.
@@ -212,7 +215,7 @@ module Google
         # @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 upload_account_product_product(parent, name, attributes_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def update_account_product(parent, name, attributes_object = nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:put, 'v1/{+parent}/products/{+name}', options)
           command.request_representation = Google::Apis::ManufacturersV1::Attributes::Representation
           command.request_object = attributes_object