使用 PHP 过滤 Google Classroom 课程列表字段的教程

$optParams = array(
  'pageSize' => 100,
   'courses' => 'name','section', // 错误：'courses' 不是有效的请求参数
   'fields' => 'courses(id)' // 错误：此处的fields参数只请求了id，且与上面的courses参数冲突
);
$results = $service->courses->listCourses($optParams);

<?php
require_once __DIR__ . '/vendor/autoload.php';

// 假设您已经完成了Google API客户端的认证和初始化
// $client = getGoogleClient(); // 获取认证后的Google_Client实例
// $service = new Google_Service_Classroom($client); // 初始化Classroom服务

// 这是一个简化的示例，您需要替换为实际的认证和客户端初始化逻辑
function getGoogleClient() {
    // 您的认证逻辑，例如加载凭据文件或使用OAuth 2.0
    // ...
    $client = new Google_Client();
    $client->setApplicationName('Google Classroom API PHP Filter Example');
    $client->setScopes([Google_Service_Classroom::CLASSROOM_COURSES_READONLY]);
    $client->setAuthConfig('path/to/your/credentials.json'); // 替换为您的凭据文件路径
    $client->setAccessType('offline');
    $client->setPrompt('select_account consent');

    // 检查是否有存储的access token
    if (file_exists('token.json')) {
        $accessToken = json_decode(file_get_contents('token.json'), true);
        $client->setAccessToken($accessToken);
    }

    // 如果access token过期，刷新它
    if ($client->isAccessTokenExpired()) {
        if ($client->getRefreshToken()) {
            $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
        } else {
            // 需要用户授权
            $authUrl = $client->createAuthUrl();
            printf("Open the following link in your browser:\n%s\n", $authUrl);
            print('Enter verification code: ');
            $authCode = trim(fgets(STDIN));

            // Exchange authorization code for an access token.
            $accessToken = $client->fetchAccessTokenWithAuthCode($authCode);
            $client->setAccessToken($accessToken);

            // Save the token to a file.
            if (!file_exists(dirname('token.json'))) {
                mkdir(dirname('token.json'), 0700, true);
            }
            file_put_contents('token.json', json_encode($client->getAccessToken()));
        }
    }
    return $client;
}

try {
    $client = getGoogleClient();
    $service = new Google_Service_Classroom($client);

    $optParams = array(
      'pageSize' => 100, // 每页返回的课程数量
      'fields' => 'courses(name,section)' // 指定只返回课程的name和section字段
    );

    $results = $service->courses->listCourses($optParams);

    if (empty($results->getCourses())) {
        print "No courses found.\n";
    } else {
        print "Courses:\n";
        foreach ($results->getCourses() as $course) {
            // 访问请求的字段
            printf("- Name: %s, Section: %s\n", $course->getName(), $course->getSection());

            // 注意：未请求的字段将返回 null
            // 例如，尝试访问 $course->getId() 可能会返回 null，因为我们没有请求 'id'
            // var_dump($course->getId());
        }
    }
} catch (Google\Service\Exception $e) {
    printf("An error occurred: %s\n", $e->getMessage());
    // 详细错误信息可能在 $e->getErrors() 中
    // var_dump($e->getErrors());
} catch (Exception $e) {
    printf("An unexpected error occurred: %s\n", $e->getMessage());
}

?>

 [courses] => Array
        (
            [0] => Google\Service\Classroom\Course Object
                (
                    // 其他未请求的字段会存在，但值为 null
                    [collection_key:protected] => courseMaterialSets
                    [alternateLink] => null
                    [calendarId] => null
                    // ...
                    [name] => Android                
                    [ownerId] => null
                    [room] => null
                    [section] => PC-D
                    // ...
                )
            [1] => Google\Service\Classroom\Course Object
                (
                    // ...
                    [name] => CSS                
                    [section] => PC-D
                    // ...
                )
        )