google-api-client 0.15.0 → 0.16.0

data/generated/google/apis/oslogin_v1alpha.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/compute/docs/oslogin/rest/
     module OsloginV1alpha
       VERSION = 'V1alpha'
-      REVISION = '20170926'
+      REVISION = '20171031'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -45,8 +45,8 @@ module Google
       class ImportSshPublicKeyResponse
         include Google::Apis::Core::Hashable
       
-        # The Directory API profile information used for logging in to a virtual
-        # machine on Google Compute Engine.
+        # The user profile information used for logging in to a virtual machine on
+        # Google Compute Engine.
         # Corresponds to the JSON property `loginProfile`
         # @return [Google::Apis::OsloginV1alpha::LoginProfile]
         attr_accessor :login_profile
@@ -61,8 +61,8 @@ module Google
         end
       end
       
-      # The Directory API profile information used for logging in to a virtual
-      # machine on Google Compute Engine.
+      # The user profile information used for logging in to a virtual machine on
+      # Google Compute Engine.
       class LoginProfile
         include Google::Apis::Core::Hashable
       
@@ -100,10 +100,15 @@ module Google
         end
       end
       
-      # The POSIX account information associated with a Directory API User.
+      # The POSIX account information associated with a Google account.
       class PosixAccount
         include Google::Apis::Core::Hashable
       
+        # Output only. A POSIX account identifier.
+        # Corresponds to the JSON property `accountId`
+        # @return [String]
+        attr_accessor :account_id
+      
         # The GECOS (user information) entry for this account.
         # Corresponds to the JSON property `gecos`
         # @return [String]
@@ -152,6 +157,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @account_id = args[:account_id] if args.key?(:account_id)
           @gecos = args[:gecos] if args.key?(:gecos)
           @gid = args[:gid] if args.key?(:gid)
           @home_directory = args[:home_directory] if args.key?(:home_directory)
@@ -163,7 +169,7 @@ module Google
         end
       end
       
-      # The SSH public key information associated with a Directory API User.
+      # The SSH public key information associated with a Google account.
       class SshPublicKey
         include Google::Apis::Core::Hashable
       
@@ -172,8 +178,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :expiration_time_usec
       
-        # The SHA-256 fingerprint of the SSH public key.
-        # Output only.
+        # Output only. The SHA-256 fingerprint of the SSH public key.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint

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

@@ -81,6 +81,7 @@ module Google
       class PosixAccount
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_id, as: 'accountId'
           property :gecos, as: 'gecos'
           property :gid, :numeric_string => true, as: 'gid'
           property :home_directory, as: 'homeDirectory'

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

@@ -84,6 +84,8 @@ module Google
         # @param [String] parent
         #   The unique ID for the user in format `users/`user``.
         # @param [Google::Apis::OsloginV1alpha::SshPublicKey] ssh_public_key_object
+        # @param [String] project_id
+        #   The project ID of the Google Cloud Platform project.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -101,13 +103,46 @@ 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 import_user_ssh_public_key(parent, ssh_public_key_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def import_user_ssh_public_key(parent, ssh_public_key_object = nil, project_id: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:post, 'v1alpha/{+parent}:importSshPublicKey', options)
           command.request_representation = Google::Apis::OsloginV1alpha::SshPublicKey::Representation
           command.request_object = ssh_public_key_object
           command.response_representation = Google::Apis::OsloginV1alpha::ImportSshPublicKeyResponse::Representation
           command.response_class = Google::Apis::OsloginV1alpha::ImportSshPublicKeyResponse
           command.params['parent'] = parent unless parent.nil?
+          command.query['projectId'] = project_id unless project_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
+        
+        # Deletes a POSIX account.
+        # @param [String] name
+        #   A reference to the POSIX account to update. POSIX accounts are identified
+        #   by the project ID they are associated with. A reference to the POSIX
+        #   account is in format `users/`user`/projects/`project``.
+        # @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::OsloginV1alpha::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::OsloginV1alpha::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 delete_user_project(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::OsloginV1alpha::Empty::Representation
+          command.response_class = Google::Apis::OsloginV1alpha::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)

data/generated/google/apis/oslogin_v1beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/compute/docs/oslogin/rest/
     module OsloginV1beta
       VERSION = 'V1beta'
-      REVISION = '20170926'
+      REVISION = '20171031'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -101,10 +101,15 @@ module Google
         end
       end
       
-      # The POSIX account information associated with a Directory API User.
+      # The POSIX account information associated with a Google account.
       class PosixAccount
         include Google::Apis::Core::Hashable
       
+        # Output only. A POSIX account identifier.
+        # Corresponds to the JSON property `accountId`
+        # @return [String]
+        attr_accessor :account_id
+      
         # The GECOS (user information) entry for this account.
         # Corresponds to the JSON property `gecos`
         # @return [String]
@@ -153,6 +158,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @account_id = args[:account_id] if args.key?(:account_id)
           @gecos = args[:gecos] if args.key?(:gecos)
           @gid = args[:gid] if args.key?(:gid)
           @home_directory = args[:home_directory] if args.key?(:home_directory)
@@ -164,7 +170,7 @@ module Google
         end
       end
       
-      # The SSH public key information associated with a Directory API User.
+      # The SSH public key information associated with a Google account.
       class SshPublicKey
         include Google::Apis::Core::Hashable
       
@@ -173,8 +179,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :expiration_time_usec
       
-        # The SHA-256 fingerprint of the SSH public key.
-        # Output only.
+        # Output only. The SHA-256 fingerprint of the SSH public key.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint

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

@@ -81,6 +81,7 @@ module Google
       class PosixAccount
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_id, as: 'accountId'
           property :gecos, as: 'gecos'
           property :gid, :numeric_string => true, as: 'gid'
           property :home_directory, as: 'homeDirectory'

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

@@ -84,6 +84,8 @@ module Google
         # @param [String] parent
         #   The unique ID for the user in format `users/`user``.
         # @param [Google::Apis::OsloginV1beta::SshPublicKey] ssh_public_key_object
+        # @param [String] project_id
+        #   The project ID of the Google Cloud Platform project.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -101,13 +103,46 @@ 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 import_user_ssh_public_key(parent, ssh_public_key_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def import_user_ssh_public_key(parent, ssh_public_key_object = nil, project_id: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:post, 'v1beta/{+parent}:importSshPublicKey', options)
           command.request_representation = Google::Apis::OsloginV1beta::SshPublicKey::Representation
           command.request_object = ssh_public_key_object
           command.response_representation = Google::Apis::OsloginV1beta::ImportSshPublicKeyResponse::Representation
           command.response_class = Google::Apis::OsloginV1beta::ImportSshPublicKeyResponse
           command.params['parent'] = parent unless parent.nil?
+          command.query['projectId'] = project_id unless project_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
+        
+        # Deletes a POSIX account.
+        # @param [String] name
+        #   A reference to the POSIX account to update. POSIX accounts are identified
+        #   by the project ID they are associated with. A reference to the POSIX
+        #   account is in format `users/`user`/projects/`project``.
+        # @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::OsloginV1beta::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::OsloginV1beta::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 delete_user_project(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1beta/{+name}', options)
+          command.response_representation = Google::Apis::OsloginV1beta::Empty::Representation
+          command.response_class = Google::Apis::OsloginV1beta::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)

data/generated/google/apis/partners_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/partners/
     module PartnersV2
       VERSION = 'V2'
-      REVISION = '20170812'
+      REVISION = '20171031'
     end
   end
 end

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

@@ -1064,36 +1064,6 @@ module Google
       # specified otherwise, this must conform to the
       # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
       # standard</a>. Values must be within normalized ranges.
-      # Example of normalization code in Python:
-      # def NormalizeLongitude(longitude):
-      # """Wraps decimal degrees longitude to [-180.0, 180.0]."""
-      # q, r = divmod(longitude, 360.0)
-      # if r > 180.0 or (r == 180.0 and q <= -1.0):
-      # return r - 360.0
-      # return r
-      # def NormalizeLatLng(latitude, longitude):
-      # """Wraps decimal degrees latitude and longitude to
-      # [-90.0, 90.0] and [-180.0, 180.0], respectively."""
-      # r = latitude % 360.0
-      # if r <= 90.0:
-      # return r, NormalizeLongitude(longitude)
-      # elif r >= 270.0:
-      # return r - 360, NormalizeLongitude(longitude)
-      # else:
-      # return 180 - r, NormalizeLongitude(longitude + 180.0)
-      # assert 180.0 == NormalizeLongitude(180.0)
-      # assert -180.0 == NormalizeLongitude(-180.0)
-      # assert -179.0 == NormalizeLongitude(181.0)
-      # assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)
-      # assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)
-      # assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)
-      # assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)
-      # assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)
-      # assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)
-      # assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)
-      # assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)
-      # assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)
-      # assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
       class LatLng
         include Google::Apis::Core::Hashable
       
@@ -1530,36 +1500,6 @@ module Google
         # specified otherwise, this must conform to the
         # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
         # standard</a>. Values must be within normalized ranges.
-        # Example of normalization code in Python:
-        # def NormalizeLongitude(longitude):
-        # """Wraps decimal degrees longitude to [-180.0, 180.0]."""
-        # q, r = divmod(longitude, 360.0)
-        # if r > 180.0 or (r == 180.0 and q <= -1.0):
-        # return r - 360.0
-        # return r
-        # def NormalizeLatLng(latitude, longitude):
-        # """Wraps decimal degrees latitude and longitude to
-        # [-90.0, 90.0] and [-180.0, 180.0], respectively."""
-        # r = latitude % 360.0
-        # if r <= 90.0:
-        # return r, NormalizeLongitude(longitude)
-        # elif r >= 270.0:
-        # return r - 360, NormalizeLongitude(longitude)
-        # else:
-        # return 180 - r, NormalizeLongitude(longitude + 180.0)
-        # assert 180.0 == NormalizeLongitude(180.0)
-        # assert -180.0 == NormalizeLongitude(-180.0)
-        # assert -179.0 == NormalizeLongitude(181.0)
-        # assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)
-        # assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)
-        # assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)
-        # assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)
-        # assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)
-        # assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)
-        # assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)
-        # assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)
-        # assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)
-        # assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
         # Corresponds to the JSON property `latLng`
         # @return [Google::Apis::PartnersV2::LatLng]
         attr_accessor :lat_lng
@@ -2282,6 +2222,12 @@ module Google
         # @return [Array<String>]
         attr_accessor :markets
       
+        # Whether or not to migrate the user's exam data to Academy for Ads.
+        # Corresponds to the JSON property `migrateToAfa`
+        # @return [Boolean]
+        attr_accessor :migrate_to_afa
+        alias_method :migrate_to_afa?, :migrate_to_afa
+      
         # The user's phone number.
         # Corresponds to the JSON property `phoneNumber`
         # @return [String]
@@ -2315,6 +2261,7 @@ module Google
           @job_functions = args[:job_functions] if args.key?(:job_functions)
           @languages = args[:languages] if args.key?(:languages)
           @markets = args[:markets] if args.key?(:markets)
+          @migrate_to_afa = args[:migrate_to_afa] if args.key?(:migrate_to_afa)
           @phone_number = args[:phone_number] if args.key?(:phone_number)
           @primary_country_code = args[:primary_country_code] if args.key?(:primary_country_code)
           @profile_public = args[:profile_public] if args.key?(:profile_public)

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

@@ -907,6 +907,7 @@ module Google
           collection :job_functions, as: 'jobFunctions'
           collection :languages, as: 'languages'
           collection :markets, as: 'markets'
+          property :migrate_to_afa, as: 'migrateToAfa'
           property :phone_number, as: 'phoneNumber'
           property :primary_country_code, as: 'primaryCountryCode'
           property :profile_public, as: 'profilePublic'

data/generated/google/apis/proximitybeacon_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/beacons/proximity/
     module ProximitybeaconV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20171003'
+      REVISION = '20171017'
 
       # View and modify your beacons
       AUTH_USERLOCATION_BEACON_REGISTRY = 'https://www.googleapis.com/auth/userlocation.beacon.registry'

data/generated/google/apis/runtimeconfig_v1beta1.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://cloud.google.com/deployment-manager/runtime-configurator/
     module RuntimeconfigV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20170829'
+      REVISION = '20171030'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -416,8 +416,9 @@ module Google
         # The resource name of a runtime config. The name must have the format:
         # projects/[PROJECT_ID]/configs/[CONFIG_NAME]
         # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
-        # arbitrary name that matches RFC 1035 segment specification. The length of
-        # `[CONFIG_NAME]` must be less than 64 bytes.
+        # arbitrary name that matches
+        # [0-9A-Za-z](?:[_.A-Za-z0-9-]`0,62`[_.A-Za-z0-9])? regular expression.
+        # The length of `[CONFIG_NAME]` must be less than 64 characters.
         # You pick the RuntimeConfig resource name, but the server will validate that
         # the name adheres to this format. After you create the resource, you cannot
         # change the resource's name.
@@ -611,8 +612,9 @@ module Google
         # dashes. Slashes are used as path element separators and are not part of the
         # `[VARIABLE_NAME]` itself, so `[VARIABLE_NAME]` must contain at least one
         # non-slash character. Multiple slashes are coalesced into single slash
-        # character. Each path segment should follow RFC 1035 segment specification.
-        # The length of a `[VARIABLE_NAME]` must be less than 256 bytes.
+        # character. Each path segment should match
+        # [0-9A-Za-z](?:[_.A-Za-z0-9-]`0,62`[_.A-Za-z0-9])? regular expression.
+        # The length of a `[VARIABLE_NAME]` must be less than 256 characters.
         # Once you create a variable, you cannot change the variable name.
         # Corresponds to the JSON property `name`
         # @return [String]

data/generated/google/apis/script_v1.rb

@@ -18,14 +18,14 @@ require 'google/apis/script_v1/representations.rb'
 
 module Google
   module Apis
-    # Google Apps Script Execution API
+    # Google Apps Script API
     #
     # An API for managing and executing Google Apps Script projects.
     #
     # @see https://developers.google.com/apps-script/execution/rest/v1/scripts/run
     module ScriptV1
       VERSION = 'V1'
-      REVISION = '20170927'
+      REVISION = '20171024'
 
       # Read, send, delete, and manage your email
       AUTH_SCOPE = 'https://mail.google.com/'

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

@@ -22,12 +22,14 @@ module Google
   module Apis
     module ScriptV1
       
-      # An object that provides information about the nature of an error in the Apps
-      # Script Execution API. If an
-      # `run` call succeeds but the
-      # script function (or Apps Script itself) throws an exception, the response
-      # body's `error` field contains a
-      # `Status` object. The `Status` object's `details` field
+      # An object that provides information about the nature of an error resulting
+      # from an attempted execution of a script function using the Apps Script API.
+      # If a run or
+      # runAsync call
+      # succeeds but the script function (or Apps Script itself) throws an exception,
+      # the response body's error field
+      # contains a
+      # Status object. The `Status` object's `details` field
       # contains an array with a single one of these `ExecutionError` objects.
       class ExecutionError
         include Google::Apis::Core::Hashable
@@ -70,7 +72,7 @@ module Google
       
         # If `true` and the user is an owner of the script, the script runs at the
         # most recently saved version rather than the version deployed for use with
-        # the Execution API. Optional; default is `false`.
+        # the Apps Script API. Optional; default is `false`.
         # Corresponds to the JSON property `devMode`
         # @return [Boolean]
         attr_accessor :dev_mode
@@ -93,12 +95,13 @@ module Google
       
         # For Android add-ons only. An ID that represents the user's current session
         # in the Android app for Google Docs or Sheets, included as extra data in the
-        # [`Intent`](https://developer.android.com/guide/components/intents-filters.html)
+        # [Intent](https://developer.android.com/guide/components/intents-filters.html)
         # that launches the add-on. When an Android add-on is run with a session
         # state, it gains the privileges of a
-        # [bound](https://developers.google.com/apps-script/guides/bound) script —
-        # that is, it can access information like the user's current cursor position
-        # (in Docs) or selected cell (in Sheets). To retrieve the state, call
+        # [bound](https://developers.google.com/apps-script/guides/bound)
+        # script—that is, it can access information like the user's current
+        # cursor position (in Docs) or selected cell (in Sheets). To retrieve the
+        # state, call
         # `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionState")`.
         # Optional.
         # Corresponds to the JSON property `sessionState`
@@ -118,17 +121,15 @@ module Google
         end
       end
       
-      # An object that provides the return value of a function executed through the
-      # Apps Script Execution API. If a
-      # `run` call succeeds and the
-      # script function returns successfully, the response body's
-      # `response` field contains this
+      # An object that provides the return value of a function executed using the
+      # Apps Script API. If the script function returns successfully, the response
+      # body's response field contains this
       # `ExecutionResponse` object.
       class ExecutionResponse
         include Google::Apis::Core::Hashable
       
         # The return value of the script function. The type matches the object type
-        # returned in Apps Script. Functions called through the Execution API cannot
+        # returned in Apps Script. Functions called using the Apps Script API cannot
         # return Apps Script-specific objects (such as a `Document` or a `Calendar`);
         # they can only return primitive types such as a `string`, `number`, `array`,
         # `object`, or `boolean`.
@@ -146,47 +147,52 @@ module Google
         end
       end
       
-      # The response will not arrive until the function finishes executing. The
-      # maximum runtime is listed in the guide to [limitations in Apps Script](https://
-      # developers.google.com/apps-script/guides/services/quotas#current_limitations).
-      # <p>If the script function returns successfully, the `response` field will
-      # contain an `ExecutionResponse` object with the function's return value in the
-      # object's `result` field.</p>
-      # <p>If the script function (or Apps Script itself) throws an exception, the `
-      # error` field will contain a `Status` object. The `Status` object's `details`
-      # field will contain an array with a single `ExecutionError` object that
-      # provides information about the nature of the error.</p>
-      # <p>If the `run` call itself fails (for example, because of a malformed request
-      # or an authorization error), the method will return an HTTP response code in
-      # the 4XX range with a different format for the response body. Client libraries
-      # will automatically convert a 4XX response into an exception class.</p>
+      # A representation of a execution of an Apps Script function that is started
+      # using run or runAsync. The execution response does not arrive until the
+      # function finishes executing. The maximum execution runtime is listed in the [
+      # Apps Script quotas guide](/apps-script/guides/services/quotas#
+      # current_limitations).
+      # <p>After the execution is started, it can have one of four outcomes:</p>
+      # <ul> <li> If the script function returns successfully, the
+      # response field contains an
+      # ExecutionResponse object
+      # with the function's return value in the object's `result` field.</li>
+      # <li> If the script function (or Apps Script itself) throws an exception, the
+      # error field contains a
+      # Status object. The `Status` object's `details`
+      # field contains an array with a single
+      # ExecutionError object that
+      # provides information about the nature of the error.</li>
+      # <li> If the execution was asynchronous and has not yet completed,
+      # the done field is `false` and
+      # the neither the `response` nor `error` fields are present.</li>
+      # <li> If the `run` or `runAsync` call itself fails (for example, because of a
+      # malformed request or an authorization error), the method returns an HTTP
+      # response code in the 4XX range with a different format for the response
+      # body. Client libraries automatically convert a 4XX response into an
+      # exception class.</li>
+      # </ul>
       class Operation
         include Google::Apis::Core::Hashable
       
-        # This field is only used with asynchronous executions and indicates whether or
-        # not the script execution has completed. A completed execution has a populated
-        # response field containing the `ExecutionResponse` from function that was
+        # This field is only used with asynchronous executions. It indicates whether the
+        # script execution has completed. A completed execution has a populated `
+        # response` field containing the ExecutionResponse from function that was
         # executed.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # If a `run` call succeeds but the script function (or Apps Script itself)
-        # throws an exception, the response body's `error` field will contain this `
+        # If a `run` or `runAsync` call succeeds but the script function (or Apps Script
+        # itself) throws an exception, the response body's error field contains this `
         # Status` object.
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::ScriptV1::Status]
         attr_accessor :error
       
-        # This field is not used.
-        # Corresponds to the JSON property `metadata`
-        # @return [Hash<String,Object>]
-        attr_accessor :metadata
-      
-        # If the script function returns successfully, this field will contain an `
-        # ExecutionResponse` object with the function's return value as the object's `
-        # result` field.
+        # If the script function returns successfully, this field contains an
+        # ExecutionResponse object with the function's return value.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -199,7 +205,6 @@ module Google
         def update!(**args)
           @done = args[:done] if args.key?(:done)
           @error = args[:error] if args.key?(:error)
-          @metadata = args[:metadata] if args.key?(:metadata)
           @response = args[:response] if args.key?(:response)
         end
       end
@@ -229,26 +234,27 @@ module Google
         end
       end
       
-      # If a `run` call succeeds but the script function (or Apps Script itself)
-      # throws an exception, the response body's `error` field will contain this `
+      # If a `run` or `runAsync` call succeeds but the script function (or Apps Script
+      # itself) throws an exception, the response body's error field contains this `
       # Status` object.
       class Status
         include Google::Apis::Core::Hashable
       
-        # The status code. For this API, this value will always be 3, corresponding to
-        # an <code>INVALID_ARGUMENT</code> error.
+        # The status code. For this API, this value either:
+        # <ul> <li> 3, indicating an `INVALID_ARGUMENT` error, or</li> <li> 1,
+        # indicating a `CANCELLED` asynchronous execution.</li> </ul>
         # Corresponds to the JSON property `code`
         # @return [Fixnum]
         attr_accessor :code
       
-        # An array that contains a single `ExecutionError` object that provides
+        # An array that contains a single ExecutionError object that provides
         # information about the nature of the error.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
         # A developer-facing error message, which is in English. Any user-facing error
-        # message is localized and sent in the [`google.rpc.Status.details`](google.rpc.
+        # message is localized and sent in the [google.rpc.Status.details](google.rpc.
         # Status.details) field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]