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

$optParams = array(
  'pageSize' => 100,
  'courses' => 'name','section', // 错误示例
  'fields' => 'courses(id)'
);
$results = $service->courses->listCourses($optParams);

<?php

require_once __DIR__ . '/vendor/autoload.php'; // 引入Composer自动加载文件

// 确保你已经完成了Google API客户端的认证和初始化
// 这里仅为示例，实际代码中需要包含认证逻辑
// $client = getGoogleClient(); // 假设此函数返回一个已认证的Google_Client对象
// $service = new Google_Service_Classroom($client);

// 示例：初始化Google_Client和Google_Service_Classroom
// 实际应用中需要替换为你的认证逻辑，例如OAuth2
$client = new Google_Client();
$client->setApplicationName('Google Classroom API PHP Quickstart');
$client->setScopes([Google_Service_Classroom::CLASSROOM_COURSES_READONLY]);
$client->setAuthConfig('path/to/your/credentials.json'); // 替换为你的凭据文件路径
$client->setAccessType('offline');
$client->setPrompt('select_account consent');

// 如果没有有效的访问令牌，则获取新的令牌
if (file_exists('token.json')) {
    $accessToken = json_decode(file_get_contents('token.json'), true);
    $client->setAccessToken($accessToken);
}

if ($client->isAccessTokenExpired()) {
    if ($client->getRefreshToken()) {
        $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
    } else {
        // 进行OAuth2授权流程
        $authUrl = $client->createAuthUrl();
        printf("Open the following link in your browser:\n%s\n", $authUrl);
        print 'Enter verification code: ';
        $authCode = trim(fgets(STDIN));

        $accessToken = $client->fetchAccessTokenWithAuthCode($authCode);
        $client->setAccessToken($accessToken);

        // 保存令牌以备将来使用
        if (!file_exists(dirname('token.json'))) {
            mkdir(dirname('token.json'), 0700, true);
        }
        file_put_contents('token.json', json_encode($client->getAccessToken()));
    }
}

$service = new Google_Service_Classroom($client);

// 设置请求参数，使用 'fields' 参数指定所需的字段
$optParams = array(
  'pageSize' => 100, // 每页获取的课程数量
  'fields' => 'courses(name,section)' // 指定只获取课程的名称和分区
);

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

    // 检查是否有课程返回
    if (!empty($results->getCourses())) {
        echo "获取到的课程信息：\n";
        foreach ($results->getCourses() as $course) {
            // 访问请求的字段
            echo "  课程名称: " . $course->getName() . "\n";
            echo "  课程分区: " . $course->getSection() . "\n";
            echo "--------------------------\n";

            // 注意：未请求的字段在对象中可能存在但值为null或空
            // 例如，尝试访问 $course->getId() 可能会返回null，
            // 因为我们没有在 fields 参数中请求 'id'。
            // echo "  课程ID (未请求): " . ($course->getId() ?? 'N/A') . "\n";
        }
    } else {
        echo "未找到任何课程。\n";
    }
} catch (Google\Service\Exception $e) {
    echo "获取课程列表时发生错误: " . $e->getMessage() . "\n";
    // 打印详细错误信息
    // var_dump($e->getErrors());
}

?>

{
  "courses": [
    {
      "name": "Android",
      "section": "PC-D"
    },
    {
      "name": "CSS",
      "section": "PC-D"
    }
    // ... 更多课程
  ]
}