Google Calendar 项目技术文档

1. 安装指南

首先，确保您的系统中已安装了Ruby环境。接下来，通过以下命令安装google_calendar gem：

[sudo] gem install 'google_calendar'

2. 项目的使用说明

在开始使用本项目之前，您需要设置OAuth认证。请按照以下步骤操作：

1. 前往Google Developers Console，创建或选择一个项目。
2. 在侧边栏中选择“库”，搜索“Google Calendar API”并点击“启用”。
3. 在侧边栏中选择“凭证”，创建一个新的OAuth客户端ID（选择Web应用类型），并设置一个可公开访问的重定向URI。
4. 记录下您的客户端ID和客户端密钥，这些将在后续的代码中用到。
5. 在“OAuth同意屏幕”中设置应用程序名称，并根据需要添加测试用户或发布应用程序。

此外，您还需要找到您的Google Calendar ID：

1. 访问Google Calendar，在左侧日历列表中点击相应日历旁边的三个垂直点，选择“设置和共享”。
2. 在左侧工具栏中选择“集成日历”，复制顶部的日历ID。

3. 项目API使用文档

以下是一个基本的API使用示例：

require 'rubygems'
require 'google_calendar'

cal = Google::Calendar.new(
  :client_id => YOUR_CLIENT_ID,
  :client_secret => YOUR_SECRET,
  :calendar => YOUR_CALENDAR_ID,
  :redirect_url => YOUR_REDIRECT_URL
)

# 根据是否有刷新令牌来决定是登录还是续期
has_token = $stdin.gets.chomp
if has_token.downcase != 'y'
  # 获取授权URL并批准访问
  puts cal.authorize_url
  # 使用返回的授权码获取刷新令牌
  refresh_token = cal.login_with_auth_code($stdin.gets.chomp)
else
  puts "Enter your refresh token"
  refresh_token = $stdin.gets.chomp
  cal.login_with_refresh_token(refresh_token)
end

# 创建事件
event = cal.create_event do |e|
  e.title = 'A Cool Event'
  e.start_time = Time.now
  e.end_time = Time.now + (60 * 60)
end

# 更新事件
event = cal.find_or_create_event_by_id(event.id) do |e|
  e.title = 'An Updated Cool Event'
  e.end_time = Time.now + (60 * 60 * 2)
end

# 获取所有事件
puts cal.events

# 搜索事件
puts cal.find_events('your search string')

确保将YOUR_CLIENT_ID、YOUR_SECRET、YOUR_CALENDAR_ID和YOUR_REDIRECT_URL替换为实际的值。

4. 项目安装方式

项目的安装方式已在“安装指南”中详细说明。主要是通过Ruby的gem包管理器安装google_calendar gem。