content: {-# LANGUAGE DataKinds #-}
  {-# LANGUAGE DerivingStrategies #-}
  {-# LANGUAGE DuplicateRecordFields #-}
  {-# LANGUAGE ImportQualifiedPost #-}
  {-# LANGUAGE LambdaCase #-}
  {-# LANGUAGE OverloadedStrings #-}
  {-# LANGUAGE PatternSynonyms #-}
  {-# LANGUAGE RecordWildCards #-}
  {-# LANGUAGE StrictData #-}
  {-# LANGUAGE TypeFamilies #-}
  {-# LANGUAGE NoImplicitPrelude #-}
  {-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
  {-# OPTIONS_GHC -fno-warn-name-shadowing #-}
  {-# OPTIONS_GHC -fno-warn-unused-binds #-}
  {-# OPTIONS_GHC -fno-warn-unused-imports #-}
  {-# OPTIONS_GHC -fno-warn-unused-matches #-}
  
  -- |
  -- Module      : Gogol.AppsCalendar.Calendar.Settings.List
  -- Copyright   : (c) 2015-2025 Brendan Hay
  -- License     : Mozilla Public License, v. 2.0.
  -- Maintainer  : Brendan Hay <brendan.g.hay+gogol@gmail.com>
  --               Toni Cebrián <toni@tonicebrian.com>
  -- Stability   : auto-generated
  -- Portability : non-portable (GHC extensions)
  --
  -- Returns all user settings for the authenticated user.
  --
  -- /See:/ <https://developers.google.com/google-apps/calendar/firstapp Calendar API Reference> for @calendar.settings.list@.
  module Gogol.AppsCalendar.Calendar.Settings.List
    ( -- * Resource
      CalendarSettingsListResource,
  
      -- ** Constructing a Request
      CalendarSettingsList (..),
      newCalendarSettingsList,
    )
  where
  
  import Gogol.AppsCalendar.Types
  import Gogol.Prelude qualified as Core
  
  -- | A resource alias for @calendar.settings.list@ method which the
  -- 'CalendarSettingsList' request conforms to.
  type CalendarSettingsListResource =
    "calendar"
      Core.:> "v3"
      Core.:> "users"
      Core.:> "me"
      Core.:> "settings"
      Core.:> Core.QueryParam "maxResults" Core.Int32
      Core.:> Core.QueryParam "pageToken" Core.Text
      Core.:> Core.QueryParam "syncToken" Core.Text
      Core.:> Core.QueryParam "alt" Core.AltJSON
      Core.:> Core.Get '[Core.JSON] Settings
  
  -- | Returns all user settings for the authenticated user.
  --
  -- /See:/ 'newCalendarSettingsList' smart constructor.
  data CalendarSettingsList = CalendarSettingsList
    { -- | Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries. Optional.
      maxResults :: (Core.Maybe Core.Int32),
      -- | Token specifying which result page to return. Optional.
      pageToken :: (Core.Maybe Core.Text),
      -- | Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken. Learn more about incremental synchronization. Optional. The default is to return all entries.
      syncToken :: (Core.Maybe Core.Text)
    }
    deriving (Core.Eq, Core.Show, Core.Generic)
  
  -- | Creates a value of 'CalendarSettingsList' with the minimum fields required to make a request.
  newCalendarSettingsList ::
    CalendarSettingsList
  newCalendarSettingsList =
    CalendarSettingsList
      { maxResults = Core.Nothing,
        pageToken = Core.Nothing,
        syncToken = Core.Nothing
      }
  
  instance Core.GoogleRequest CalendarSettingsList where
    type Rs CalendarSettingsList = Settings
    type
      Scopes CalendarSettingsList =
        '[ Calendar'FullControl,
           Calendar'Readonly,
           Calendar'Settings'Readonly
         ]
    requestClient CalendarSettingsList {..} =
      go
        maxResults
        pageToken
        syncToken
        (Core.Just Core.AltJSON)
        appsCalendarService
      where
        go =
          Core.buildClient
            (Core.Proxy :: Core.Proxy CalendarSettingsListResource)
            Core.mempty
  