google-api-ruby-client/google-api-client/generated/google/apis/chromeuxreport_v1/classes.rb

# 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 ChromeuxreportV1
      
      # A bin is a discrete portion of data spanning from start to end, or if no end
      # is given, then from start to +inf. A bin's start and end values are given in
      # the value type of the metric it represents. For example, "first contentful
      # paint" is measured in milliseconds and exposed as ints, therefore its metric
      # bins will use int32s for its start and end types. However, "cumulative layout
      # shift" is measured in unitless decimals and is exposed as a decimal encoded as
      # a string, therefore its metric bins will use strings for its value type.
      class Bin
        include Google::Apis::Core::Hashable
      
        # The proportion of users that experienced this bin's value for the given metric.
        # Corresponds to the JSON property `density`
        # @return [Float]
        attr_accessor :density
      
        # End is the end of the data bin. If end is not populated, then the bin has no
        # end and is valid from start to +inf.
        # Corresponds to the JSON property `end`
        # @return [Object]
        attr_accessor :end
      
        # Start is the beginning of the data bin.
        # Corresponds to the JSON property `start`
        # @return [Object]
        attr_accessor :start
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @density = args[:density] if args.key?(:density)
          @end = args[:end] if args.key?(:end)
          @start = args[:start] if args.key?(:start)
        end
      end
      
      # Key defines all the dimensions that identify this record as unique.
      class Key
        include Google::Apis::Core::Hashable
      
        # The effective connection type is the general connection class that all users
        # experienced for this record. This field uses the values ["offline", "slow-2G",
        # "2G", "3G", "4G"] as specified in: https://wicg.github.io/netinfo/#effective-
        # connection-types If the effective connection type is unspecified, then
        # aggregated data over all effective connection types will be returned.
        # Corresponds to the JSON property `effectiveConnectionType`
        # @return [String]
        attr_accessor :effective_connection_type
      
        # The form factor is the device class that all users used to access the site for
        # this record. If the form factor is unspecified, then aggregated data over all
        # form factors will be returned.
        # Corresponds to the JSON property `formFactor`
        # @return [String]
        attr_accessor :form_factor
      
        # Origin specifies the origin that this record is for. Note: When specifying an
        # origin, data for loads under this origin over all pages are aggregated into
        # origin level user experience data.
        # Corresponds to the JSON property `origin`
        # @return [String]
        attr_accessor :origin
      
        # Url specifies a specific url that this record is for. Note: When specifying a "
        # url" only data for that specific url will be aggregated.
        # Corresponds to the JSON property `url`
        # @return [String]
        attr_accessor :url
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @effective_connection_type = args[:effective_connection_type] if args.key?(:effective_connection_type)
          @form_factor = args[:form_factor] if args.key?(:form_factor)
          @origin = args[:origin] if args.key?(:origin)
          @url = args[:url] if args.key?(:url)
        end
      end
      
      # A `metric` is a set of user experience data for a single web performance
      # metric, like "first contentful paint". It contains a summary histogram of real
      # world Chrome usage as a series of `bins`.
      class Metric
        include Google::Apis::Core::Hashable
      
        # The histogram of user experiences for a metric. The histogram will have at
        # least one bin and the densities of all bins will add up to ~1.
        # Corresponds to the JSON property `histogram`
        # @return [Array<Google::Apis::ChromeuxreportV1::Bin>]
        attr_accessor :histogram
      
        # Percentiles contains synthetic values of a metric at a given statistical
        # percentile. These are used for estimating a metric's value as experienced by a
        # percentage of users out of the total number of users.
        # Corresponds to the JSON property `percentiles`
        # @return [Google::Apis::ChromeuxreportV1::Percentiles]
        attr_accessor :percentiles
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @histogram = args[:histogram] if args.key?(:histogram)
          @percentiles = args[:percentiles] if args.key?(:percentiles)
        end
      end
      
      # Percentiles contains synthetic values of a metric at a given statistical
      # percentile. These are used for estimating a metric's value as experienced by a
      # percentage of users out of the total number of users.
      class Percentiles
        include Google::Apis::Core::Hashable
      
        # 75% of users experienced the given metric at or below this value.
        # Corresponds to the JSON property `p75`
        # @return [Object]
        attr_accessor :p75
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @p75 = args[:p75] if args.key?(:p75)
        end
      end
      
      # Request payload sent by a physical web client. This request includes all
      # necessary context to load a particular user experience record.
      class QueryRequest
        include Google::Apis::Core::Hashable
      
        # The effective connection type is a query dimension that specifies the
        # effective network class that the record's data should belong to. This field
        # uses the values ["offline", "slow-2G", "2G", "3G", "4G"] as specified in:
        # https://wicg.github.io/netinfo/#effective-connection-types Note: If no
        # effective connection type is specified, then a special record with aggregated
        # data over all effective connection types will be returned.
        # Corresponds to the JSON property `effectiveConnectionType`
        # @return [String]
        attr_accessor :effective_connection_type
      
        # The form factor is a query dimension that specifies the device class that the
        # record's data should belong to. Note: If no form factor is specified, then a
        # special record with aggregated data over all form factors will be returned.
        # Corresponds to the JSON property `formFactor`
        # @return [String]
        attr_accessor :form_factor
      
        # The metrics that should be included in the response. If none are specified
        # then any metrics found will be returned. Allowed values: ["
        # first_contentful_paint", "first_input_delay", "largest_contentful_paint", "
        # cumulative_layout_shift"]
        # Corresponds to the JSON property `metrics`
        # @return [Array<String>]
        attr_accessor :metrics
      
        # The url pattern "origin" refers to a url pattern that is the origin of a
        # website. Examples: "https://example.com", "https://cloud.google.com"
        # Corresponds to the JSON property `origin`
        # @return [String]
        attr_accessor :origin
      
        # The url pattern "url" refers to a url pattern that is any arbitrary url.
        # Examples: "https://example.com/", "https://cloud.google.com/why-google-cloud/"
        # Corresponds to the JSON property `url`
        # @return [String]
        attr_accessor :url
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @effective_connection_type = args[:effective_connection_type] if args.key?(:effective_connection_type)
          @form_factor = args[:form_factor] if args.key?(:form_factor)
          @metrics = args[:metrics] if args.key?(:metrics)
          @origin = args[:origin] if args.key?(:origin)
          @url = args[:url] if args.key?(:url)
        end
      end
      
      # Response payload sent back to a physical web client. This response contains
      # the record found based on the identiers present in a `QueryRequest`. The
      # returned response will have a record, and sometimes details on normalization
      # actions taken on the request that were necessary to make the request
      # successful.
      class QueryResponse
        include Google::Apis::Core::Hashable
      
        # Record is a single Chrome UX report data record. It contains use experience
        # statistics for a single url pattern and set of dimensions.
        # Corresponds to the JSON property `record`
        # @return [Google::Apis::ChromeuxreportV1::Record]
        attr_accessor :record
      
        # Object representing the normalization actions taken to normalize a url to
        # achieve a higher chance of successful lookup. These are simple automated
        # changes that are taken when looking up the provided `url_patten` would be
        # known to fail. Complex actions like following redirects are not handled.
        # Corresponds to the JSON property `urlNormalizationDetails`
        # @return [Google::Apis::ChromeuxreportV1::UrlNormalization]
        attr_accessor :url_normalization_details
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @record = args[:record] if args.key?(:record)
          @url_normalization_details = args[:url_normalization_details] if args.key?(:url_normalization_details)
        end
      end
      
      # Record is a single Chrome UX report data record. It contains use experience
      # statistics for a single url pattern and set of dimensions.
      class Record
        include Google::Apis::Core::Hashable
      
        # Key defines all the dimensions that identify this record as unique.
        # Corresponds to the JSON property `key`
        # @return [Google::Apis::ChromeuxreportV1::Key]
        attr_accessor :key
      
        # Metrics is the map of user experience data available for the record defined in
        # the key field. Metrics are keyed on the metric name. Allowed key values: ["
        # first_contentful_paint", "first_input_delay", "largest_contentful_paint", "
        # cumulative_layout_shift"]
        # Corresponds to the JSON property `metrics`
        # @return [Hash<String,Google::Apis::ChromeuxreportV1::Metric>]
        attr_accessor :metrics
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @key = args[:key] if args.key?(:key)
          @metrics = args[:metrics] if args.key?(:metrics)
        end
      end
      
      # Object representing the normalization actions taken to normalize a url to
      # achieve a higher chance of successful lookup. These are simple automated
      # changes that are taken when looking up the provided `url_patten` would be
      # known to fail. Complex actions like following redirects are not handled.
      class UrlNormalization
        include Google::Apis::Core::Hashable
      
        # The URL after any normalization actions. This is a valid user experience URL
        # that could reasonably be looked up.
        # Corresponds to the JSON property `normalizedUrl`
        # @return [String]
        attr_accessor :normalized_url
      
        # The original requested URL prior to any normalization actions.
        # Corresponds to the JSON property `originalUrl`
        # @return [String]
        attr_accessor :original_url
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @normalized_url = args[:normalized_url] if args.key?(:normalized_url)
          @original_url = args[:original_url] if args.key?(:original_url)
        end
      end
    end
  end
end