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

{
  "courses": [
    {
      "alternateLink": "...",
      "calendarId": "...",
      "courseGroupEmail": "...",
      "courseState": "...",
      "creationTime": "...",
      "description": "...",
      "descriptionHeading": "...",
      "enrollmentCode": "...",
      "guardiansEnabled": false,
      "id": "...",
      "name": "Android",
      "ownerId": "...",
      "room": "...",
      "section": "PC-D",
      "updateTime": "...",
      // ... 更多字段
    },
    // ... 更多课程
  ],
  "nextPageToken": "..."
}

$optParams = array(
  'pageSize' => 100,
  'courses' => 'name','section', // 错误：'courses'不是一个用于指定返回字段的参数
  'fields' => 'courses(id)'     // 错误：这里的'fields'只指定了id
);
$results = $service->courses->listCourses($optParams);

<?php
require __DIR__ . '/vendor/autoload.php'; // 确保引入Composer自动加载

// 假设您已经完成了Google API客户端的认证和初始化
// $client = new Google_Client();
// $client->setApplicationName('Google Classroom API PHP Quickstart');
// $client->setScopes([Google_Service_Classroom::CLASSROOM_COURSES_READONLY]);
// $client->setAuthConfig('credentials.json');
// $client->setAccessType('offline');
// $client->setPrompt('select_account consent');
// ... 认证流程 ...
// $service = new Google_Service_Classroom($client);

// 示例：初始化一个服务对象 (请替换为您的实际认证逻辑)
$client = new Google_Client();
// ... 设置客户端认证信息 ...
$service = new Google_Service_Classroom($client);

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

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

    if (empty($courses)) {
        echo "未找到任何课程。\n";
    } else {
        echo "已获取课程列表（仅包含名称和分区）：\n";
        foreach ($courses as $course) {
            // 注意：虽然Course对象可能包含所有字段的结构，但只有请求的字段会被填充值
            // 未请求的字段将是null或未设置
            echo "  名称: " . ($course->getName() ?: 'N/A') . "\n";
            echo "  分区: " . ($course->getSection() ?: 'N/A') . "\n";
            echo "  --------------------\n";
        }
    }
} catch (Google\Service\Exception $e) {
    echo "获取课程时发生错误: " . $e->getMessage() . "\n";
} catch (Exception $e) {
    echo "发生未知错误: " . $e->getMessage() . "\n";
}
?>

Google\Service\Classroom\Course Object
(
    [collection_key:protected] => courseMaterialSets
    [alternateLink] => null // 未请求，所以为null
    [calendarId] => null    // 未请求，所以为null
    // ... 许多其他字段为null ...
    [id] => null            // 未请求，所以为null
    [name] => Android       // 已请求，有值
    [ownerId] => null       // 未请求，所以为null
    [room] => null          // 未请求，所以为null
    [section] => PC-D       // 已请求，有值
    // ... 剩余字段为null ...
)