Check a task's necessary scopes prior to API calls

[jrchamp]

From #614, we should check the necessary scopes for a task before we make API calls that will fail (especially if it's going to fail silently). This will allow us to use mtrace() or similar to provide information to the Moodle server administrators if they are trying to figure out why a task is not working as expected. Because recording/reports/etc scopes are technically optional, this will allow us to let them know if a task is running that has not been granted the scopes for that task to function/provide value.

[smbader]

Investigate:

• Make sure we have the correct list of scopes for the task. For example:
  

  moodle-mod_zoom/classes/task/get_meeting_reports.php

  Lines 146 to 155 in 8136026

  	$dashboardscopes = [
  	'dashboard_meetings:read:admin',
  	'dashboard_meetings:read:list_meetings:admin',
  	'dashboard_meetings:read:list_webinars:admin',
  	];
  	$reportscopes = [
  	'report:read:admin',
  	'report:read:list_users:admin',
  	];

• It would be nice to know which scopes are optional vs required and relay that information accordingly.

• Should has_scopes report which scopes are missing via mtrace?
  

  moodle-mod_zoom/classes/webservice.php

  Lines 1179 to 1188 in 8136026

  	public function has_scope($scopes) {
  	if (!isset($this->scopes)) {
  	$this->get_access_token();
  	}
  	mtrace('checking has_scope(' . implode(' || ', $scopes) . ')');
  	$matchingscopes = \array_intersect($scopes, $this->scopes);
  	return !empty($matchingscopes);
  	}

[jrchamp]

Ideas:

        $reportscopes = [
            'classic' => [
                'report:read:admin',
            ],
            'granular' => [
                'report:read:list_' . $meetingtypesingular . '_participants:admin',
            ],
        ];

private function get_scope_type($scopes) {
    return in_array('meeting:read:admin', $scopes, true) ? 'classic' : 'granular';
}

$this->scopetype = $this->get_scope_type($this->scopes);

        $missingscopes = array_diff($requiredscopes[$this->scopetype], $scopes);