google-api-ruby-client/generated/google/apis/calendar_v3/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 CalendarV3
      
      # 
      class Acl
        include Google::Apis::Core::Hashable
      
        # ETag of the collection.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # List of rules on the access control list.
        # Corresponds to the JSON property `items`
        # @return [Array<Google::Apis::CalendarV3::AclRule>]
        attr_accessor :items
      
        # Type of the collection ("calendar#acl").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Token used to access the next page of this result. Omitted if no further
        # results are available, in which case nextSyncToken is provided.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        # Token used at a later point in time to retrieve only the entries that have
        # changed since this result was returned. Omitted if further results are
        # available, in which case nextPageToken is provided.
        # Corresponds to the JSON property `nextSyncToken`
        # @return [String]
        attr_accessor :next_sync_token
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @etag = args[:etag] if args.key?(:etag)
          @items = args[:items] if args.key?(:items)
          @kind = args[:kind] if args.key?(:kind)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
        end
      end
      
      # 
      class AclRule
        include Google::Apis::Core::Hashable
      
        # ETag of the resource.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # Identifier of the ACL rule.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Type of the resource ("calendar#aclRule").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # The role assigned to the scope. Possible values are:
        # - "none" - Provides no access.
        # - "freeBusyReader" - Provides read access to free/busy information.
        # - "reader" - Provides read access to the calendar. Private events will appear
        # to users with reader access, but event details will be hidden.
        # - "writer" - Provides read and write access to the calendar. Private events
        # will appear to users with writer access, and event details will be visible.
        # - "owner" - Provides ownership of the calendar. This role has all of the
        # permissions of the writer role with the additional ability to see and
        # manipulate ACLs.
        # Corresponds to the JSON property `role`
        # @return [String]
        attr_accessor :role
      
        # The scope of the rule.
        # Corresponds to the JSON property `scope`
        # @return [Google::Apis::CalendarV3::AclRule::Scope]
        attr_accessor :scope
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @etag = args[:etag] if args.key?(:etag)
          @id = args[:id] if args.key?(:id)
          @kind = args[:kind] if args.key?(:kind)
          @role = args[:role] if args.key?(:role)
          @scope = args[:scope] if args.key?(:scope)
        end
        
        # The scope of the rule.
        class Scope
          include Google::Apis::Core::Hashable
        
          # The type of the scope. Possible values are:
          # - "default" - The public scope. This is the default value.
          # - "user" - Limits the scope to a single user.
          # - "group" - Limits the scope to a group.
          # - "domain" - Limits the scope to a domain.  Note: The permissions granted to
          # the "default", or public, scope apply to any user, authenticated or not.
          # Corresponds to the JSON property `type`
          # @return [String]
          attr_accessor :type
        
          # The email address of a user or group, or the name of a domain, depending on
          # the scope type. Omitted for type "default".
          # Corresponds to the JSON property `value`
          # @return [String]
          attr_accessor :value
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @type = args[:type] if args.key?(:type)
            @value = args[:value] if args.key?(:value)
          end
        end
      end
      
      # 
      class Calendar
        include Google::Apis::Core::Hashable
      
        # Conferencing properties for this calendar, for example what types of
        # conferences are allowed.
        # Corresponds to the JSON property `conferenceProperties`
        # @return [Google::Apis::CalendarV3::ConferenceProperties]
        attr_accessor :conference_properties
      
        # Description of the calendar. Optional.
        # Corresponds to the JSON property `description`
        # @return [String]
        attr_accessor :description
      
        # ETag of the resource.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # Identifier of the calendar. To retrieve IDs call the calendarList.list()
        # method.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Type of the resource ("calendar#calendar").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Geographic location of the calendar as free-form text. Optional.
        # Corresponds to the JSON property `location`
        # @return [String]
        attr_accessor :location
      
        # Title of the calendar.
        # Corresponds to the JSON property `summary`
        # @return [String]
        attr_accessor :summary
      
        # The time zone of the calendar. (Formatted as an IANA Time Zone Database name,
        # e.g. "Europe/Zurich".) Optional.
        # Corresponds to the JSON property `timeZone`
        # @return [String]
        attr_accessor :time_zone
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @conference_properties = args[:conference_properties] if args.key?(:conference_properties)
          @description = args[:description] if args.key?(:description)
          @etag = args[:etag] if args.key?(:etag)
          @id = args[:id] if args.key?(:id)
          @kind = args[:kind] if args.key?(:kind)
          @location = args[:location] if args.key?(:location)
          @summary = args[:summary] if args.key?(:summary)
          @time_zone = args[:time_zone] if args.key?(:time_zone)
        end
      end
      
      # 
      class CalendarList
        include Google::Apis::Core::Hashable
      
        # ETag of the collection.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # Calendars that are present on the user's calendar list.
        # Corresponds to the JSON property `items`
        # @return [Array<Google::Apis::CalendarV3::CalendarListEntry>]
        attr_accessor :items
      
        # Type of the collection ("calendar#calendarList").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Token used to access the next page of this result. Omitted if no further
        # results are available, in which case nextSyncToken is provided.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        # Token used at a later point in time to retrieve only the entries that have
        # changed since this result was returned. Omitted if further results are
        # available, in which case nextPageToken is provided.
        # Corresponds to the JSON property `nextSyncToken`
        # @return [String]
        attr_accessor :next_sync_token
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @etag = args[:etag] if args.key?(:etag)
          @items = args[:items] if args.key?(:items)
          @kind = args[:kind] if args.key?(:kind)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
        end
      end
      
      # 
      class CalendarListEntry
        include Google::Apis::Core::Hashable
      
        # The effective access role that the authenticated user has on the calendar.
        # Read-only. Possible values are:
        # - "freeBusyReader" - Provides read access to free/busy information.
        # - "reader" - Provides read access to the calendar. Private events will appear
        # to users with reader access, but event details will be hidden.
        # - "writer" - Provides read and write access to the calendar. Private events
        # will appear to users with writer access, and event details will be visible.
        # - "owner" - Provides ownership of the calendar. This role has all of the
        # permissions of the writer role with the additional ability to see and
        # manipulate ACLs.
        # Corresponds to the JSON property `accessRole`
        # @return [String]
        attr_accessor :access_role
      
        # The main color of the calendar in the hexadecimal format "#0088aa". This
        # property supersedes the index-based colorId property. To set or change this
        # property, you need to specify colorRgbFormat=true in the parameters of the
        # insert, update and patch methods. Optional.
        # Corresponds to the JSON property `backgroundColor`
        # @return [String]
        attr_accessor :background_color
      
        # The color of the calendar. This is an ID referring to an entry in the calendar
        # section of the colors definition (see the colors endpoint). This property is
        # superseded by the backgroundColor and foregroundColor properties and can be
        # ignored when using these properties. Optional.
        # Corresponds to the JSON property `colorId`
        # @return [String]
        attr_accessor :color_id
      
        # Conferencing properties for this calendar, for example what types of
        # conferences are allowed.
        # Corresponds to the JSON property `conferenceProperties`
        # @return [Google::Apis::CalendarV3::ConferenceProperties]
        attr_accessor :conference_properties
      
        # The default reminders that the authenticated user has for this calendar.
        # Corresponds to the JSON property `defaultReminders`
        # @return [Array<Google::Apis::CalendarV3::EventReminder>]
        attr_accessor :default_reminders
      
        # Whether this calendar list entry has been deleted from the calendar list. Read-
        # only. Optional. The default is False.
        # Corresponds to the JSON property `deleted`
        # @return [Boolean]
        attr_accessor :deleted
        alias_method :deleted?, :deleted
      
        # Description of the calendar. Optional. Read-only.
        # Corresponds to the JSON property `description`
        # @return [String]
        attr_accessor :description
      
        # ETag of the resource.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # The foreground color of the calendar in the hexadecimal format "#ffffff". This
        # property supersedes the index-based colorId property. To set or change this
        # property, you need to specify colorRgbFormat=true in the parameters of the
        # insert, update and patch methods. Optional.
        # Corresponds to the JSON property `foregroundColor`
        # @return [String]
        attr_accessor :foreground_color
      
        # Whether the calendar has been hidden from the list. Optional. The attribute is
        # only returned when the calendar is hidden, in which case the value is true.
        # Corresponds to the JSON property `hidden`
        # @return [Boolean]
        attr_accessor :hidden
        alias_method :hidden?, :hidden
      
        # Identifier of the calendar.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Type of the resource ("calendar#calendarListEntry").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Geographic location of the calendar as free-form text. Optional. Read-only.
        # Corresponds to the JSON property `location`
        # @return [String]
        attr_accessor :location
      
        # The notifications that the authenticated user is receiving for this calendar.
        # Corresponds to the JSON property `notificationSettings`
        # @return [Google::Apis::CalendarV3::CalendarListEntry::NotificationSettings]
        attr_accessor :notification_settings
      
        # Whether the calendar is the primary calendar of the authenticated user. Read-
        # only. Optional. The default is False.
        # Corresponds to the JSON property `primary`
        # @return [Boolean]
        attr_accessor :primary
        alias_method :primary?, :primary
      
        # Whether the calendar content shows up in the calendar UI. Optional. The
        # default is False.
        # Corresponds to the JSON property `selected`
        # @return [Boolean]
        attr_accessor :selected
        alias_method :selected?, :selected
      
        # Title of the calendar. Read-only.
        # Corresponds to the JSON property `summary`
        # @return [String]
        attr_accessor :summary
      
        # The summary that the authenticated user has set for this calendar. Optional.
        # Corresponds to the JSON property `summaryOverride`
        # @return [String]
        attr_accessor :summary_override
      
        # The time zone of the calendar. Optional. Read-only.
        # Corresponds to the JSON property `timeZone`
        # @return [String]
        attr_accessor :time_zone
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @access_role = args[:access_role] if args.key?(:access_role)
          @background_color = args[:background_color] if args.key?(:background_color)
          @color_id = args[:color_id] if args.key?(:color_id)
          @conference_properties = args[:conference_properties] if args.key?(:conference_properties)
          @default_reminders = args[:default_reminders] if args.key?(:default_reminders)
          @deleted = args[:deleted] if args.key?(:deleted)
          @description = args[:description] if args.key?(:description)
          @etag = args[:etag] if args.key?(:etag)
          @foreground_color = args[:foreground_color] if args.key?(:foreground_color)
          @hidden = args[:hidden] if args.key?(:hidden)
          @id = args[:id] if args.key?(:id)
          @kind = args[:kind] if args.key?(:kind)
          @location = args[:location] if args.key?(:location)
          @notification_settings = args[:notification_settings] if args.key?(:notification_settings)
          @primary = args[:primary] if args.key?(:primary)
          @selected = args[:selected] if args.key?(:selected)
          @summary = args[:summary] if args.key?(:summary)
          @summary_override = args[:summary_override] if args.key?(:summary_override)
          @time_zone = args[:time_zone] if args.key?(:time_zone)
        end
        
        # The notifications that the authenticated user is receiving for this calendar.
        class NotificationSettings
          include Google::Apis::Core::Hashable
        
          # The list of notifications set for this calendar.
          # Corresponds to the JSON property `notifications`
          # @return [Array<Google::Apis::CalendarV3::CalendarNotification>]
          attr_accessor :notifications
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @notifications = args[:notifications] if args.key?(:notifications)
          end
        end
      end
      
      # 
      class CalendarNotification
        include Google::Apis::Core::Hashable
      
        # The method used to deliver the notification. The possible value is:
        # - "email" - Notifications are sent via email.
        # Required when adding a notification.
        # Corresponds to the JSON property `method`
        # @return [String]
        attr_accessor :delivery_method
      
        # The type of notification. Possible values are:
        # - "eventCreation" - Notification sent when a new event is put on the calendar.
        # - "eventChange" - Notification sent when an event is changed.
        # - "eventCancellation" - Notification sent when an event is cancelled.
        # - "eventResponse" - Notification sent when an attendee responds to the event
        # invitation.
        # - "agenda" - An agenda with the events of the day (sent out in the morning).
        # Required when adding a notification.
        # Corresponds to the JSON property `type`
        # @return [String]
        attr_accessor :type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @delivery_method = args[:delivery_method] if args.key?(:delivery_method)
          @type = args[:type] if args.key?(:type)
        end
      end
      
      # 
      class Channel
        include Google::Apis::Core::Hashable
      
        # The address where notifications are delivered for this channel.
        # Corresponds to the JSON property `address`
        # @return [String]
        attr_accessor :address
      
        # Date and time of notification channel expiration, expressed as a Unix
        # timestamp, in milliseconds. Optional.
        # Corresponds to the JSON property `expiration`
        # @return [Fixnum]
        attr_accessor :expiration
      
        # A UUID or similar unique string that identifies this channel.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Identifies this as a notification channel used to watch for changes to a
        # resource, which is "api#channel".
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Additional parameters controlling delivery channel behavior. Optional.
        # Corresponds to the JSON property `params`
        # @return [Hash<String,String>]
        attr_accessor :params
      
        # A Boolean value to indicate whether payload is wanted. Optional.
        # Corresponds to the JSON property `payload`
        # @return [Boolean]
        attr_accessor :payload
        alias_method :payload?, :payload
      
        # An opaque ID that identifies the resource being watched on this channel.
        # Stable across different API versions.
        # Corresponds to the JSON property `resourceId`
        # @return [String]
        attr_accessor :resource_id
      
        # A version-specific identifier for the watched resource.
        # Corresponds to the JSON property `resourceUri`
        # @return [String]
        attr_accessor :resource_uri
      
        # An arbitrary string delivered to the target address with each notification
        # delivered over this channel. Optional.
        # Corresponds to the JSON property `token`
        # @return [String]
        attr_accessor :token
      
        # The type of delivery mechanism used for this channel.
        # Corresponds to the JSON property `type`
        # @return [String]
        attr_accessor :type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @address = args[:address] if args.key?(:address)
          @expiration = args[:expiration] if args.key?(:expiration)
          @id = args[:id] if args.key?(:id)
          @kind = args[:kind] if args.key?(:kind)
          @params = args[:params] if args.key?(:params)
          @payload = args[:payload] if args.key?(:payload)
          @resource_id = args[:resource_id] if args.key?(:resource_id)
          @resource_uri = args[:resource_uri] if args.key?(:resource_uri)
          @token = args[:token] if args.key?(:token)
          @type = args[:type] if args.key?(:type)
        end
      end
      
      # 
      class ColorDefinition
        include Google::Apis::Core::Hashable
      
        # The background color associated with this color definition.
        # Corresponds to the JSON property `background`
        # @return [String]
        attr_accessor :background
      
        # The foreground color that can be used to write on top of a background with '
        # background' color.
        # Corresponds to the JSON property `foreground`
        # @return [String]
        attr_accessor :foreground
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background = args[:background] if args.key?(:background)
          @foreground = args[:foreground] if args.key?(:foreground)
        end
      end
      
      # 
      class Colors
        include Google::Apis::Core::Hashable
      
        # A global palette of calendar colors, mapping from the color ID to its
        # definition. A calendarListEntry resource refers to one of these color IDs in
        # its color field. Read-only.
        # Corresponds to the JSON property `calendar`
        # @return [Hash<String,Google::Apis::CalendarV3::ColorDefinition>]
        attr_accessor :calendar
      
        # A global palette of event colors, mapping from the color ID to its definition.
        # An event resource may refer to one of these color IDs in its color field. Read-
        # only.
        # Corresponds to the JSON property `event`
        # @return [Hash<String,Google::Apis::CalendarV3::ColorDefinition>]
        attr_accessor :event
      
        # Type of the resource ("calendar#colors").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Last modification time of the color palette (as a RFC3339 timestamp). Read-
        # only.
        # Corresponds to the JSON property `updated`
        # @return [DateTime]
        attr_accessor :updated
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @calendar = args[:calendar] if args.key?(:calendar)
          @event = args[:event] if args.key?(:event)
          @kind = args[:kind] if args.key?(:kind)
          @updated = args[:updated] if args.key?(:updated)
        end
      end
      
      # 
      class ConferenceData
        include Google::Apis::Core::Hashable
      
        # The ID of the conference.
        # Can be used by developers to keep track of conferences, should not be
        # displayed to users.
        # Values for solution types:
        # - "eventHangout": unset.
        # - "eventNamedHangout": the name of the Hangout.
        # - "hangoutsMeet": the 10-letter meeting code, for example "aaa-bbbb-ccc".
        # - "addOn": defined by 3P conference provider.  Optional.
        # Corresponds to the JSON property `conferenceId`
        # @return [String]
        attr_accessor :conference_id
      
        # The conference solution, such as Hangouts or Google Meet.
        # Unset for a conference with a failed create request.
        # Either conferenceSolution and at least one entryPoint, or createRequest is
        # required.
        # Corresponds to the JSON property `conferenceSolution`
        # @return [Google::Apis::CalendarV3::ConferenceSolution]
        attr_accessor :conference_solution
      
        # A request to generate a new conference and attach it to the event. The data is
        # generated asynchronously. To see whether the data is present check the status
        # field.
        # Either conferenceSolution and at least one entryPoint, or createRequest is
        # required.
        # Corresponds to the JSON property `createRequest`
        # @return [Google::Apis::CalendarV3::CreateConferenceRequest]
        attr_accessor :create_request
      
        # Information about individual conference entry points, such as URLs or phone
        # numbers.
        # All of them must belong to the same conference.
        # Either conferenceSolution and at least one entryPoint, or createRequest is
        # required.
        # Corresponds to the JSON property `entryPoints`
        # @return [Array<Google::Apis::CalendarV3::EntryPoint>]
        attr_accessor :entry_points
      
        # Additional notes (such as instructions from the domain administrator, legal
        # notices) to display to the user. Can contain HTML. The maximum length is 2048
        # characters. Optional.
        # Corresponds to the JSON property `notes`
        # @return [String]
        attr_accessor :notes
      
        # Additional properties related to a conference. An example would be a solution-
        # specific setting for enabling video streaming.
        # Corresponds to the JSON property `parameters`
        # @return [Google::Apis::CalendarV3::ConferenceParameters]
        attr_accessor :parameters
      
        # The signature of the conference data.
        # Generated on server side. Must be preserved while copying the conference data
        # between events, otherwise the conference data will not be copied.
        # Unset for a conference with a failed create request.
        # Optional for a conference with a pending create request.
        # Corresponds to the JSON property `signature`
        # @return [String]
        attr_accessor :signature
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @conference_id = args[:conference_id] if args.key?(:conference_id)
          @conference_solution = args[:conference_solution] if args.key?(:conference_solution)
          @create_request = args[:create_request] if args.key?(:create_request)
          @entry_points = args[:entry_points] if args.key?(:entry_points)
          @notes = args[:notes] if args.key?(:notes)
          @parameters = args[:parameters] if args.key?(:parameters)
          @signature = args[:signature] if args.key?(:signature)
        end
      end
      
      # 
      class ConferenceParameters
        include Google::Apis::Core::Hashable
      
        # Additional add-on specific data.
        # Corresponds to the JSON property `addOnParameters`
        # @return [Google::Apis::CalendarV3::ConferenceParametersAddOnParameters]
        attr_accessor :add_on_parameters
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @add_on_parameters = args[:add_on_parameters] if args.key?(:add_on_parameters)
        end
      end
      
      # 
      class ConferenceParametersAddOnParameters
        include Google::Apis::Core::Hashable
      
        # 
        # Corresponds to the JSON property `parameters`
        # @return [Hash<String,String>]
        attr_accessor :parameters
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @parameters = args[:parameters] if args.key?(:parameters)
        end
      end
      
      # 
      class ConferenceProperties
        include Google::Apis::Core::Hashable
      
        # The types of conference solutions that are supported for this calendar.
        # The possible values are:
        # - "eventHangout"
        # - "eventNamedHangout"
        # - "hangoutsMeet"  Optional.
        # Corresponds to the JSON property `allowedConferenceSolutionTypes`
        # @return [Array<String>]
        attr_accessor :allowed_conference_solution_types
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @allowed_conference_solution_types = args[:allowed_conference_solution_types] if args.key?(:allowed_conference_solution_types)
        end
      end
      
      # 
      class ConferenceRequestStatus
        include Google::Apis::Core::Hashable
      
        # The current status of the conference create request. Read-only.
        # The possible values are:
        # - "pending": the conference create request is still being processed.
        # - "success": the conference create request succeeded, the entry points are
        # populated.
        # - "failure": the conference create request failed, there are no entry points.
        # Corresponds to the JSON property `statusCode`
        # @return [String]
        attr_accessor :status_code
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @status_code = args[:status_code] if args.key?(:status_code)
        end
      end
      
      # 
      class ConferenceSolution
        include Google::Apis::Core::Hashable
      
        # The user-visible icon for this solution.
        # Corresponds to the JSON property `iconUri`
        # @return [String]
        attr_accessor :icon_uri
      
        # The key which can uniquely identify the conference solution for this event.
        # Corresponds to the JSON property `key`
        # @return [Google::Apis::CalendarV3::ConferenceSolutionKey]
        attr_accessor :key
      
        # The user-visible name of this solution. Not localized.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @icon_uri = args[:icon_uri] if args.key?(:icon_uri)
          @key = args[:key] if args.key?(:key)
          @name = args[:name] if args.key?(:name)
        end
      end
      
      # 
      class ConferenceSolutionKey
        include Google::Apis::Core::Hashable
      
        # The conference solution type.
        # If a client encounters an unfamiliar or empty type, it should still be able to
        # display the entry points. However, it should disallow modifications.
        # The possible values are:
        # - "eventHangout" for Hangouts for consumers (http://hangouts.google.com)
        # - "eventNamedHangout" for classic Hangouts for G Suite users (http://hangouts.
        # google.com)
        # - "hangoutsMeet" for Google Meet (http://meet.google.com)
        # - "addOn" for 3P conference providers
        # Corresponds to the JSON property `type`
        # @return [String]
        attr_accessor :type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @type = args[:type] if args.key?(:type)
        end
      end
      
      # 
      class CreateConferenceRequest
        include Google::Apis::Core::Hashable
      
        # The conference solution, such as Hangouts or Google Meet.
        # Corresponds to the JSON property `conferenceSolutionKey`
        # @return [Google::Apis::CalendarV3::ConferenceSolutionKey]
        attr_accessor :conference_solution_key
      
        # The client-generated unique ID for this request.
        # Clients should regenerate this ID for every new request. If an ID provided is
        # the same as for the previous request, the request is ignored.
        # Corresponds to the JSON property `requestId`
        # @return [String]
        attr_accessor :request_id
      
        # The status of the conference create request.
        # Corresponds to the JSON property `status`
        # @return [Google::Apis::CalendarV3::ConferenceRequestStatus]
        attr_accessor :status
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @conference_solution_key = args[:conference_solution_key] if args.key?(:conference_solution_key)
          @request_id = args[:request_id] if args.key?(:request_id)
          @status = args[:status] if args.key?(:status)
        end
      end
      
      # 
      class EntryPoint
        include Google::Apis::Core::Hashable
      
        # The access code to access the conference. The maximum length is 128 characters.
        # When creating new conference data, populate only the subset of `meetingCode,
        # accessCode, passcode, password, pin` fields that match the terminology that
        # the conference provider uses. Only the populated fields should be displayed.
        # Optional.
        # Corresponds to the JSON property `accessCode`
        # @return [String]
        attr_accessor :access_code
      
        # Features of the entry point, such as being toll or toll-free. One entry point
        # can have multiple features. However, toll and toll-free cannot be both set on
        # the same entry point.
        # Corresponds to the JSON property `entryPointFeatures`
        # @return [Array<String>]
        attr_accessor :entry_point_features
      
        # The type of the conference entry point.
        # Possible values are:
        # - "video" - joining a conference over HTTP. A conference can have zero or one
        # video entry point.
        # - "phone" - joining a conference by dialing a phone number. A conference can
        # have zero or more phone entry points.
        # - "sip" - joining a conference over SIP. A conference can have zero or one sip
        # entry point.
        # - "more" - further conference joining instructions, for example additional
        # phone numbers. A conference can have zero or one more entry point. A
        # conference with only a more entry point is not a valid conference.
        # Corresponds to the JSON property `entryPointType`
        # @return [String]
        attr_accessor :entry_point_type
      
        # The label for the URI. Visible to end users. Not localized. The maximum length
        # is 512 characters.
        # Examples:
        # - for video: meet.google.com/aaa-bbbb-ccc
        # - for phone: +1 123 268 2601
        # - for sip: 12345678@altostrat.com
        # - for more: should not be filled
        # Optional.
        # Corresponds to the JSON property `label`
        # @return [String]
        attr_accessor :label
      
        # The meeting code to access the conference. The maximum length is 128
        # characters.
        # When creating new conference data, populate only the subset of `meetingCode,
        # accessCode, passcode, password, pin` fields that match the terminology that
        # the conference provider uses. Only the populated fields should be displayed.
        # Optional.
        # Corresponds to the JSON property `meetingCode`
        # @return [String]
        attr_accessor :meeting_code
      
        # The passcode to access the conference. The maximum length is 128 characters.
        # When creating new conference data, populate only the subset of `meetingCode,
        # accessCode, passcode, password, pin` fields that match the terminology that
        # the conference provider uses. Only the populated fields should be displayed.
        # Corresponds to the JSON property `passcode`
        # @return [String]
        attr_accessor :passcode
      
        # The password to access the conference. The maximum length is 128 characters.
        # When creating new conference data, populate only the subset of `meetingCode,
        # accessCode, passcode, password, pin` fields that match the terminology that
        # the conference provider uses. Only the populated fields should be displayed.
        # Optional.
        # Corresponds to the JSON property `password`
        # @return [String]
        attr_accessor :password
      
        # The PIN to access the conference. The maximum length is 128 characters.
        # When creating new conference data, populate only the subset of `meetingCode,
        # accessCode, passcode, password, pin` fields that match the terminology that
        # the conference provider uses. Only the populated fields should be displayed.
        # Optional.
        # Corresponds to the JSON property `pin`
        # @return [String]
        attr_accessor :pin
      
        # The CLDR/ISO 3166 region code for the country associated with this phone
        # access. Example: "SE" for Sweden.
        # Calendar backend will populate this field only for EntryPointType.PHONE.
        # Corresponds to the JSON property `regionCode`
        # @return [String]
        attr_accessor :region_code
      
        # The URI of the entry point. The maximum length is 1300 characters.
        # Format:
        # - for video, http: or https: schema is required.
        # - for phone, tel: schema is required. The URI should include the entire dial
        # sequence (e.g., tel:+12345678900,,,123456789;1234).
        # - for sip, sip: schema is required, e.g., sip:12345678@myprovider.com.
        # - for more, http: or https: schema is required.
        # Corresponds to the JSON property `uri`
        # @return [String]
        attr_accessor :uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @access_code = args[:access_code] if args.key?(:access_code)
          @entry_point_features = args[:entry_point_features] if args.key?(:entry_point_features)
          @entry_point_type = args[:entry_point_type] if args.key?(:entry_point_type)
          @label = args[:label] if args.key?(:label)
          @meeting_code = args[:meeting_code] if args.key?(:meeting_code)
          @passcode = args[:passcode] if args.key?(:passcode)
          @password = args[:password] if args.key?(:password)
          @pin = args[:pin] if args.key?(:pin)
          @region_code = args[:region_code] if args.key?(:region_code)
          @uri = args[:uri] if args.key?(:uri)
        end
      end
      
      # 
      class Error
        include Google::Apis::Core::Hashable
      
        # Domain, or broad category, of the error.
        # Corresponds to the JSON property `domain`
        # @return [String]
        attr_accessor :domain
      
        # Specific reason for the error. Some of the possible values are:
        # - "groupTooBig" - The group of users requested is too large for a single query.
        # 
        # - "tooManyCalendarsRequested" - The number of calendars requested is too large
        # for a single query.
        # - "notFound" - The requested resource was not found.
        # - "internalError" - The API service has encountered an internal error.
        # Additional error types may be added in the future, so clients should
        # gracefully handle additional error statuses not included in this list.
        # Corresponds to the JSON property `reason`
        # @return [String]
        attr_accessor :reason
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @domain = args[:domain] if args.key?(:domain)
          @reason = args[:reason] if args.key?(:reason)
        end
      end
      
      # 
      class Event
        include Google::Apis::Core::Hashable
      
        # Whether anyone can invite themselves to the event (currently works for Google+
        # events only). Optional. The default is False.
        # Corresponds to the JSON property `anyoneCanAddSelf`
        # @return [Boolean]
        attr_accessor :anyone_can_add_self
        alias_method :anyone_can_add_self?, :anyone_can_add_self
      
        # File attachments for the event. Currently only Google Drive attachments are
        # supported.
        # In order to modify attachments the supportsAttachments request parameter
        # should be set to true.
        # There can be at most 25 attachments per event,
        # Corresponds to the JSON property `attachments`
        # @return [Array<Google::Apis::CalendarV3::EventAttachment>]
        attr_accessor :attachments
      
        # The attendees of the event. See the Events with attendees guide for more
        # information on scheduling events with other calendar users. Service accounts
        # need to use domain-wide delegation of authority to populate the attendee list.
        # Corresponds to the JSON property `attendees`
        # @return [Array<Google::Apis::CalendarV3::EventAttendee>]
        attr_accessor :attendees
      
        # Whether attendees may have been omitted from the event's representation. When
        # retrieving an event, this may be due to a restriction specified by the
        # maxAttendee query parameter. When updating an event, this can be used to only
        # update the participant's response. Optional. The default is False.
        # Corresponds to the JSON property `attendeesOmitted`
        # @return [Boolean]
        attr_accessor :attendees_omitted
        alias_method :attendees_omitted?, :attendees_omitted
      
        # The color of the event. This is an ID referring to an entry in the event
        # section of the colors definition (see the  colors endpoint). Optional.
        # Corresponds to the JSON property `colorId`
        # @return [String]
        attr_accessor :color_id
      
        # The conference-related information, such as details of a Google Meet
        # conference. To create new conference details use the createRequest field. To
        # persist your changes, remember to set the conferenceDataVersion request
        # parameter to 1 for all event modification requests.
        # Corresponds to the JSON property `conferenceData`
        # @return [Google::Apis::CalendarV3::ConferenceData]
        attr_accessor :conference_data
      
        # Creation time of the event (as a RFC3339 timestamp). Read-only.
        # Corresponds to the JSON property `created`
        # @return [DateTime]
        attr_accessor :created
      
        # The creator of the event. Read-only.
        # Corresponds to the JSON property `creator`
        # @return [Google::Apis::CalendarV3::Event::Creator]
        attr_accessor :creator
      
        # Description of the event. Can contain HTML. Optional.
        # Corresponds to the JSON property `description`
        # @return [String]
        attr_accessor :description
      
        # The (exclusive) end time of the event. For a recurring event, this is the end
        # time of the first instance.
        # Corresponds to the JSON property `end`
        # @return [Google::Apis::CalendarV3::EventDateTime]
        attr_accessor :end
      
        # Whether the end time is actually unspecified. An end time is still provided
        # for compatibility reasons, even if this attribute is set to True. The default
        # is False.
        # Corresponds to the JSON property `endTimeUnspecified`
        # @return [Boolean]
        attr_accessor :end_time_unspecified
        alias_method :end_time_unspecified?, :end_time_unspecified
      
        # ETag of the resource.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # Extended properties of the event.
        # Corresponds to the JSON property `extendedProperties`
        # @return [Google::Apis::CalendarV3::Event::ExtendedProperties]
        attr_accessor :extended_properties
      
        # A gadget that extends this event. Gadgets are deprecated; this structure is
        # instead only used for returning birthday calendar metadata.
        # Corresponds to the JSON property `gadget`
        # @return [Google::Apis::CalendarV3::Event::Gadget]
        attr_accessor :gadget
      
        # Whether attendees other than the organizer can invite others to the event.
        # Optional. The default is True.
        # Corresponds to the JSON property `guestsCanInviteOthers`
        # @return [Boolean]
        attr_accessor :guests_can_invite_others
        alias_method :guests_can_invite_others?, :guests_can_invite_others
      
        # Whether attendees other than the organizer can modify the event. Optional. The
        # default is False.
        # Corresponds to the JSON property `guestsCanModify`
        # @return [Boolean]
        attr_accessor :guests_can_modify
        alias_method :guests_can_modify?, :guests_can_modify
      
        # Whether attendees other than the organizer can see who the event's attendees
        # are. Optional. The default is True.
        # Corresponds to the JSON property `guestsCanSeeOtherGuests`
        # @return [Boolean]
        attr_accessor :guests_can_see_other_guests
        alias_method :guests_can_see_other_guests?, :guests_can_see_other_guests
      
        # An absolute link to the Google+ hangout associated with this event. Read-only.
        # Corresponds to the JSON property `hangoutLink`
        # @return [String]
        attr_accessor :hangout_link
      
        # An absolute link to this event in the Google Calendar Web UI. Read-only.
        # Corresponds to the JSON property `htmlLink`
        # @return [String]
        attr_accessor :html_link
      
        # Event unique identifier as defined in RFC5545. It is used to uniquely identify
        # events accross calendaring systems and must be supplied when importing events
        # via the import method.
        # Note that the icalUID and the id are not identical and only one of them should
        # be supplied at event creation time. One difference in their semantics is that
        # in recurring events, all occurrences of one event have different ids while
        # they all share the same icalUIDs.
        # Corresponds to the JSON property `iCalUID`
        # @return [String]
        attr_accessor :i_cal_uid
      
        # Opaque identifier of the event. When creating new single or recurring events,
        # you can specify their IDs. Provided IDs must follow these rules:
        # - characters allowed in the ID are those used in base32hex encoding, i.e.
        # lowercase letters a-v and digits 0-9, see section 3.1.2 in RFC2938
        # - the length of the ID must be between 5 and 1024 characters
        # - the ID must be unique per calendar  Due to the globally distributed nature
        # of the system, we cannot guarantee that ID collisions will be detected at
        # event creation time. To minimize the risk of collisions we recommend using an
        # established UUID algorithm such as one described in RFC4122.
        # If you do not specify an ID, it will be automatically generated by the server.
        # Note that the icalUID and the id are not identical and only one of them should
        # be supplied at event creation time. One difference in their semantics is that
        # in recurring events, all occurrences of one event have different ids while
        # they all share the same icalUIDs.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Type of the resource ("calendar#event").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Geographic location of the event as free-form text. Optional.
        # Corresponds to the JSON property `location`
        # @return [String]
        attr_accessor :location
      
        # Whether this is a locked event copy where no changes can be made to the main
        # event fields "summary", "description", "location", "start", "end" or "
        # recurrence". The default is False. Read-Only.
        # Corresponds to the JSON property `locked`
        # @return [Boolean]
        attr_accessor :locked
        alias_method :locked?, :locked
      
        # The organizer of the event. If the organizer is also an attendee, this is
        # indicated with a separate entry in attendees with the organizer field set to
        # True. To change the organizer, use the move operation. Read-only, except when
        # importing an event.
        # Corresponds to the JSON property `organizer`
        # @return [Google::Apis::CalendarV3::Event::Organizer]
        attr_accessor :organizer
      
        # For an instance of a recurring event, this is the time at which this event
        # would start according to the recurrence data in the recurring event identified
        # by recurringEventId. It uniquely identifies the instance within the recurring
        # event series even if the instance was moved to a different time. Immutable.
        # Corresponds to the JSON property `originalStartTime`
        # @return [Google::Apis::CalendarV3::EventDateTime]
        attr_accessor :original_start_time
      
        # If set to True, Event propagation is disabled. Note that it is not the same
        # thing as Private event properties. Optional. Immutable. The default is False.
        # Corresponds to the JSON property `privateCopy`
        # @return [Boolean]
        attr_accessor :private_copy
        alias_method :private_copy?, :private_copy
      
        # List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as
        # specified in RFC5545. Note that DTSTART and DTEND lines are not allowed in
        # this field; event start and end times are specified in the start and end
        # fields. This field is omitted for single events or instances of recurring
        # events.
        # Corresponds to the JSON property `recurrence`
        # @return [Array<String>]
        attr_accessor :recurrence
      
        # For an instance of a recurring event, this is the id of the recurring event to
        # which this instance belongs. Immutable.
        # Corresponds to the JSON property `recurringEventId`
        # @return [String]
        attr_accessor :recurring_event_id
      
        # Information about the event's reminders for the authenticated user.
        # Corresponds to the JSON property `reminders`
        # @return [Google::Apis::CalendarV3::Event::Reminders]
        attr_accessor :reminders
      
        # Sequence number as per iCalendar.
        # Corresponds to the JSON property `sequence`
        # @return [Fixnum]
        attr_accessor :sequence
      
        # Source from which the event was created. For example, a web page, an email
        # message or any document identifiable by an URL with HTTP or HTTPS scheme. Can
        # only be seen or modified by the creator of the event.
        # Corresponds to the JSON property `source`
        # @return [Google::Apis::CalendarV3::Event::Source]
        attr_accessor :source
      
        # The (inclusive) start time of the event. For a recurring event, this is the
        # start time of the first instance.
        # Corresponds to the JSON property `start`
        # @return [Google::Apis::CalendarV3::EventDateTime]
        attr_accessor :start
      
        # Status of the event. Optional. Possible values are:
        # - "confirmed" - The event is confirmed. This is the default status.
        # - "tentative" - The event is tentatively confirmed.
        # - "cancelled" - The event is cancelled (deleted). The list method returns
        # cancelled events only on incremental sync (when syncToken or updatedMin are
        # specified) or if the showDeleted flag is set to true. The get method always
        # returns them.
        # A cancelled status represents two different states depending on the event type:
        # 
        # - Cancelled exceptions of an uncancelled recurring event indicate that this
        # instance should no longer be presented to the user. Clients should store these
        # events for the lifetime of the parent recurring event.
        # Cancelled exceptions are only guaranteed to have values for the id,
        # recurringEventId and originalStartTime fields populated. The other fields
        # might be empty.
        # - All other cancelled events represent deleted events. Clients should remove
        # their locally synced copies. Such cancelled events will eventually disappear,
        # so do not rely on them being available indefinitely.
        # Deleted events are only guaranteed to have the id field populated.   On the
        # organizer's calendar, cancelled events continue to expose event details (
        # summary, location, etc.) so that they can be restored (undeleted). Similarly,
        # the events to which the user was invited and that they manually removed
        # continue to provide details. However, incremental sync requests with
        # showDeleted set to false will not return these details.
        # If an event changes its organizer (for example via the move operation) and the
        # original organizer is not on the attendee list, it will leave behind a
        # cancelled event where only the id field is guaranteed to be populated.
        # Corresponds to the JSON property `status`
        # @return [String]
        attr_accessor :status
      
        # Title of the event.
        # Corresponds to the JSON property `summary`
        # @return [String]
        attr_accessor :summary
      
        # Whether the event blocks time on the calendar. Optional. Possible values are:
        # - "opaque" - Default value. The event does block time on the calendar. This is
        # equivalent to setting Show me as to Busy in the Calendar UI.
        # - "transparent" - The event does not block time on the calendar. This is
        # equivalent to setting Show me as to Available in the Calendar UI.
        # Corresponds to the JSON property `transparency`
        # @return [String]
        attr_accessor :transparency
      
        # Last modification time of the event (as a RFC3339 timestamp). Read-only.
        # Corresponds to the JSON property `updated`
        # @return [DateTime]
        attr_accessor :updated
      
        # Visibility of the event. Optional. Possible values are:
        # - "default" - Uses the default visibility for events on the calendar. This is
        # the default value.
        # - "public" - The event is public and event details are visible to all readers
        # of the calendar.
        # - "private" - The event is private and only event attendees may view event
        # details.
        # - "confidential" - The event is private. This value is provided for
        # compatibility reasons.
        # Corresponds to the JSON property `visibility`
        # @return [String]
        attr_accessor :visibility
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @anyone_can_add_self = args[:anyone_can_add_self] if args.key?(:anyone_can_add_self)
          @attachments = args[:attachments] if args.key?(:attachments)
          @attendees = args[:attendees] if args.key?(:attendees)
          @attendees_omitted = args[:attendees_omitted] if args.key?(:attendees_omitted)
          @color_id = args[:color_id] if args.key?(:color_id)
          @conference_data = args[:conference_data] if args.key?(:conference_data)
          @created = args[:created] if args.key?(:created)
          @creator = args[:creator] if args.key?(:creator)
          @description = args[:description] if args.key?(:description)
          @end = args[:end] if args.key?(:end)
          @end_time_unspecified = args[:end_time_unspecified] if args.key?(:end_time_unspecified)
          @etag = args[:etag] if args.key?(:etag)
          @extended_properties = args[:extended_properties] if args.key?(:extended_properties)
          @gadget = args[:gadget] if args.key?(:gadget)
          @guests_can_invite_others = args[:guests_can_invite_others] if args.key?(:guests_can_invite_others)
          @guests_can_modify = args[:guests_can_modify] if args.key?(:guests_can_modify)
          @guests_can_see_other_guests = args[:guests_can_see_other_guests] if args.key?(:guests_can_see_other_guests)
          @hangout_link = args[:hangout_link] if args.key?(:hangout_link)
          @html_link = args[:html_link] if args.key?(:html_link)
          @i_cal_uid = args[:i_cal_uid] if args.key?(:i_cal_uid)
          @id = args[:id] if args.key?(:id)
          @kind = args[:kind] if args.key?(:kind)
          @location = args[:location] if args.key?(:location)
          @locked = args[:locked] if args.key?(:locked)
          @organizer = args[:organizer] if args.key?(:organizer)
          @original_start_time = args[:original_start_time] if args.key?(:original_start_time)
          @private_copy = args[:private_copy] if args.key?(:private_copy)
          @recurrence = args[:recurrence] if args.key?(:recurrence)
          @recurring_event_id = args[:recurring_event_id] if args.key?(:recurring_event_id)
          @reminders = args[:reminders] if args.key?(:reminders)
          @sequence = args[:sequence] if args.key?(:sequence)
          @source = args[:source] if args.key?(:source)
          @start = args[:start] if args.key?(:start)
          @status = args[:status] if args.key?(:status)
          @summary = args[:summary] if args.key?(:summary)
          @transparency = args[:transparency] if args.key?(:transparency)
          @updated = args[:updated] if args.key?(:updated)
          @visibility = args[:visibility] if args.key?(:visibility)
        end
        
        # The creator of the event. Read-only.
        class Creator
          include Google::Apis::Core::Hashable
        
          # The creator's name, if available.
          # Corresponds to the JSON property `displayName`
          # @return [String]
          attr_accessor :display_name
        
          # The creator's email address, if available.
          # Corresponds to the JSON property `email`
          # @return [String]
          attr_accessor :email
        
          # The creator's Profile ID, if available. It corresponds to the id field in the
          # People collection of the Google+ API
          # Corresponds to the JSON property `id`
          # @return [String]
          attr_accessor :id
        
          # Whether the creator corresponds to the calendar on which this copy of the
          # event appears. Read-only. The default is False.
          # Corresponds to the JSON property `self`
          # @return [Boolean]
          attr_accessor :self
          alias_method :self?, :self
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @display_name = args[:display_name] if args.key?(:display_name)
            @email = args[:email] if args.key?(:email)
            @id = args[:id] if args.key?(:id)
            @self = args[:self] if args.key?(:self)
          end
        end
        
        # Extended properties of the event.
        class ExtendedProperties
          include Google::Apis::Core::Hashable
        
          # Properties that are private to the copy of the event that appears on this
          # calendar.
          # Corresponds to the JSON property `private`
          # @return [Hash<String,String>]
          attr_accessor :private
        
          # Properties that are shared between copies of the event on other attendees'
          # calendars.
          # Corresponds to the JSON property `shared`
          # @return [Hash<String,String>]
          attr_accessor :shared
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @private = args[:private] if args.key?(:private)
            @shared = args[:shared] if args.key?(:shared)
          end
        end
        
        # A gadget that extends this event. Gadgets are deprecated; this structure is
        # instead only used for returning birthday calendar metadata.
        class Gadget
          include Google::Apis::Core::Hashable
        
          # The gadget's display mode. Deprecated. Possible values are:
          # - "icon" - The gadget displays next to the event's title in the calendar view.
          # - "chip" - The gadget displays when the event is clicked.
          # Corresponds to the JSON property `display`
          # @return [String]
          attr_accessor :display_mode
        
          # The gadget's height in pixels. The height must be an integer greater than 0.
          # Optional. Deprecated.
          # Corresponds to the JSON property `height`
          # @return [Fixnum]
          attr_accessor :height
        
          # The gadget's icon URL. The URL scheme must be HTTPS. Deprecated.
          # Corresponds to the JSON property `iconLink`
          # @return [String]
          attr_accessor :icon_link
        
          # The gadget's URL. The URL scheme must be HTTPS. Deprecated.
          # Corresponds to the JSON property `link`
          # @return [String]
          attr_accessor :link
        
          # Preferences.
          # Corresponds to the JSON property `preferences`
          # @return [Hash<String,String>]
          attr_accessor :preferences
        
          # The gadget's title. Deprecated.
          # Corresponds to the JSON property `title`
          # @return [String]
          attr_accessor :title
        
          # The gadget's type. Deprecated.
          # Corresponds to the JSON property `type`
          # @return [String]
          attr_accessor :type
        
          # The gadget's width in pixels. The width must be an integer greater than 0.
          # Optional. Deprecated.
          # Corresponds to the JSON property `width`
          # @return [Fixnum]
          attr_accessor :width
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @display_mode = args[:display_mode] if args.key?(:display_mode)
            @height = args[:height] if args.key?(:height)
            @icon_link = args[:icon_link] if args.key?(:icon_link)
            @link = args[:link] if args.key?(:link)
            @preferences = args[:preferences] if args.key?(:preferences)
            @title = args[:title] if args.key?(:title)
            @type = args[:type] if args.key?(:type)
            @width = args[:width] if args.key?(:width)
          end
        end
        
        # The organizer of the event. If the organizer is also an attendee, this is
        # indicated with a separate entry in attendees with the organizer field set to
        # True. To change the organizer, use the move operation. Read-only, except when
        # importing an event.
        class Organizer
          include Google::Apis::Core::Hashable
        
          # The organizer's name, if available.
          # Corresponds to the JSON property `displayName`
          # @return [String]
          attr_accessor :display_name
        
          # The organizer's email address, if available. It must be a valid email address
          # as per RFC5322.
          # Corresponds to the JSON property `email`
          # @return [String]
          attr_accessor :email
        
          # The organizer's Profile ID, if available. It corresponds to the id field in
          # the People collection of the Google+ API
          # Corresponds to the JSON property `id`
          # @return [String]
          attr_accessor :id
        
          # Whether the organizer corresponds to the calendar on which this copy of the
          # event appears. Read-only. The default is False.
          # Corresponds to the JSON property `self`
          # @return [Boolean]
          attr_accessor :self
          alias_method :self?, :self
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @display_name = args[:display_name] if args.key?(:display_name)
            @email = args[:email] if args.key?(:email)
            @id = args[:id] if args.key?(:id)
            @self = args[:self] if args.key?(:self)
          end
        end
        
        # Information about the event's reminders for the authenticated user.
        class Reminders
          include Google::Apis::Core::Hashable
        
          # If the event doesn't use the default reminders, this lists the reminders
          # specific to the event, or, if not set, indicates that no reminders are set for
          # this event. The maximum number of override reminders is 5.
          # Corresponds to the JSON property `overrides`
          # @return [Array<Google::Apis::CalendarV3::EventReminder>]
          attr_accessor :overrides
        
          # Whether the default reminders of the calendar apply to the event.
          # Corresponds to the JSON property `useDefault`
          # @return [Boolean]
          attr_accessor :use_default
          alias_method :use_default?, :use_default
        
          def initialize(**args)
             update!(**args)
          end
        
          # Update properties of this object
          def update!(**args)
            @overrides = args[:overrides] if args.key?(:overrides)
            @use_default = args[:use_default] if args.key?(:use_default)
          end
        end
        
        # Source from which the event was created. For example, a web page, an email
        # message or any document identifiable by an URL with HTTP or HTTPS scheme. Can
        # only be seen or modified by the creator of the event.
        class Source
          include Google::Apis::Core::Hashable
        
          # Title of the source; for example a title of a web page or an email subject.
          # Corresponds to the JSON property `title`
          # @return [String]
          attr_accessor :title
        
          # URL of the source pointing to a resource. The URL scheme must be HTTP or HTTPS.
          # 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)
            @title = args[:title] if args.key?(:title)
            @url = args[:url] if args.key?(:url)
          end
        end
      end
      
      # 
      class EventAttachment
        include Google::Apis::Core::Hashable
      
        # ID of the attached file. Read-only.
        # For Google Drive files, this is the ID of the corresponding Files resource
        # entry in the Drive API.
        # Corresponds to the JSON property `fileId`
        # @return [String]
        attr_accessor :file_id
      
        # URL link to the attachment.
        # For adding Google Drive file attachments use the same format as in
        # alternateLink property of the Files resource in the Drive API.
        # Required when adding an attachment.
        # Corresponds to the JSON property `fileUrl`
        # @return [String]
        attr_accessor :file_url
      
        # URL link to the attachment's icon. Read-only.
        # Corresponds to the JSON property `iconLink`
        # @return [String]
        attr_accessor :icon_link
      
        # Internet media type (MIME type) of the attachment.
        # Corresponds to the JSON property `mimeType`
        # @return [String]
        attr_accessor :mime_type
      
        # Attachment title.
        # Corresponds to the JSON property `title`
        # @return [String]
        attr_accessor :title
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @file_id = args[:file_id] if args.key?(:file_id)
          @file_url = args[:file_url] if args.key?(:file_url)
          @icon_link = args[:icon_link] if args.key?(:icon_link)
          @mime_type = args[:mime_type] if args.key?(:mime_type)
          @title = args[:title] if args.key?(:title)
        end
      end
      
      # 
      class EventAttendee
        include Google::Apis::Core::Hashable
      
        # Number of additional guests. Optional. The default is 0.
        # Corresponds to the JSON property `additionalGuests`
        # @return [Fixnum]
        attr_accessor :additional_guests
      
        # The attendee's response comment. Optional.
        # Corresponds to the JSON property `comment`
        # @return [String]
        attr_accessor :comment
      
        # The attendee's name, if available. Optional.
        # Corresponds to the JSON property `displayName`
        # @return [String]
        attr_accessor :display_name
      
        # The attendee's email address, if available. This field must be present when
        # adding an attendee. It must be a valid email address as per RFC5322.
        # Required when adding an attendee.
        # Corresponds to the JSON property `email`
        # @return [String]
        attr_accessor :email
      
        # The attendee's Profile ID, if available. It corresponds to the id field in the
        # People collection of the Google+ API
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Whether this is an optional attendee. Optional. The default is False.
        # Corresponds to the JSON property `optional`
        # @return [Boolean]
        attr_accessor :optional
        alias_method :optional?, :optional
      
        # Whether the attendee is the organizer of the event. Read-only. The default is
        # False.
        # Corresponds to the JSON property `organizer`
        # @return [Boolean]
        attr_accessor :organizer
        alias_method :organizer?, :organizer
      
        # Whether the attendee is a resource. Can only be set when the attendee is added
        # to the event for the first time. Subsequent modifications are ignored.
        # Optional. The default is False.
        # Corresponds to the JSON property `resource`
        # @return [Boolean]
        attr_accessor :resource
        alias_method :resource?, :resource
      
        # The attendee's response status. Possible values are:
        # - "needsAction" - The attendee has not responded to the invitation.
        # - "declined" - The attendee has declined the invitation.
        # - "tentative" - The attendee has tentatively accepted the invitation.
        # - "accepted" - The attendee has accepted the invitation.
        # Corresponds to the JSON property `responseStatus`
        # @return [String]
        attr_accessor :response_status
      
        # Whether this entry represents the calendar on which this copy of the event
        # appears. Read-only. The default is False.
        # Corresponds to the JSON property `self`
        # @return [Boolean]
        attr_accessor :self
        alias_method :self?, :self
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @additional_guests = args[:additional_guests] if args.key?(:additional_guests)
          @comment = args[:comment] if args.key?(:comment)
          @display_name = args[:display_name] if args.key?(:display_name)
          @email = args[:email] if args.key?(:email)
          @id = args[:id] if args.key?(:id)
          @optional = args[:optional] if args.key?(:optional)
          @organizer = args[:organizer] if args.key?(:organizer)
          @resource = args[:resource] if args.key?(:resource)
          @response_status = args[:response_status] if args.key?(:response_status)
          @self = args[:self] if args.key?(:self)
        end
      end
      
      # 
      class EventDateTime
        include Google::Apis::Core::Hashable
      
        # The date, in the format "yyyy-mm-dd", if this is an all-day event.
        # Corresponds to the JSON property `date`
        # @return [Date]
        attr_accessor :date
      
        # The time, as a combined date-time value (formatted according to RFC3339). A
        # time zone offset is required unless a time zone is explicitly specified in
        # timeZone.
        # Corresponds to the JSON property `dateTime`
        # @return [DateTime]
        attr_accessor :date_time
      
        # The time zone in which the time is specified. (Formatted as an IANA Time Zone
        # Database name, e.g. "Europe/Zurich".) For recurring events this field is
        # required and specifies the time zone in which the recurrence is expanded. For
        # single events this field is optional and indicates a custom time zone for the
        # event start/end.
        # Corresponds to the JSON property `timeZone`
        # @return [String]
        attr_accessor :time_zone
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @date = args[:date] if args.key?(:date)
          @date_time = args[:date_time] if args.key?(:date_time)
          @time_zone = args[:time_zone] if args.key?(:time_zone)
        end
      end
      
      # 
      class EventReminder
        include Google::Apis::Core::Hashable
      
        # The method used by this reminder. Possible values are:
        # - "email" - Reminders are sent via email.
        # - "popup" - Reminders are sent via a UI popup.
        # Required when adding a reminder.
        # Corresponds to the JSON property `method`
        # @return [String]
        attr_accessor :reminder_method
      
        # Number of minutes before the start of the event when the reminder should
        # trigger. Valid values are between 0 and 40320 (4 weeks in minutes).
        # Required when adding a reminder.
        # Corresponds to the JSON property `minutes`
        # @return [Fixnum]
        attr_accessor :minutes
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @reminder_method = args[:reminder_method] if args.key?(:reminder_method)
          @minutes = args[:minutes] if args.key?(:minutes)
        end
      end
      
      # 
      class Events
        include Google::Apis::Core::Hashable
      
        # The user's access role for this calendar. Read-only. Possible values are:
        # - "none" - The user has no access.
        # - "freeBusyReader" - The user has read access to free/busy information.
        # - "reader" - The user has read access to the calendar. Private events will
        # appear to users with reader access, but event details will be hidden.
        # - "writer" - The user has read and write access to the calendar. Private
        # events will appear to users with writer access, and event details will be
        # visible.
        # - "owner" - The user has ownership of the calendar. This role has all of the
        # permissions of the writer role with the additional ability to see and
        # manipulate ACLs.
        # Corresponds to the JSON property `accessRole`
        # @return [String]
        attr_accessor :access_role
      
        # The default reminders on the calendar for the authenticated user. These
        # reminders apply to all events on this calendar that do not explicitly override
        # them (i.e. do not have reminders.useDefault set to True).
        # Corresponds to the JSON property `defaultReminders`
        # @return [Array<Google::Apis::CalendarV3::EventReminder>]
        attr_accessor :default_reminders
      
        # Description of the calendar. Read-only.
        # Corresponds to the JSON property `description`
        # @return [String]
        attr_accessor :description
      
        # ETag of the collection.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # List of events on the calendar.
        # Corresponds to the JSON property `items`
        # @return [Array<Google::Apis::CalendarV3::Event>]
        attr_accessor :items
      
        # Type of the collection ("calendar#events").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Token used to access the next page of this result. Omitted if no further
        # results are available, in which case nextSyncToken is provided.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        # Token used at a later point in time to retrieve only the entries that have
        # changed since this result was returned. Omitted if further results are
        # available, in which case nextPageToken is provided.
        # Corresponds to the JSON property `nextSyncToken`
        # @return [String]
        attr_accessor :next_sync_token
      
        # Title of the calendar. Read-only.
        # Corresponds to the JSON property `summary`
        # @return [String]
        attr_accessor :summary
      
        # The time zone of the calendar. Read-only.
        # Corresponds to the JSON property `timeZone`
        # @return [String]
        attr_accessor :time_zone
      
        # Last modification time of the calendar (as a RFC3339 timestamp). Read-only.
        # Corresponds to the JSON property `updated`
        # @return [DateTime]
        attr_accessor :updated
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @access_role = args[:access_role] if args.key?(:access_role)
          @default_reminders = args[:default_reminders] if args.key?(:default_reminders)
          @description = args[:description] if args.key?(:description)
          @etag = args[:etag] if args.key?(:etag)
          @items = args[:items] if args.key?(:items)
          @kind = args[:kind] if args.key?(:kind)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
          @summary = args[:summary] if args.key?(:summary)
          @time_zone = args[:time_zone] if args.key?(:time_zone)
          @updated = args[:updated] if args.key?(:updated)
        end
      end
      
      # 
      class FreeBusyCalendar
        include Google::Apis::Core::Hashable
      
        # List of time ranges during which this calendar should be regarded as busy.
        # Corresponds to the JSON property `busy`
        # @return [Array<Google::Apis::CalendarV3::TimePeriod>]
        attr_accessor :busy
      
        # Optional error(s) (if computation for the calendar failed).
        # Corresponds to the JSON property `errors`
        # @return [Array<Google::Apis::CalendarV3::Error>]
        attr_accessor :errors
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @busy = args[:busy] if args.key?(:busy)
          @errors = args[:errors] if args.key?(:errors)
        end
      end
      
      # 
      class FreeBusyGroup
        include Google::Apis::Core::Hashable
      
        # List of calendars' identifiers within a group.
        # Corresponds to the JSON property `calendars`
        # @return [Array<String>]
        attr_accessor :calendars
      
        # Optional error(s) (if computation for the group failed).
        # Corresponds to the JSON property `errors`
        # @return [Array<Google::Apis::CalendarV3::Error>]
        attr_accessor :errors
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @calendars = args[:calendars] if args.key?(:calendars)
          @errors = args[:errors] if args.key?(:errors)
        end
      end
      
      # 
      class FreeBusyRequest
        include Google::Apis::Core::Hashable
      
        # Maximal number of calendars for which FreeBusy information is to be provided.
        # Optional. Maximum value is 50.
        # Corresponds to the JSON property `calendarExpansionMax`
        # @return [Fixnum]
        attr_accessor :calendar_expansion_max
      
        # Maximal number of calendar identifiers to be provided for a single group.
        # Optional. An error is returned for a group with more members than this value.
        # Maximum value is 100.
        # Corresponds to the JSON property `groupExpansionMax`
        # @return [Fixnum]
        attr_accessor :group_expansion_max
      
        # List of calendars and/or groups to query.
        # Corresponds to the JSON property `items`
        # @return [Array<Google::Apis::CalendarV3::FreeBusyRequestItem>]
        attr_accessor :items
      
        # The end of the interval for the query formatted as per RFC3339.
        # Corresponds to the JSON property `timeMax`
        # @return [DateTime]
        attr_accessor :time_max
      
        # The start of the interval for the query formatted as per RFC3339.
        # Corresponds to the JSON property `timeMin`
        # @return [DateTime]
        attr_accessor :time_min
      
        # Time zone used in the response. Optional. The default is UTC.
        # Corresponds to the JSON property `timeZone`
        # @return [String]
        attr_accessor :time_zone
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @calendar_expansion_max = args[:calendar_expansion_max] if args.key?(:calendar_expansion_max)
          @group_expansion_max = args[:group_expansion_max] if args.key?(:group_expansion_max)
          @items = args[:items] if args.key?(:items)
          @time_max = args[:time_max] if args.key?(:time_max)
          @time_min = args[:time_min] if args.key?(:time_min)
          @time_zone = args[:time_zone] if args.key?(:time_zone)
        end
      end
      
      # 
      class FreeBusyRequestItem
        include Google::Apis::Core::Hashable
      
        # The identifier of a calendar or a group.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @id = args[:id] if args.key?(:id)
        end
      end
      
      # 
      class FreeBusyResponse
        include Google::Apis::Core::Hashable
      
        # List of free/busy information for calendars.
        # Corresponds to the JSON property `calendars`
        # @return [Hash<String,Google::Apis::CalendarV3::FreeBusyCalendar>]
        attr_accessor :calendars
      
        # Expansion of groups.
        # Corresponds to the JSON property `groups`
        # @return [Hash<String,Google::Apis::CalendarV3::FreeBusyGroup>]
        attr_accessor :groups
      
        # Type of the resource ("calendar#freeBusy").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # The end of the interval.
        # Corresponds to the JSON property `timeMax`
        # @return [DateTime]
        attr_accessor :time_max
      
        # The start of the interval.
        # Corresponds to the JSON property `timeMin`
        # @return [DateTime]
        attr_accessor :time_min
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @calendars = args[:calendars] if args.key?(:calendars)
          @groups = args[:groups] if args.key?(:groups)
          @kind = args[:kind] if args.key?(:kind)
          @time_max = args[:time_max] if args.key?(:time_max)
          @time_min = args[:time_min] if args.key?(:time_min)
        end
      end
      
      # 
      class Setting
        include Google::Apis::Core::Hashable
      
        # ETag of the resource.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # The id of the user setting.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # Type of the resource ("calendar#setting").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Value of the user setting. The format of the value depends on the ID of the
        # setting. It must always be a UTF-8 string of length up to 1024 characters.
        # Corresponds to the JSON property `value`
        # @return [String]
        attr_accessor :value
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @etag = args[:etag] if args.key?(:etag)
          @id = args[:id] if args.key?(:id)
          @kind = args[:kind] if args.key?(:kind)
          @value = args[:value] if args.key?(:value)
        end
      end
      
      # 
      class Settings
        include Google::Apis::Core::Hashable
      
        # Etag of the collection.
        # Corresponds to the JSON property `etag`
        # @return [String]
        attr_accessor :etag
      
        # List of user settings.
        # Corresponds to the JSON property `items`
        # @return [Array<Google::Apis::CalendarV3::Setting>]
        attr_accessor :items
      
        # Type of the collection ("calendar#settings").
        # Corresponds to the JSON property `kind`
        # @return [String]
        attr_accessor :kind
      
        # Token used to access the next page of this result. Omitted if no further
        # results are available, in which case nextSyncToken is provided.
        # Corresponds to the JSON property `nextPageToken`
        # @return [String]
        attr_accessor :next_page_token
      
        # Token used at a later point in time to retrieve only the entries that have
        # changed since this result was returned. Omitted if further results are
        # available, in which case nextPageToken is provided.
        # Corresponds to the JSON property `nextSyncToken`
        # @return [String]
        attr_accessor :next_sync_token
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @etag = args[:etag] if args.key?(:etag)
          @items = args[:items] if args.key?(:items)
          @kind = args[:kind] if args.key?(:kind)
          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
        end
      end
      
      # 
      class TimePeriod
        include Google::Apis::Core::Hashable
      
        # The (exclusive) end of the time period.
        # Corresponds to the JSON property `end`
        # @return [DateTime]
        attr_accessor :end
      
        # The (inclusive) start of the time period.
        # Corresponds to the JSON property `start`
        # @return [DateTime]
        attr_accessor :start
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end = args[:end] if args.key?(:end)
          @start = args[:start] if args.key?(:start)
        end
      end
    end
  end
end