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.BigQuery.Tables.Get
  -- 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)
  --
  -- Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table.
  --
  -- /See:/ <https://cloud.google.com/bigquery/ BigQuery API Reference> for @bigquery.tables.get@.
  module Gogol.BigQuery.Tables.Get
    ( -- * Resource
      BigQueryTablesGetResource,
  
      -- ** Constructing a Request
      BigQueryTablesGet (..),
      newBigQueryTablesGet,
    )
  where
  
  import Gogol.BigQuery.Types
  import Gogol.Prelude qualified as Core
  
  -- | A resource alias for @bigquery.tables.get@ method which the
  -- 'BigQueryTablesGet' request conforms to.
  type BigQueryTablesGetResource =
    "bigquery"
      Core.:> "v2"
      Core.:> "projects"
      Core.:> Core.Capture "projectId" Core.Text
      Core.:> "datasets"
      Core.:> Core.Capture "datasetId" Core.Text
      Core.:> "tables"
      Core.:> Core.Capture "tableId" Core.Text
      Core.:> Core.QueryParam "$.xgafv" Xgafv
      Core.:> Core.QueryParam "access_token" Core.Text
      Core.:> Core.QueryParam "callback" Core.Text
      Core.:> Core.QueryParam "selectedFields" Core.Text
      Core.:> Core.QueryParam "uploadType" Core.Text
      Core.:> Core.QueryParam "upload_protocol" Core.Text
      Core.:> Core.QueryParam "view" TablesGetView
      Core.:> Core.QueryParam "alt" Core.AltJSON
      Core.:> Core.Get '[Core.JSON] Table
  
  -- | Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table.
  --
  -- /See:/ 'newBigQueryTablesGet' smart constructor.
  data BigQueryTablesGet = BigQueryTablesGet
    { -- | V1 error format.
      xgafv :: (Core.Maybe Xgafv),
      -- | OAuth access token.
      accessToken :: (Core.Maybe Core.Text),
      -- | JSONP
      callback :: (Core.Maybe Core.Text),
      -- | Required. Dataset ID of the requested table
      datasetId :: Core.Text,
      -- | Required. Project ID of the requested table
      projectId :: Core.Text,
      -- | List of table schema fields to return (comma-separated). If unspecified, all fields are returned. A fieldMask cannot be used here because the fields will automatically be converted from camelCase to snake_case and the conversion will fail if there are underscores. Since these are fields in BigQuery table schemas, underscores are allowed.
      selectedFields :: (Core.Maybe Core.Text),
      -- | Required. Table ID of the requested table
      tableId :: Core.Text,
      -- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
      uploadType :: (Core.Maybe Core.Text),
      -- | Upload protocol for media (e.g. \"raw\", \"multipart\").
      uploadProtocol :: (Core.Maybe Core.Text),
      -- | Optional. Specifies the view that determines which table information is returned. By default, basic table information and storage statistics (STORAGE_STATS) are returned.
      view :: (Core.Maybe TablesGetView)
    }
    deriving (Core.Eq, Core.Show, Core.Generic)
  
  -- | Creates a value of 'BigQueryTablesGet' with the minimum fields required to make a request.
  newBigQueryTablesGet ::
    -- |  Required. Dataset ID of the requested table See 'datasetId'.
    Core.Text ->
    -- |  Required. Project ID of the requested table See 'projectId'.
    Core.Text ->
    -- |  Required. Table ID of the requested table See 'tableId'.
    Core.Text ->
    BigQueryTablesGet
  newBigQueryTablesGet datasetId projectId tableId =
    BigQueryTablesGet
      { xgafv = Core.Nothing,
        accessToken = Core.Nothing,
        callback = Core.Nothing,
        datasetId = datasetId,
        projectId = projectId,
        selectedFields = Core.Nothing,
        tableId = tableId,
        uploadType = Core.Nothing,
        uploadProtocol = Core.Nothing,
        view = Core.Nothing
      }
  
  instance Core.GoogleRequest BigQueryTablesGet where
    type Rs BigQueryTablesGet = Table
    type
      Scopes BigQueryTablesGet =
        '[ Bigquery'FullControl,
           CloudPlatform'FullControl,
           CloudPlatform'ReadOnly
         ]
    requestClient BigQueryTablesGet {..} =
      go
        projectId
        datasetId
        tableId
        xgafv
        accessToken
        callback
        selectedFields
        uploadType
        uploadProtocol
        view
        (Core.Just Core.AltJSON)
        bigQueryService
      where
        go =
          Core.buildClient
            (Core.Proxy :: Core.Proxy BigQueryTablesGetResource)
            Core.mempty
  