Get-FplTeamPlayer.ps1

function Get-FplTeamPlayer {
    <#
    .SYNOPSIS
        Retrieves the player information within a team from a certain gameweek.
    .DESCRIPTION
        Retrieves the player information within a team from a certain gameweek.
        If no team ID or gameweek is supplied it will request to authenticate to get the users team and current gameweek.
    .PARAMETER TeamId
        The ID of the team to retrieve the player information
    .PARAMETER Gameweek
        The gameweek of which to retrieve the player information from
    .EXAMPLE
        Get-FplTeamPlayer

        This will prompt the user to supply credentials and return the user's player information from the current gameweek
    .EXAMPLE
        Get-FplTeamPlayer -TeamID 12345

        This will get the player information for the team with ID 12345 from the current gameweek
    .EXAMPLE
        Get-FplTeamPlayer -TeamID 12345 -Gameweek 12

        This will get the player information for the team with ID 12345 from gameweek 12
    .LINK
        https://psfpl.readthedocs.io/en/master/functions/Get-FplTeamPlayer
    .LINK
        https://github.com/sk82jack/PSFPL/blob/master/PSFPL/Public/Get-FplTeamPlayer.ps1
    #>

    [CmdletBinding()]
    param (
        [Parameter()]
        [int]
        $TeamId,

        [Parameter()]
        [int]
        $Gameweek
    )
    process {
        if ($TeamId -eq 0) {
            if ((-not $Script:FplSessionData) -or (-not $Script:FplSessionData['FplSession'])) {
                Write-Warning 'No existing connection found'
                $Credential = Get-Credential -Message 'Please enter your FPL login details'
                Connect-Fpl -Credential $Credential
            }

            $TeamId = $Script:FplSessionData['TeamID']
        }

        if ($Script:FplSessionData) {
            [int]$CurrentGameweek = $Script:FplSessionData['CurrentGW']
        }
        else {
            [int]$CurrentGameweek = (Get-FplGameweek -Current).Gameweek
        }

        if (($CurrentGameweek -eq 0) -or ($Gameweek -gt $CurrentGameweek)) {
            Write-Error -Message 'Cannot view team because the gameweek has not started yet' -ErrorAction 'Stop'
        }

        if ($Gameweek -eq 0) {
            $Gameweek = $CurrentGameweek
        }

        try {
            $Response = Invoke-RestMethod -Uri "https://fantasy.premierleague.com/api/entry/$TeamId/event/$Gameweek/picks/"
        }
        catch {
            if ($_.ErrorDetails.Message -eq '{"detail":"Not found."}') {
                Write-Error -Message "Team did not exist in gameweek $Gameweek" -ErrorAction 'Stop'
            }
            else {
                Write-Error -ErrorRecord $_ -ErrorAction 'Stop'
            }
        }
        if ($Response -match 'The game is being updated.') {
            Write-Warning 'The game is being updated. Please try again shortly.'
            return
        }
        ConvertTo-FplObject -InputObject $Response.picks -Type 'FplTeamPlayer'
    }
}