google-api-client 0.25.0 → 0.26.0

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

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UndeleteAlertRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AccountWarning
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -390,6 +396,13 @@ module Google
           property :serial_number, as: 'serialNumber'
         end
       end
+      
+      class UndeleteAlertRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :customer_id, as: 'customerId'
+        end
+      end
     end
   end
 end

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

@@ -22,8 +22,7 @@ module Google
     module AlertcenterV1beta1
       # G Suite Alert Center API
       #
-      # G Suite Alert Center API to view and manage alerts on issues affecting your
-      #  domain.
+      # Manages alerts on issues affecting your domain.
       #
       # @example
       #    require 'google/apis/alertcenter_v1beta1'
@@ -49,17 +48,16 @@ module Google
         end
         
         # Marks the specified alert for deletion. An alert that has been marked for
-        # deletion will be excluded from the results of a List operation by default,
-        # and will be removed from the Alert Center after 30 days.
-        # Marking an alert for deletion will have no effect on an alert which has
+        # deletion is removed from Alert Center after 30 days.
+        # Marking an alert for deletion has no effect on an alert which has
         # already been marked for deletion. Attempting to mark a nonexistent alert
-        # for deletion will return NOT_FOUND.
+        # for deletion results in a `NOT_FOUND` error.
         # @param [String] alert_id
         #   Required. The identifier of the alert to delete.
         # @param [String] customer_id
-        #   Optional. The unique identifier of the Google account of the customer the
-        #   alert is associated with. This is obfuscated and not the plain customer
-        #   ID as stored internally. Inferred from the caller identity if not provided.
+        #   Optional. The unique identifier of the G Suite organization account of the
+        #   customer the alert is associated with.
+        #   Inferred from the caller identity if not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -91,10 +89,11 @@ module Google
         # Gets the specified alert.
         # @param [String] alert_id
         #   Required. The identifier of the alert to retrieve.
+        #   Returns a NOT_FOUND error if no such alert.
         # @param [String] customer_id
-        #   Optional. The unique identifier of the Google account of the customer the
-        #   alert is associated with. This is obfuscated and not the plain customer
-        #   ID as stored internally. Inferred from the caller identity if not provided.
+        #   Optional. The unique identifier of the G Suite organization account of the
+        #   customer the alert is associated with.
+        #   Inferred from the caller identity if not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -123,67 +122,31 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all the alerts for the current user and application.
+        # Lists the alerts.
         # @param [String] customer_id
-        #   Optional. The unique identifier of the Google account of the customer the
-        #   alerts are associated with. This is obfuscated and not the plain
-        #   customer ID as stored internally. Inferred from the caller identity if not
-        #   provided.
+        #   Optional. The unique identifier of the G Suite organization account of the
+        #   customer the alerts are associated with.
+        #   Inferred from the caller identity if not provided.
         # @param [String] filter
-        #   Optional. Query string for filtering alert results.
-        #   This string must be specified as an expression or list of expressions,
-        #   using the following grammar:
-        #   ### Expressions
-        #   An expression has the general form `<field> <operator> <value>`.
-        #   A field or value which contains a space or a colon must be enclosed by
-        #   double quotes.
-        #   #### Operators
-        #   Operators follow the BNF specification:
-        #   `<equalityOperator> ::= "=" | ":"`
-        #   `<relationalOperator> ::= "<" | ">" | "<=" | ">="`
-        #   Relational operators are defined only for timestamp fields. Equality
-        #   operators are defined only for string fields.
-        #   #### Timestamp fields
-        #   The value supplied for a timestamp field must be an
-        #   [RFC 3339](https://tools.ietf.org/html/rfc3339) date-time string.
-        #   Supported timestamp fields are `create_time`, `start_time`, and `end_time`.
-        #   #### String fields
-        #   The value supplied for a string field may be an arbitrary string.
-        #   #### Examples
-        #   To query for all alerts created on or after April 5, 2018:
-        #   `create_time >= "2018-04-05T00:00:00Z"`
-        #   To query for all alerts from the source "Gmail phishing":
-        #   `source:"Gmail phishing"`
-        #   ### Joining expressions
-        #   Expressions may be joined to form a more complex query. The BNF
-        #   specification is:
-        #   `<expressionList> ::= <expression> | <expressionList> <conjunction>
-        #   <expressionList> | <negation> <expressionList>`
-        #   `<conjunction> ::= "AND" | "OR" | ""`
-        #   `<negation> ::= "NOT"`
-        #   Using the empty string as a conjunction acts as an implicit AND.
-        #   The precedence of joining operations, from highest to lowest, is NOT, AND,
-        #   OR.
-        #   #### Examples
-        #   To query for all alerts which started in 2017:
-        #   `start_time >= "2017-01-01T00:00:00Z" AND start_time <
-        #   "2018-01-01T00:00:00Z"`
-        #   To query for all user reported phishing alerts from the source
-        #   "Gmail phishing":
-        #   `type:"User reported phishing" source:"Gmail phishing"`
+        #   Optional. A query string for filtering alert results.
+        #   For more details, see [Query
+        #   filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported
+        #   query filter fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.
+        #   list).
         # @param [String] order_by
-        #   Optional. Sort the list results by a certain order.
+        #   Optional. The sort order of the list results.
         #   If not specified results may be returned in arbitrary order.
-        #   You can sort the results in a descending order based on the creation
-        #   timestamp using order_by="create_time desc".
-        #   Currently, only sorting by create_time desc is supported.
+        #   You can sort the results in descending order based on the creation
+        #   timestamp using `order_by="create_time desc"`.
+        #   Currently, only sorting by `create_time desc` is supported.
         # @param [Fixnum] page_size
-        #   Optional. Requested page size. Server may return fewer items than
-        #   requested. If unspecified, server will pick an appropriate default.
+        #   Optional. The requested page size. Server may return fewer items than
+        #   requested. If unspecified, server picks an appropriate default.
         # @param [String] page_token
         #   Optional. A token identifying a page of results the server should return.
         #   If empty, a new iteration is started. To continue an iteration, pass in
-        #   the value from the previous ListAlertsResponse's next_page_token field.
+        #   the value from the previous ListAlertsResponse's
+        #   next_page_token field.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -215,16 +178,52 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new alert feedback.
+        # Restores, or "undeletes", an alert that was marked for deletion within the
+        # past 30 days. Attempting to undelete an alert which was marked for deletion
+        # over 30 days ago (which has been removed from the Alert Center database) or
+        # a nonexistent alert returns a `NOT_FOUND` error. Attempting to
+        # undelete an alert which has not been marked for deletion has no effect.
+        # @param [String] alert_id
+        #   Required. The identifier of the alert to undelete.
+        # @param [Google::Apis::AlertcenterV1beta1::UndeleteAlertRequest] undelete_alert_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::AlertcenterV1beta1::Alert] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AlertcenterV1beta1::Alert]
+        #
+        # @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 undelete_alert(alert_id, undelete_alert_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/alerts/{alertId}:undelete', options)
+          command.request_representation = Google::Apis::AlertcenterV1beta1::UndeleteAlertRequest::Representation
+          command.request_object = undelete_alert_request_object
+          command.response_representation = Google::Apis::AlertcenterV1beta1::Alert::Representation
+          command.response_class = Google::Apis::AlertcenterV1beta1::Alert
+          command.params['alertId'] = alert_id unless alert_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
+        
+        # Creates new feedback for an alert.
         # @param [String] alert_id
         #   Required. The identifier of the alert this feedback belongs to.
-        #   Returns a NOT_FOUND error if no such alert.
+        #   Returns a `NOT_FOUND` error if no such alert.
         # @param [Google::Apis::AlertcenterV1beta1::AlertFeedback] alert_feedback_object
         # @param [String] customer_id
-        #   Optional. The unique identifier of the Google account of the customer the
-        #   alert's feedback is associated with. This is obfuscated and not the
-        #   plain customer ID as stored internally. Inferred from the caller identity
-        #   if not provided.
+        #   Optional. The unique identifier of the G Suite organization account of the
+        #   customer the alert is associated with.
+        #   Inferred from the caller identity if not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -258,11 +257,18 @@ module Google
         # Lists all the feedback for an alert.
         # @param [String] alert_id
         #   Required. The alert identifier.
-        #   If the alert does not exist returns a NOT_FOUND error.
+        #   The "-" wildcard could be used to represent all alerts.
+        #   If alert does not exist returns a `NOT_FOUND` error.
         # @param [String] customer_id
-        #   Optional. The unique identifier of the Google account of the customer the
-        #   alert is associated with. This is obfuscated and not the plain customer
-        #   ID as stored internally. Inferred from the caller identity if not provided.
+        #   Optional. The unique identifier of the G Suite organization account of the
+        #   customer the alert feedback are associated with.
+        #   Inferred from the caller identity if not provided.
+        # @param [String] filter
+        #   Optional. A query string for filtering alert feedback results.
+        #   For more details, see [Query
+        #   filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported
+        #   query filter fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.
+        #   feedback.list).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -280,12 +286,13 @@ 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 list_alert_feedbacks(alert_id, customer_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_alert_feedbacks(alert_id, customer_id: nil, filter: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1beta1/alerts/{alertId}/feedback', options)
           command.response_representation = Google::Apis::AlertcenterV1beta1::ListAlertFeedbackResponse::Representation
           command.response_class = Google::Apis::AlertcenterV1beta1::ListAlertFeedbackResponse
           command.params['alertId'] = alert_id unless alert_id.nil?
           command.query['customerId'] = customer_id unless customer_id.nil?
+          command.query['filter'] = filter unless filter.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/androiddeviceprovisioning_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/zero-touch/
     module AndroiddeviceprovisioningV1
       VERSION = 'V1'
-      REVISION = '20181027'
+      REVISION = '20181202'
     end
   end
 end

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

@@ -38,6 +38,12 @@ module Google
         # @return [Google::Apis::AndroiddeviceprovisioningV1::DeviceIdentifier]
         attr_accessor :device_identifier
       
+        # Metadata entries that can be attached to a `Device`. To learn more, read
+        # [Device metadata](/zero-touch/guides/metadata).
+        # Corresponds to the JSON property `deviceMetadata`
+        # @return [Google::Apis::AndroiddeviceprovisioningV1::DeviceMetadata]
+        attr_accessor :device_metadata
+      
         # Required. The section type of the device's provisioning record.
         # Corresponds to the JSON property `sectionType`
         # @return [String]
@@ -51,6 +57,7 @@ module Google
         def update!(**args)
           @customer_id = args[:customer_id] if args.key?(:customer_id)
           @device_identifier = args[:device_identifier] if args.key?(:device_identifier)
+          @device_metadata = args[:device_metadata] if args.key?(:device_metadata)
           @section_type = args[:section_type] if args.key?(:section_type)
         end
       end

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

@@ -268,6 +268,8 @@ module Google
           property :customer_id, :numeric_string => true, as: 'customerId'
           property :device_identifier, as: 'deviceIdentifier', class: Google::Apis::AndroiddeviceprovisioningV1::DeviceIdentifier, decorator: Google::Apis::AndroiddeviceprovisioningV1::DeviceIdentifier::Representation
       
+          property :device_metadata, as: 'deviceMetadata', class: Google::Apis::AndroiddeviceprovisioningV1::DeviceMetadata, decorator: Google::Apis::AndroiddeviceprovisioningV1::DeviceMetadata::Representation
+      
           property :section_type, as: 'sectionType'
         end
       end

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

@@ -743,7 +743,7 @@ module Google
         # @param [Fixnum] metadata_owner_id
         #   Required. The owner of the newly set metadata. Set this to the partner ID.
         # @param [Fixnum] device_id
-        #   Required. The ID of the reseller partner.
+        #   Required. The ID of the device.
         # @param [Google::Apis::AndroiddeviceprovisioningV1::UpdateDeviceMetadataRequest] update_device_metadata_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/androidenterprise_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/android/work/play/emm-api
     module AndroidenterpriseV1
       VERSION = 'V1'
-      REVISION = '20181024'
+      REVISION = '20181120'
 
       # Manage corporate Android devices
       AUTH_ANDROIDENTERPRISE = 'https://www.googleapis.com/auth/androidenterprise'

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

@@ -429,20 +429,20 @@ module Google
       class AppVersion
         include Google::Apis::Core::Hashable
       
-        # True if this version is a production Apk.
+        # True if this version is a production APK.
         # Corresponds to the JSON property `isProduction`
         # @return [Boolean]
         attr_accessor :is_production
         alias_method :is_production?, :is_production
       
-        # The track that this app was published in. For example if track is "alpha",
-        # this is an alpha version of the app. Deprecated, use track_id instead.
+        # Deprecated, use trackId instead.
         # Corresponds to the JSON property `track`
         # @return [String]
         attr_accessor :track
       
-        # The track ids that this version was published in. This field supersedes track,
-        # but doesn't include the production track.
+        # Track ids that the app version is published in. Replaces the track field (
+        # deprecated), but doesn't include the production track (see isProduction
+        # instead).
         # Corresponds to the JSON property `trackId`
         # @return [Array<String>]
         attr_accessor :track_id
@@ -1792,7 +1792,7 @@ module Google
       class Product
         include Google::Apis::Core::Hashable
       
-        # The tracks that are visible to the enterprise with their user-friendly name.
+        # The tracks visible to the enterprise.
         # Corresponds to the JSON property `appTracks`
         # @return [Array<Google::Apis::AndroidenterpriseV1::TrackInfo>]
         attr_accessor :app_tracks
@@ -1812,8 +1812,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :available_countries
       
-        # The tracks that are visible to the enterprise. Deprecated, use app_tracks
-        # instead.
+        # Deprecated, use appTracks instead.
         # Corresponds to the JSON property `availableTracks`
         # @return [Array<String>]
         attr_accessor :available_tracks
@@ -2084,27 +2083,14 @@ module Google
         # @return [String]
         attr_accessor :product_id
       
-        # Grants visibility to the specified track(s) of the product to the device. The
-        # existing track ids can be obtained by calling Products.Get.
+        # Grants the device visibility to the specified product release track(s),
+        # identified by trackIds. The list of release tracks of a product can be
+        # obtained by calling Products.Get.
         # Corresponds to the JSON property `trackIds`
         # @return [Array<String>]
         attr_accessor :track_ids
       
-        # Grants visibility to the specified track(s) of the product to the device. The
-        # track available to the device is based on the following order of preference:
-        # alpha, beta, production. For example, if an app has a prod version, a beta
-        # version and an alpha version and the enterprise has been granted visibility to
-        # both the alpha and beta tracks, if tracks is `"beta", "production"` then the
-        # beta version of the app is made available to the device. If there are no app
-        # versions in the specified track adding the "alpha" and "beta" values to the
-        # list of tracks will have no effect. Note that the enterprise requires access
-        # to alpha and/or beta tracks before users can be granted visibility to apps in
-        # those tracks.
-        # The allowed sets are: `` (considered equivalent to `"production"`) `"
-        # production"` `"beta", "production"` `"alpha", "beta", "production"` The order
-        # of elements is not relevant. Any other set of tracks will be rejected with an
-        # error.
-        # This is deprecated. Use track_ids instead.
+        # Deprecated. Use trackIds instead.
         # Corresponds to the JSON property `tracks`
         # @return [Array<String>]
         attr_accessor :tracks
@@ -2210,27 +2196,13 @@ module Google
         # @return [String]
         attr_accessor :product_id
       
-        # Grants visibility to the specified track(s) of the product to the user. This
-        # replaces the tracks field, and specifies the track by their unique id.
+        # Grants the user visibility to the specified product track(s), identified by
+        # trackIds.
         # Corresponds to the JSON property `trackIds`
         # @return [Array<String>]
         attr_accessor :track_ids
       
-        # Grants visibility to the specified track(s) of the product to the user. The
-        # track available to the user is based on the following order of preference:
-        # alpha, beta, production. For example, if an app has a prod version, a beta
-        # version and an alpha version and the enterprise has been granted visibility to
-        # both the alpha and beta tracks, if tracks is `"beta", "production"` the user
-        # will be able to install the app and they will get the beta version of the app.
-        # If there are no app versions in the specified track adding the "alpha" and "
-        # beta" values to the list of tracks will have no effect. Note that the
-        # enterprise requires access to alpha and/or beta tracks before users can be
-        # granted visibility to apps in those tracks.
-        # The allowed sets are: `` (considered equivalent to `"production"`) `"
-        # production"` `"beta", "production"` `"alpha", "beta", "production"` The order
-        # of elements is not relevant. Any other set of tracks will be rejected with an
-        # error.
-        # This is deprecated. Use track_ids instead.
+        # Deprecated. Use trackIds instead.
         # Corresponds to the JSON property `tracks`
         # @return [Array<String>]
         attr_accessor :tracks
@@ -2695,12 +2667,15 @@ module Google
       class TrackInfo
         include Google::Apis::Core::Hashable
       
-        # A changeable, user-friendly name for a track.
+        # A modifiable name for a track. This is the visible name in the play developer
+        # console.
         # Corresponds to the JSON property `trackAlias`
         # @return [String]
         attr_accessor :track_alias
       
-        # A unique an unchangeable identifier of a test track.
+        # Unmodifiable, unique track identifier. This identifier is the releaseTrackId
+        # in the url of the play developer console page that displays the track
+        # information.
         # Corresponds to the JSON property `trackId`
         # @return [String]
         attr_accessor :track_id
@@ -2888,6 +2863,116 @@ module Google
           @user_value = args[:user_value] if args.key?(:user_value)
         end
       end
+      
+      # WebApp resource info.
+      class WebApp
+        include Google::Apis::Core::Hashable
+      
+        # The display mode of the web app.
+        # Corresponds to the JSON property `displayMode`
+        # @return [String]
+        attr_accessor :display_mode
+      
+        # A list of icons representing this website. Must have at least one element.
+        # Corresponds to the JSON property `icons`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::WebAppIcon>]
+        attr_accessor :icons
+      
+        # A flag whether the app has been published to the Play store yet.
+        # Corresponds to the JSON property `isPublished`
+        # @return [Boolean]
+        attr_accessor :is_published
+        alias_method :is_published?, :is_published
+      
+        # The start URL, i.e. the URL that should load when the user opens the
+        # application.
+        # Corresponds to the JSON property `startUrl`
+        # @return [String]
+        attr_accessor :start_url
+      
+        # The title of the web application as displayed to the user (e.g., amongst a
+        # list of other applications, or as a label for an icon).
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        # The current version of the app.
+        # Note that the version can automatically increase during the lifetime of the
+        # web app, while Google does internal housekeeping to keep the web app up-to-
+        # date.
+        # Corresponds to the JSON property `versionCode`
+        # @return [Fixnum]
+        attr_accessor :version_code
+      
+        # The ID of the application.
+        # Corresponds to the JSON property `webAppId`
+        # @return [String]
+        attr_accessor :web_app_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_mode = args[:display_mode] if args.key?(:display_mode)
+          @icons = args[:icons] if args.key?(:icons)
+          @is_published = args[:is_published] if args.key?(:is_published)
+          @start_url = args[:start_url] if args.key?(:start_url)
+          @title = args[:title] if args.key?(:title)
+          @version_code = args[:version_code] if args.key?(:version_code)
+          @web_app_id = args[:web_app_id] if args.key?(:web_app_id)
+        end
+      end
+      
+      # Icon for a web app.
+      class WebAppIcon
+        include Google::Apis::Core::Hashable
+      
+        # The actual bytes of the image in a base64url encoded string (c.f. RFC4648,
+        # section 5 "Base 64 Encoding with URL and Filename Safe Alphabet").
+        # - The image type can be png or jpg.
+        # - The image should ideally be square.
+        # - The image should ideally have a size of 512x512.
+        # Corresponds to the JSON property `imageData`
+        # @return [String]
+        attr_accessor :image_data
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @image_data = args[:image_data] if args.key?(:image_data)
+        end
+      end
+      
+      # The web app details for an enterprise.
+      class WebAppsListResponse
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#webAppsListResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The manifest describing a web app.
+        # Corresponds to the JSON property `webApp`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::WebApp>]
+        attr_accessor :web_app
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @web_app = args[:web_app] if args.key?(:web_app)
+        end
+      end
     end
   end
 end