python - 将 Google Calendar API v 3 与 Python 结合使用

Question

谁能给我一个清晰的解释，说明如何让 Google Calendar API v3 与 Python 客户端一起工作？具体来说，最初的 OAuth 阶段让我非常困惑。我所需要做的就是访问我自己的日历、阅读它并对其进行更改。 Google 提供了用于配置我的应用程序的代码:

import gflags
import httplib2

from apiclient.discovery import build
from oauth2client.file import Storage
from oauth2client.client import OAuth2WebServerFlow
from oauth2client.tools import run

FLAGS = gflags.FLAGS

# Set up a Flow object to be used if we need to authenticate. This
# sample uses OAuth 2.0, and we set up the OAuth2WebServerFlow with
# the information it needs to authenticate. Note that it is called
# the Web Server Flow, but it can also handle the flow for native
# applications
# The client_id and client_secret are copied from the API Access tab on
# the Google APIs Console
FLOW = OAuth2WebServerFlow(
    client_id='YOUR_CLIENT_ID',
    client_secret='YOUR_CLIENT_SECRET',
    scope='https://www.googleapis.com/auth/calendar',
    user_agent='YOUR_APPLICATION_NAME/YOUR_APPLICATION_VERSION')

# To disable the local server feature, uncomment the following line:
# FLAGS.auth_local_webserver = False

# If the Credentials don't exist or are invalid, run through the native client
# flow. The Storage object will ensure that if successful the good
# Credentials will get written back to a file.
storage = Storage('calendar.dat')
credentials = storage.get()
if credentials is None or credentials.invalid == True:
  credentials = run(FLOW, storage)

# Create an httplib2.Http object to handle our HTTP requests and authorize it
# with our good Credentials.
http = httplib2.Http()
http = credentials.authorize(http)

# Build a service object for interacting with the API. Visit
# the Google APIs Console
# to get a developerKey for your own application.
service = build(serviceName='calendar', version='v3', http=http,
       developerKey='YOUR_DEVELOPER_KEY')

但是 (a) 这对我来说完全没有意义；评论解释很糟糕，而且 (b) 我不知道要在变量中放入什么。我已经在 Google 注册了我的程序并注册了服务帐户 key 。但是给我的只是一个可供下载的加密 key 文件和一个客户端 ID。我不知道“developerKey”是什么，或者“client_secret”是什么？那是关键吗？如果是，我如何获取它，因为它实际上包含在加密文件中？最后，鉴于我使用 API 的目标相对简单(即，它不是多用户、多访问操作)，是否有更简单的方法来执行此操作？谢谢。

Answer 1

一个简单的(阅读:我已经做到的)方法是创建一个网络应用程序而不是服务帐户。这听起来可能很奇怪，因为您不需要任何类型的 Web 应用程序，但我使用它的方式与您相同 - 对我自己的日历/添加事件/等进行一些查询。 - 全部来自命令行，无需任何类型的网络应用程序交互。有多种方法可以使用服务帐户来实现(如果您确实想走那条路，我会进行修改)，但到目前为止，这对我有用。

创建 Web 应用程序后，您将获得上面指示的所有信息(旁注:上面的示例代码基于 Web 应用程序 - 使用您的 FLOW 需要的服务帐户调用 flow_from_clientsecrets 并且需要进行进一步的调整 - 参见 here )。因此，您将能够填写此部分:

FLOW = OAuth2WebServerFlow(
    client_id='YOUR_CLIENT_ID',
    client_secret='YOUR_CLIENT_SECRET',
    scope='https://www.googleapis.com/auth/calendar',
    user_agent='YOUR_APPLICATION_NAME/YOUR_APPLICATION_VERSION')

您现在可以填写您在 API 控制台中看到的值(client_id = 整个 Client ID 字符串，client_secret = client secret，scope 是相同的，user_agent 可以是任何你想要的)。至于 service 行，developerKey 是您可以在 API 控制台的 Simple API Access 部分下找到的 API key (标签是 API key ):

service = build(serviceName='calendar', version='v3', http=http, 
    developerKey='<your_API_key>')

然后您可以添加一个简单的检查，如下所示，看看它是否有效:

events = service.events().list(calendarId='<your_email_here>').execute()
print events

现在，当您运行它时，将弹出一个浏览器窗口，让您完成身份验证流程。这意味着所有身份验证都将由 Google 处理，身份验证响应信息将存储在 calendar.dat 中。该文件(将存储在与您的脚本相同的目录中)将包含该服务现在将使用的身份验证信息。这就是这里发生的事情:

storage = Storage('calendar.dat')
credentials = storage.get()
if credentials is None or credentials.invalid == True:
  credentials = run(FLOW, storage)

它通过查找该文件并验证内容来检查是否存在有效凭据(这一切都从您那里抽象出来以使其更容易实现)。在您进行身份验证后，if 语句将计算出 False，您将能够访问您的数据而无需再次进行身份验证。

希望这能更清楚地说明这个过程 - 长话短说，制作一个 Web 应用程序并使用其中的参数，验证一次然后忘记它。我确信我忽略了很多要点，但希望它对您的情况有用。