Google API

借助 Google API 包，您可以在 Dart 项目中使用数十种 Google 服务。

本页介绍了如何通过 Google 身份验证使用与最终用户数据交互的 API。

用户数据 API 的示例包括日历、Gmail、YouTube 和 Firebase。

要显式地为 Firebase 添加身份验证，请查阅 使用 FirebaseUI 将用户身份验证流添加到 Flutter 应用 codelab 以及 Flutter Firebase 身份验证入门 文档。

要使用 Google API，请按照以下步骤操作

1. 选择所需的 API
2. 启用 API
3. 使用所需的范围对用户进行身份验证
4. 获取已验证的 HTTP 客户端
5. 创建并使用所需的 API 类

package:googleapis 的文档将每个 API 列为一个单独的 Dart 库，采用 name_version 格式。请查看 youtube_v3 作为示例。

每个库可能提供多种类型，但有一个以 Api 结尾的根类。对于 YouTube，它是 YouTubeApi。

Api 类不仅是您需要实例化的类（参见第 3 步），它还公开了表示使用 API 所需权限的范围。例如，YouTubeApi 类的常量部分列出了可用的范围。要请求读取（但不能写入）最终用户 YouTube 数据的权限，请使用 youtubeReadonlyScope 对用户进行身份验证。

/// Provides the `YouTubeApi` class.
import 'package:googleapis/youtube/v3.dart';

要使用 Google API，您必须拥有一个 Google 账号和一个 Google 项目。您还需要启用所需的 API。

此示例启用YouTube Data API v3。有关详细信息，请参阅入门说明。

使用 google_sign_in 包通过 Google 身份验证用户。为每个您希望支持的平台配置登录。

/// Provides the `GoogleSignIn` class
import 'package:google_sign_in/google_sign_in.dart';

实例化 GoogleSignIn 类时，请提供上一节中讨论的所需范围。

final _googleSignIn = GoogleSignIn(
  scopes: <String>[YouTubeApi.youtubeReadonlyScope],
);

按照 package:google_sign_in 提供的说明允许用户进行身份验证。

身份验证成功后，您必须获取一个已验证的 HTTP 客户端。

extension_google_sign_in_as_googleapis_auth 包在 GoogleSignIn 上提供了一个名为 authenticatedClient 的扩展方法。

import 'package:extension_google_sign_in_as_googleapis_auth/extension_google_sign_in_as_googleapis_auth.dart';

为 onCurrentUserChanged 添加一个监听器，当事件值不为 null 时，您可以创建一个已验证的客户端。

var httpClient = (await _googleSignIn.authenticatedClient())!;

此 Client 实例在调用 Google API 类时包含必要的凭据。

使用 API 创建所需的 API 类型并调用方法。例如

var youTubeApi = YouTubeApi(httpClient);

var favorites = await youTubeApi.playlistItems.list(
  ['snippet'],
  playlistId: 'LL', // Liked List
);

您可能还想查看以下内容

• extension_google_sign_in_as_googleapis_auth 示例是本页所描述概念的一个可行实现。