gdata-python-api +通过简单的身份验证进行分析

Question

我正在努力将使用 Google gdata API 客户端 + 用户/通行证身份验证的 Python 脚本转换为更适合生产的内容（API 密钥）。我对他们的身份验证文档的混乱状态感到非常沮丧。诚然，我对 OAuth2 没有很好的掌握，但对于我的使用案例来说，它似乎要复杂得多，即：每 24 小时访问一次 Google Analytics，以获取我们网站上最流行的 X 篇文章。

在这种情况下，我们不会修改某人的个人数据，所有活动都集中在一个帐户上。看起来 OAuth2 不值得为了如此简单的事情而变得复杂。

我在 Google API 控制台 (https://code.google.com/apis/console/) 上看到，我已在那里注册，并注意到有一个“简单 API 访问”部分，其中“客户端 ID”下方有一个键Web 应用程序”（似乎是 OAuth2）。还有 Google 域更新页面 https://www.google.com/accounts/UpdateDomain，但这似乎与 OAuth 相关。

有没有办法使用这个简单 API 访问密钥（不是 OAuth）通过 Python gdata 客户端检索分析数据，如果是这样，有人有任何身份验证示例吗？经过身份验证后，我已经有了数据检索功能，但我使用的是用户/通行证方法，这不适合生产。

Answer 1

Greg，

如果您已经在使用库 gdata-python-client，那么这是相对的如果您是您的应用程序将授权的唯一用户，那么这很容易做到。

9 月份的博文详细介绍了一般机制， 2011 年，但为了完整起见，我将在这里描述它们。

第 1 部分：转到 API 控制台并启动一个新项目。

第 2 部分：从项目中，转到“服务”并启用“Analytics API”

第 3 部分：从项目中，转到“API 访问”，然后单击“创建OAuth 2.0 客户端 ID...”（您需要提供产品名称，但您提供的值并不重要）。当询问应用程序类型时，选择“已安装的应用程序”，然后选择“创建客户端 ID”。由于您将是唯一的用户，因此您只需要一个刷新令牌，并且可以通过从桌面应用程序进行一次授权来获取此令牌。

第 4 部分：从 API 控制台获取您的客户端 ID 和客户端密钥，然后创建一个空令牌：

import gdata.gauth

CLIENT_ID = 'id-from-apis-console'
CLIENT_SECRET = 'secret-from-apis-console'
SCOPE = 'https://www.google.com/analytics/feeds/'  # Default scope for analytics

token = gdata.gauth.OAuth2Token(
    client_id=CLIENT_ID,
    client_secret=CLIENT_SECRET, 
    scope=SCOPE,
    user_agent='application-name-goes-here')

我从 GData 常见问题解答，尽管我不确定它是否正确。

第 5 部分：使用令牌创建授权 URL 供您访问：

url = token.generate_authorize_url(redirect_uri='urn:ietf:wg:oauth:2.0:oob')

由于您的应用程序是“已安装的应用程序”，因此您的重定向 URI 是默认的 'urn:ietf:wg:oauth: 2.0:oob'。 （另请注意，该博文有一个拼写错误，并使用了关键字参数 redirect_url。）

第 6 部分：访问该 URL 并授权您的应用程序代表您的帐户发出请求。授权后，您将被重定向到带有代码的页面。此代码将用于交换访问令牌和长期刷新令牌。代码的有效期为 10 分钟，访问令牌的有效期为 1 小时。刷新令牌将允许您永久获取新的访问令牌来签署请求（或者直到您撤销帐户的权限为止）。

第 7 部分：使用代码获取访问令牌：

code = 'random-string-from-redirected-page'
token.get_access_token(code)  # This returns the token, but also changes the state

这又与博客文章略有不同，因为我们使用的是已安装的应用程序。

第 8 部分：使用令牌，您现在可以向分析客户端发出您想要的所有请求：

import gdata.analytics.client

client = gdata.analytics.client.AnalyticsClient()
token.authorize(client)

这就是这里的大钱。当访问令牌过期时，使用该令牌签名的 API 请求将被拒绝。但是，通过如上所述对客户端进行授权，当所述请求失败时，令牌会尝试使用刷新令牌来获取新的访问令牌。如果成功获取新的访问令牌，客户端将重新发送使用新访问令牌签名的原始 API 请求。

我对 Analytics API 一无所知，因此我不会提供更多详细信息。

将来使用注意事项1：保存信息以供将来使用。您可以从不同的地方重复使用它，并且在使用之后非常容易。库提供了名为 token_to_blob 和 token_from_blob 的方法，允许将令牌转换为字符串并从字符串中转换出来：

saved_blob_string = gdata.gauth.token_to_blob(token)

完成此操作后，您可以存储文件中的字符串并终止正在运行的 Python 进程。当您想再次使用它时：

saved_blob_string = retrieve_string_from_file()  # You'll need to implement this
token = gdata.gauth.token_from_blob(saved_blob_string)

未来使用注意事项 2：只要您刷新，此令牌将能够用于授权客户端并一次又一次地执行您的所有魔法周围的令牌。如果由于某种原因您想在不调用 token.generate_authorize_url 的情况下再次获取访问令牌，则需要在对象上手动设置：

token.redirect_uri = 'urn:ietf:wg:oauth:2.0:oob'

未来使用注意事项 3：此外，如果您丢失了刷新令牌，并且想获取另一个刷新令牌，而无需前往浏览器撤销原始令牌，您可以使用 approval_prompt 参数通过访问以下生成的 url 来获取新的刷新令牌：

url = token.generate_authorize_url(
    redirect_uri='urn:ietf:wg:oauth:2.0:oob',
    approval_prompt='force')