此页面由 Cloud Translation API 翻译。

Python 快速入门

快速入门介绍了如何设置和运行调用 Google Workspace API。

Google Workspace 快速入门使用 API 客户端库来处理一些身份验证和授权流程的详细信息。我们建议您需要为自己的应用使用客户端库本快速入门使用适用于测试的简化身份验证方法环境对于生产环境，我们建议您了解身份验证和授权早于选择访问凭据适合您应用的广告格式

创建一个向 Google 表单 API 发出请求的 Python 命令行应用。

目标

设置环境。
安装客户端库。
设置示例。
运行该示例。

前提条件

如需运行本快速入门，您需要满足以下前提条件：

Python 3.10.7 或更高版本
pip 软件包管理工具
Google Cloud 项目。

Google 账号。

设置环境

如需完成本快速入门，请设置您的环境。

启用 API

在使用 Google API 之前，您需要先在 Google Cloud 项目中启用这些 API。您可以在单个 Google Cloud 项目中启用一个或多个 API。

在 Google Cloud 控制台中，启用 Google Form API。

启用 API

配置 OAuth 权限请求页面

如果您使用新的 Google Cloud 项目来完成本快速入门，请配置 OAuth 权限请求页面，并将您自己添加为测试用户。如果您已经已完成此步骤，请跳到下一部分。

在 Google Cloud 控制台中，点击“菜单”图标 > API 和服务 > OAuth 同意屏幕。
转到 OAuth 同意屏幕
对于用户类型，选择内部，然后点击创建。
填写应用注册表单，然后点击保存并继续。
现在，您可以跳过添加范围的步骤，然后点击保存并继续。以后，如果您要创建一款应用供用户使用 Google Workspace 组织，您必须将用户类型更改为外部，然后执行以下操作：添加您的应用所需的授权范围。
查看您的应用注册摘要。如要进行更改，请点击修改。如果应用点击 Back to Dashboard（返回信息中心）。

为桌面应用授权凭据

如需对最终用户进行身份验证并访问应用中的用户数据，您需要执行以下操作：创建一个或多个 OAuth 2.0 客户端 ID。客户端 ID 用于标识连接到 Google OAuth 服务器。如果您的应用在多个平台上运行您必须为每个平台创建一个单独的客户端 ID。

在 Google Cloud 控制台中，依次点击“菜单”图标 > API 和服务 > 凭据。
进入“凭据”页面
依次点击创建凭据 > OAuth 客户端 ID。
依次点击应用类型 > 桌面应用。
在名称字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。
点击创建。系统会显示“OAuth 客户端创建”屏幕，其中显示了您的新客户端 ID 和客户端密钥。
点击 OK。新创建的凭据会显示在 OAuth 2.0 客户端 ID 下。
将下载的 JSON 文件保存为 credentials.json，并将复制到您的工作目录中。

安装 Google 客户端库

安装 Python 版 Google 客户端库：

pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

配置示例

在您的工作目录中，创建一个名为 quickstart.py 的文件。

在 quickstart.py 中添加以下代码：

forms/quickstart/quickstart.py

在 GitHub 上查看

from apiclient import discovery
from httplib2 import Http
from oauth2client import client, file, tools

SCOPES = "https://www.googleapis.com/auth/forms.body"
DISCOVERY_DOC = "https://forms.googleapis.com/$discovery/rest?version=v1"

store = file.Storage("token.json")
creds = None
if not creds or creds.invalid:
  flow = client.flow_from_clientsecrets("client_secrets.json", SCOPES)
  creds = tools.run_flow(flow, store)

form_service = discovery.build(
    "forms",
    "v1",
    http=creds.authorize(Http()),
    discoveryServiceUrl=DISCOVERY_DOC,
    static_discovery=False,
)

# Request body for creating a form
NEW_FORM = {
    "info": {
        "title": "Quickstart form",
    }
}

# Request body to add a multiple-choice question
NEW_QUESTION = {
    "requests": [
        {
            "createItem": {
                "item": {
                    "title": (
                        "In what year did the United States land a mission on"
                        " the moon?"
                    ),
                    "questionItem": {
                        "question": {
                            "required": True,
                            "choiceQuestion": {
                                "type": "RADIO",
                                "options": [
                                    {"value": "1965"},
                                    {"value": "1967"},
                                    {"value": "1969"},
                                    {"value": "1971"},
                                ],
                                "shuffle": True,
                            },
                        }
                    },
                },
                "location": {"index": 0},
            }
        }
    ]
}

# Creates the initial form
result = form_service.forms().create(body=NEW_FORM).execute()

# Adds the question to the form
question_setting = (
    form_service.forms()
    .batchUpdate(formId=result["formId"], body=NEW_QUESTION)
    .execute()
)

# Prints the result to show the question has been added
get_result = form_service.forms().get(formId=result["formId"]).execute()
print(get_result)

运行示例

在您的工作目录中，构建并运行该示例：
```
python3 quickstart.py
```

首次运行该示例时，它会提示您授予访问权限： <ph type="x-smartling-placeholder">
1. 如果您尚未登录 Google 账号，请在系统提示时登录。如果如果您登录了多个账号，请选择一个用于授权的账号。
2. 点击接受。
您的 Python 应用运行并调用 Google 表单 API。

授权信息存储在文件系统中，因此下次运行该示例时则系统不会提示您授权。