利用PHP优化Google Classroom API课程列表响应字段

$optParams = array(
  'pageSize' => 100,
   'courses' => 'name','section', // 错误：'courses'不是用于字段筛选的参数
   'fields' => 'courses(id)' // 错误：fields参数语法不完整或不准确
);
$results = $service->courses->listCourses($optParams);

<?php

// 假设您已经完成了Google API客户端库的认证和初始化
// $client = new Google\Client();
// $client->setApplicationName('Google Classroom API PHP Quickstart');
// $client->setScopes(Google\Service\Classroom::CLASSROOM_COURSES_READONLY);
// ... 认证流程 ...
// $service = new Google\Service\Classroom($client);

// 定义可选参数，其中包含fields参数用于指定所需字段
$optParams = array(
  'pageSize' => 100, // 每页返回的课程数量，最大100
  'fields' => 'courses(name,section,id)' // 指定只返回课程的name, section和id字段
);

try {
    // 调用listCourses方法获取课程列表
    $results = $service->courses->listCourses($optParams);

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

            // 注意：未请求的字段将是null
            // 例如，如果未在fields中指定alternateLink，则 $course->getAlternateLink() 将返回null
            // echo "  课程链接: " . $course->getAlternateLink() . "\n"; // 这将是null
        }
    } else {
        echo "未找到任何课程。\n";
    }
} catch (Google\Service\Exception $e) {
    echo "获取课程列表时发生错误: " . $e->getMessage() . "\n";
    // 打印详细错误信息，通常在开发阶段有用
    // echo "详细错误: " . $e->getErrors()[0]['message'] . "\n";
} catch (Exception $e) {
    echo "发生未知错误: " . $e->getMessage() . "\n";
}

?>

[courses] => Array
    (
        [0] => Google\Service\Classroom\Course Object
            (
                [collection_key:protected] => courseMaterialSets
                [alternateLink] => null // 未请求的字段值为null
                [calendarId] => null
                // ... 其他未请求的字段都为null ...
                [id] => null
                [name] => Android
                [ownerId] => null
                [room] => null
                [section] => PC-D
                // ...
            )
        // ... 其他课程对象 ...
    )