google-calendar-apimatic-sdk 1.0.0

data/lib/calendar_api/models/event.rb

@@ -0,0 +1,551 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+require 'date'
+module CalendarApi
+  # A Google Calendar event resource.
+  class Event < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Type of the resource.
+    # @return [String]
+    attr_accessor :kind
+
+    # ETag of the resource.
+    # @return [String]
+    attr_accessor :etag
+
+    # Opaque identifier of the event. When creating new single or recurring
+    # events, you can specify their IDs. Event IDs must be between 5 and 1024
+    # characters long and consist of lower-case base32hex characters (a-v, 0-9).
+    # @return [String]
+    attr_accessor :id
+
+    # Status of the event.
+    # @return [EventStatus]
+    attr_accessor :status
+
+    # Absolute link to this event in the Google Calendar Web UI.
+    # @return [String]
+    attr_accessor :html_link
+
+    # Creation time of the event (RFC3339).
+    # @return [DateTime]
+    attr_accessor :created
+
+    # Last modification time of the event (RFC3339).
+    # @return [DateTime]
+    attr_accessor :updated
+
+    # Title of the event.
+    # @return [String]
+    attr_accessor :summary
+
+    # Description of the event. Can contain HTML.
+    # @return [String]
+    attr_accessor :description
+
+    # Geographic location of the event as free-form text.
+    # @return [String]
+    attr_accessor :location
+
+    # The color of the event. This is an ID referring to an entry in the event
+    # section of the colors definition.
+    # @return [String]
+    attr_accessor :color_id
+
+    # Identifies a person associated with the event, such as the creator or
+    # organizer.
+    # @return [Person]
+    attr_accessor :creator
+
+    # Identifies a person associated with the event, such as the creator or
+    # organizer.
+    # @return [Person]
+    attr_accessor :organizer
+
+    # A timestamp marking the start or end of an event. For all-day events, use
+    # date; for timed events, use dateTime.
+    # @return [EventDateTime]
+    attr_accessor :start
+
+    # A timestamp marking the start or end of an event. For all-day events, use
+    # date; for timed events, use dateTime.
+    # @return [EventDateTime]
+    attr_accessor :mend
+
+    # Whether the end time is actually unspecified.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :end_time_unspecified
+
+    # List of RRULE, EXRULE, RDATE, and EXDATE lines for a recurring event, as
+    # specified in RFC 5545. This field is omitted for single events or
+    # instances of recurring events.
+    # @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.
+    # @return [String]
+    attr_accessor :recurring_event_id
+
+    # A timestamp marking the start or end of an event. For all-day events, use
+    # date; for timed events, use dateTime.
+    # @return [EventDateTime]
+    attr_accessor :original_start_time
+
+    # Whether the event blocks time on the calendar. "opaque" means the event
+    # does block time; "transparent" means it does not.
+    # @return [EventTransparency]
+    attr_accessor :transparency
+
+    # Visibility of the event.
+    # @return [EventVisibility]
+    attr_accessor :visibility
+
+    # Event unique identifier as defined in RFC 5545.
+    # @return [String]
+    attr_accessor :i_cal_uid
+
+    # Sequence number as per iCalendar.
+    # @return [Integer]
+    attr_accessor :sequence
+
+    # The attendees of the event.
+    # @return [Array[Attendee]]
+    attr_accessor :attendees
+
+    # Whether attendees may have been omitted from the event's representation.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :attendees_omitted
+
+    # An absolute link to the Google Hangout associated with this event
+    # (deprecated in favor of conferenceData).
+    # @return [String]
+    attr_accessor :hangout_link
+
+    # Information about a conference (e.g. Google Meet).
+    # @return [ConferenceData]
+    attr_accessor :conference_data
+
+    # Whether attendees other than the organizer can invite others.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :guests_can_invite_others
+
+    # Whether attendees other than the organizer can modify the event.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :guests_can_modify
+
+    # Whether attendees other than the organizer can see who the event's
+    # attendees are.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :guests_can_see_other_guests
+
+    # If set to true, event propagation is disabled.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :private_copy
+
+    # Whether this is a locked event copy where no changes can be made.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :locked
+
+    # Information about the event's reminders.
+    # @return [EventReminders]
+    attr_accessor :reminders
+
+    # Source from which the event was created — for example, a web page or an
+    # email message.
+    # @return [EventSource]
+    attr_accessor :source
+
+    # The specific type of event.
+    # @return [EventType]
+    attr_accessor :event_type
+
+    # Extended properties of the event.
+    # @return [ExtendedProperties]
+    attr_accessor :extended_properties
+
+    # File attachments for the event. Maximum 25 attachments per event.
+    # @return [Array[Attachment]]
+    attr_accessor :attachments
+
+    # Birthday or special event data. Used if eventType is birthday.
+    # @return [BirthdayProperties]
+    attr_accessor :birthday_properties
+
+    # Out-of-office event data. Used if eventType is outOfOffice.
+    # @return [OutOfOfficeProperties]
+    attr_accessor :out_of_office_properties
+
+    # Focus time event data. Used if eventType is focusTime.
+    # @return [FocusTimeProperties]
+    attr_accessor :focus_time_properties
+
+    # Working location event data. Used if eventType is workingLocation.
+    # @return [WorkingLocationProperties]
+    attr_accessor :working_location_properties
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['kind'] = 'kind'
+      @_hash['etag'] = 'etag'
+      @_hash['id'] = 'id'
+      @_hash['status'] = 'status'
+      @_hash['html_link'] = 'htmlLink'
+      @_hash['created'] = 'created'
+      @_hash['updated'] = 'updated'
+      @_hash['summary'] = 'summary'
+      @_hash['description'] = 'description'
+      @_hash['location'] = 'location'
+      @_hash['color_id'] = 'colorId'
+      @_hash['creator'] = 'creator'
+      @_hash['organizer'] = 'organizer'
+      @_hash['start'] = 'start'
+      @_hash['mend'] = 'end'
+      @_hash['end_time_unspecified'] = 'endTimeUnspecified'
+      @_hash['recurrence'] = 'recurrence'
+      @_hash['recurring_event_id'] = 'recurringEventId'
+      @_hash['original_start_time'] = 'originalStartTime'
+      @_hash['transparency'] = 'transparency'
+      @_hash['visibility'] = 'visibility'
+      @_hash['i_cal_uid'] = 'iCalUID'
+      @_hash['sequence'] = 'sequence'
+      @_hash['attendees'] = 'attendees'
+      @_hash['attendees_omitted'] = 'attendeesOmitted'
+      @_hash['hangout_link'] = 'hangoutLink'
+      @_hash['conference_data'] = 'conferenceData'
+      @_hash['guests_can_invite_others'] = 'guestsCanInviteOthers'
+      @_hash['guests_can_modify'] = 'guestsCanModify'
+      @_hash['guests_can_see_other_guests'] = 'guestsCanSeeOtherGuests'
+      @_hash['private_copy'] = 'privateCopy'
+      @_hash['locked'] = 'locked'
+      @_hash['reminders'] = 'reminders'
+      @_hash['source'] = 'source'
+      @_hash['event_type'] = 'eventType'
+      @_hash['extended_properties'] = 'extendedProperties'
+      @_hash['attachments'] = 'attachments'
+      @_hash['birthday_properties'] = 'birthdayProperties'
+      @_hash['out_of_office_properties'] = 'outOfOfficeProperties'
+      @_hash['focus_time_properties'] = 'focusTimeProperties'
+      @_hash['working_location_properties'] = 'workingLocationProperties'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        kind
+        etag
+        id
+        status
+        html_link
+        created
+        updated
+        summary
+        description
+        location
+        color_id
+        creator
+        organizer
+        end_time_unspecified
+        recurrence
+        recurring_event_id
+        original_start_time
+        transparency
+        visibility
+        i_cal_uid
+        sequence
+        attendees
+        attendees_omitted
+        hangout_link
+        conference_data
+        guests_can_invite_others
+        guests_can_modify
+        guests_can_see_other_guests
+        private_copy
+        locked
+        reminders
+        source
+        event_type
+        extended_properties
+        attachments
+        birthday_properties
+        out_of_office_properties
+        focus_time_properties
+        working_location_properties
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(start:, mend:, kind: 'calendar#event', etag: SKIP, id: SKIP,
+                   status: SKIP, html_link: SKIP, created: SKIP, updated: SKIP,
+                   summary: SKIP, description: SKIP, location: SKIP,
+                   color_id: SKIP, creator: SKIP, organizer: SKIP,
+                   end_time_unspecified: false, recurrence: SKIP,
+                   recurring_event_id: SKIP, original_start_time: SKIP,
+                   transparency: EventTransparency::OPAQUE,
+                   visibility: EventVisibility::DEFAULT, i_cal_uid: SKIP,
+                   sequence: SKIP, attendees: SKIP, attendees_omitted: false,
+                   hangout_link: SKIP, conference_data: SKIP,
+                   guests_can_invite_others: true, guests_can_modify: false,
+                   guests_can_see_other_guests: true, private_copy: false,
+                   locked: false, reminders: SKIP, source: SKIP,
+                   event_type: SKIP, extended_properties: SKIP,
+                   attachments: SKIP, birthday_properties: SKIP,
+                   out_of_office_properties: SKIP, focus_time_properties: SKIP,
+                   working_location_properties: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @kind = kind unless kind == SKIP
+      @etag = etag unless etag == SKIP
+      @id = id unless id == SKIP
+      @status = status unless status == SKIP
+      @html_link = html_link unless html_link == SKIP
+      @created = created unless created == SKIP
+      @updated = updated unless updated == SKIP
+      @summary = summary unless summary == SKIP
+      @description = description unless description == SKIP
+      @location = location unless location == SKIP
+      @color_id = color_id unless color_id == SKIP
+      @creator = creator unless creator == SKIP
+      @organizer = organizer unless organizer == SKIP
+      @start = start
+      @mend = mend
+      @end_time_unspecified = end_time_unspecified unless end_time_unspecified == SKIP
+      @recurrence = recurrence unless recurrence == SKIP
+      @recurring_event_id = recurring_event_id unless recurring_event_id == SKIP
+      @original_start_time = original_start_time unless original_start_time == SKIP
+      @transparency = transparency unless transparency == SKIP
+      @visibility = visibility unless visibility == SKIP
+      @i_cal_uid = i_cal_uid unless i_cal_uid == SKIP
+      @sequence = sequence unless sequence == SKIP
+      @attendees = attendees unless attendees == SKIP
+      @attendees_omitted = attendees_omitted unless attendees_omitted == SKIP
+      @hangout_link = hangout_link unless hangout_link == SKIP
+      @conference_data = conference_data unless conference_data == SKIP
+      @guests_can_invite_others = guests_can_invite_others unless guests_can_invite_others == SKIP
+      @guests_can_modify = guests_can_modify unless guests_can_modify == SKIP
+      unless guests_can_see_other_guests == SKIP
+        @guests_can_see_other_guests =
+          guests_can_see_other_guests
+      end
+      @private_copy = private_copy unless private_copy == SKIP
+      @locked = locked unless locked == SKIP
+      @reminders = reminders unless reminders == SKIP
+      @source = source unless source == SKIP
+      @event_type = event_type unless event_type == SKIP
+      @extended_properties = extended_properties unless extended_properties == SKIP
+      @attachments = attachments unless attachments == SKIP
+      @birthday_properties = birthday_properties unless birthday_properties == SKIP
+      @out_of_office_properties = out_of_office_properties unless out_of_office_properties == SKIP
+      @focus_time_properties = focus_time_properties unless focus_time_properties == SKIP
+      unless working_location_properties == SKIP
+        @working_location_properties =
+          working_location_properties
+      end
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      start = EventDateTime.from_hash(hash['start']) if hash['start']
+      mend = EventDateTime.from_hash(hash['end']) if hash['end']
+      kind = hash['kind'] ||= 'calendar#event'
+      etag = hash.key?('etag') ? hash['etag'] : SKIP
+      id = hash.key?('id') ? hash['id'] : SKIP
+      status = hash.key?('status') ? hash['status'] : SKIP
+      html_link = hash.key?('htmlLink') ? hash['htmlLink'] : SKIP
+      created = if hash.key?('created')
+                  (DateTimeHelper.from_rfc3339(hash['created']) if hash['created'])
+                else
+                  SKIP
+                end
+      updated = if hash.key?('updated')
+                  (DateTimeHelper.from_rfc3339(hash['updated']) if hash['updated'])
+                else
+                  SKIP
+                end
+      summary = hash.key?('summary') ? hash['summary'] : SKIP
+      description = hash.key?('description') ? hash['description'] : SKIP
+      location = hash.key?('location') ? hash['location'] : SKIP
+      color_id = hash.key?('colorId') ? hash['colorId'] : SKIP
+      creator = Person.from_hash(hash['creator']) if hash['creator']
+      organizer = Person.from_hash(hash['organizer']) if hash['organizer']
+      end_time_unspecified = hash['endTimeUnspecified'] ||= false
+      recurrence = hash.key?('recurrence') ? hash['recurrence'] : SKIP
+      recurring_event_id =
+        hash.key?('recurringEventId') ? hash['recurringEventId'] : SKIP
+      original_start_time = EventDateTime.from_hash(hash['originalStartTime']) if
+        hash['originalStartTime']
+      transparency = hash['transparency'] ||= EventTransparency::OPAQUE
+      visibility = hash['visibility'] ||= EventVisibility::DEFAULT
+      i_cal_uid = hash.key?('iCalUID') ? hash['iCalUID'] : SKIP
+      sequence = hash.key?('sequence') ? hash['sequence'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      attendees = nil
+      unless hash['attendees'].nil?
+        attendees = []
+        hash['attendees'].each do |structure|
+          attendees << (Attendee.from_hash(structure) if structure)
+        end
+      end
+
+      attendees = SKIP unless hash.key?('attendees')
+      attendees_omitted = hash['attendeesOmitted'] ||= false
+      hangout_link = hash.key?('hangoutLink') ? hash['hangoutLink'] : SKIP
+      conference_data = ConferenceData.from_hash(hash['conferenceData']) if hash['conferenceData']
+      guests_can_invite_others = hash['guestsCanInviteOthers'] ||= true
+      guests_can_modify = hash['guestsCanModify'] ||= false
+      guests_can_see_other_guests = hash['guestsCanSeeOtherGuests'] ||= true
+      private_copy = hash['privateCopy'] ||= false
+      locked = hash['locked'] ||= false
+      reminders = EventReminders.from_hash(hash['reminders']) if hash['reminders']
+      source = EventSource.from_hash(hash['source']) if hash['source']
+      event_type = hash.key?('eventType') ? hash['eventType'] : SKIP
+      extended_properties = ExtendedProperties.from_hash(hash['extendedProperties']) if
+        hash['extendedProperties']
+      # Parameter is an array, so we need to iterate through it
+      attachments = nil
+      unless hash['attachments'].nil?
+        attachments = []
+        hash['attachments'].each do |structure|
+          attachments << (Attachment.from_hash(structure) if structure)
+        end
+      end
+
+      attachments = SKIP unless hash.key?('attachments')
+      birthday_properties = BirthdayProperties.from_hash(hash['birthdayProperties']) if
+        hash['birthdayProperties']
+      out_of_office_properties = OutOfOfficeProperties.from_hash(hash['outOfOfficeProperties']) if
+        hash['outOfOfficeProperties']
+      focus_time_properties = FocusTimeProperties.from_hash(hash['focusTimeProperties']) if
+        hash['focusTimeProperties']
+      if hash['workingLocationProperties']
+        working_location_properties = WorkingLocationProperties.from_hash(hash['workingLocationProperties'])
+      end
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      Event.new(start: start,
+                mend: mend,
+                kind: kind,
+                etag: etag,
+                id: id,
+                status: status,
+                html_link: html_link,
+                created: created,
+                updated: updated,
+                summary: summary,
+                description: description,
+                location: location,
+                color_id: color_id,
+                creator: creator,
+                organizer: organizer,
+                end_time_unspecified: end_time_unspecified,
+                recurrence: recurrence,
+                recurring_event_id: recurring_event_id,
+                original_start_time: original_start_time,
+                transparency: transparency,
+                visibility: visibility,
+                i_cal_uid: i_cal_uid,
+                sequence: sequence,
+                attendees: attendees,
+                attendees_omitted: attendees_omitted,
+                hangout_link: hangout_link,
+                conference_data: conference_data,
+                guests_can_invite_others: guests_can_invite_others,
+                guests_can_modify: guests_can_modify,
+                guests_can_see_other_guests: guests_can_see_other_guests,
+                private_copy: private_copy,
+                locked: locked,
+                reminders: reminders,
+                source: source,
+                event_type: event_type,
+                extended_properties: extended_properties,
+                attachments: attachments,
+                birthday_properties: birthday_properties,
+                out_of_office_properties: out_of_office_properties,
+                focus_time_properties: focus_time_properties,
+                working_location_properties: working_location_properties,
+                additional_properties: additional_properties)
+    end
+
+    def to_custom_created
+      DateTimeHelper.to_rfc3339(created)
+    end
+
+    def to_custom_updated
+      DateTimeHelper.to_rfc3339(updated)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} kind: #{@kind}, etag: #{@etag}, id: #{@id}, status: #{@status}, html_link:"\
+      " #{@html_link}, created: #{@created}, updated: #{@updated}, summary: #{@summary},"\
+      " description: #{@description}, location: #{@location}, color_id: #{@color_id}, creator:"\
+      " #{@creator}, organizer: #{@organizer}, start: #{@start}, mend: #{@mend},"\
+      " end_time_unspecified: #{@end_time_unspecified}, recurrence: #{@recurrence},"\
+      " recurring_event_id: #{@recurring_event_id}, original_start_time: #{@original_start_time},"\
+      " transparency: #{@transparency}, visibility: #{@visibility}, i_cal_uid: #{@i_cal_uid},"\
+      " sequence: #{@sequence}, attendees: #{@attendees}, attendees_omitted:"\
+      " #{@attendees_omitted}, hangout_link: #{@hangout_link}, conference_data:"\
+      " #{@conference_data}, guests_can_invite_others: #{@guests_can_invite_others},"\
+      " guests_can_modify: #{@guests_can_modify}, guests_can_see_other_guests:"\
+      " #{@guests_can_see_other_guests}, private_copy: #{@private_copy}, locked: #{@locked},"\
+      " reminders: #{@reminders}, source: #{@source}, event_type: #{@event_type},"\
+      " extended_properties: #{@extended_properties}, attachments: #{@attachments},"\
+      " birthday_properties: #{@birthday_properties}, out_of_office_properties:"\
+      " #{@out_of_office_properties}, focus_time_properties: #{@focus_time_properties},"\
+      " working_location_properties: #{@working_location_properties}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} kind: #{@kind.inspect}, etag: #{@etag.inspect}, id: #{@id.inspect}, status:"\
+      " #{@status.inspect}, html_link: #{@html_link.inspect}, created: #{@created.inspect},"\
+      " updated: #{@updated.inspect}, summary: #{@summary.inspect}, description:"\
+      " #{@description.inspect}, location: #{@location.inspect}, color_id: #{@color_id.inspect},"\
+      " creator: #{@creator.inspect}, organizer: #{@organizer.inspect}, start: #{@start.inspect},"\
+      " mend: #{@mend.inspect}, end_time_unspecified: #{@end_time_unspecified.inspect},"\
+      " recurrence: #{@recurrence.inspect}, recurring_event_id: #{@recurring_event_id.inspect},"\
+      " original_start_time: #{@original_start_time.inspect}, transparency:"\
+      " #{@transparency.inspect}, visibility: #{@visibility.inspect}, i_cal_uid:"\
+      " #{@i_cal_uid.inspect}, sequence: #{@sequence.inspect}, attendees: #{@attendees.inspect},"\
+      " attendees_omitted: #{@attendees_omitted.inspect}, hangout_link: #{@hangout_link.inspect},"\
+      " conference_data: #{@conference_data.inspect}, guests_can_invite_others:"\
+      " #{@guests_can_invite_others.inspect}, guests_can_modify: #{@guests_can_modify.inspect},"\
+      " guests_can_see_other_guests: #{@guests_can_see_other_guests.inspect}, private_copy:"\
+      " #{@private_copy.inspect}, locked: #{@locked.inspect}, reminders: #{@reminders.inspect},"\
+      " source: #{@source.inspect}, event_type: #{@event_type.inspect}, extended_properties:"\
+      " #{@extended_properties.inspect}, attachments: #{@attachments.inspect},"\
+      " birthday_properties: #{@birthday_properties.inspect}, out_of_office_properties:"\
+      " #{@out_of_office_properties.inspect}, focus_time_properties:"\
+      " #{@focus_time_properties.inspect}, working_location_properties:"\
+      " #{@working_location_properties.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end

data/lib/calendar_api/models/event_date_time.rb

@@ -0,0 +1,107 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+require 'date'
+module CalendarApi
+  # A timestamp marking the start or end of an event. For all-day events, use
+  # date; for timed events, use dateTime.
+  class EventDateTime < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The date, in the format "yyyy-mm-dd", if this is an all-day event.
+    # @return [Date]
+    attr_accessor :date
+
+    # The time, as a combined date-time value (RFC3339). A time zone offset is
+    # required unless a time zone is explicitly specified in timeZone.
+    # @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. "America/New_York".
+    # @return [String]
+    attr_accessor :time_zone
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['date'] = 'date'
+      @_hash['date_time'] = 'dateTime'
+      @_hash['time_zone'] = 'timeZone'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        date
+        date_time
+        time_zone
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(date: SKIP, date_time: SKIP, time_zone: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @date = date unless date == SKIP
+      @date_time = date_time unless date_time == SKIP
+      @time_zone = time_zone unless time_zone == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      date = hash.key?('date') ? hash['date'] : SKIP
+      date_time = if hash.key?('dateTime')
+                    (DateTimeHelper.from_rfc3339(hash['dateTime']) if hash['dateTime'])
+                  else
+                    SKIP
+                  end
+      time_zone = hash.key?('timeZone') ? hash['timeZone'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      EventDateTime.new(date: date,
+                        date_time: date_time,
+                        time_zone: time_zone,
+                        additional_properties: additional_properties)
+    end
+
+    def to_custom_date_time
+      DateTimeHelper.to_rfc3339(date_time)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} date: #{@date}, date_time: #{@date_time}, time_zone: #{@time_zone},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} date: #{@date.inspect}, date_time: #{@date_time.inspect}, time_zone:"\
+      " #{@time_zone.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end