如何通过Google Calendar API V3获取公共假日日历支持的国家ID列表？

很遗憾，Google并没有提供一个官方的API端点来直接枚举所有支持公共假日日历的国家/地区ID列表。这些公共假日日历属于Google预定义的公共日历集合，目前没有专门的元数据API来返回完整的可用ID清单。

不过，你可以通过以下几种可靠的方式来获取或验证有效的假日日历ID：

• 基于日历ID格式生成并验证：Google公共假日日历的ID遵循固定格式：[语言代码].[国家/地区代码]#holiday@group.v.calendar.google.com，其中语言代码采用ISO 639-1标准（比如en代表英语，fr代表法语），国家/地区代码采用ISO 3166-1标准（比如uk代表英国，jp代表日本）。你可以基于这些标准代码组合生成可能的ID，然后通过calendars.get API来验证该日历是否存在：

  GET https://www.googleapis.com/calendar/v3/calendars/[生成的ID]?key=YOUR_API_KEY
  

  如果请求返回200状态码和日历详情，说明该ID有效；返回404则表示该国家/地区没有对应的官方公共假日日历。

• 参考社区维护的列表：像你找到的那份开发者手动收集整理的ID列表，这类资源可以作为快速参考。不过要注意，这类列表可能存在滞后性，建议定期用上面的API验证方法更新内容。

• 搜索公共日历：你也可以通过Google Calendar的公共搜索功能，在API中使用calendarList.list并带上关键词（比如holiday、public holiday）来查找相关日历，但这种方法不够系统，适合临时查找特定国家的日历。

另外需要注意：有些国家/地区可能有多个语言版本的假日日历，比如加拿大同时提供英语（en.ca#holiday@group.v.calendar.google.com）和法语（fr.ca#holiday@group.v.calendar.google.com）版本；部分地区会使用地区代码（如中国香港的en.hk#holiday@group.v.calendar.google.com）。

内容的提问来源于stack exchange，提问作者Mike Athi