Contents

Google APIs

Contents

Google APIs 包提供了数十个 Google 服务，您可以在 Dart 项目中使用这些服务。

本页介绍如何使用与最终用户数据交互的 API，方法是使用 Google 身份验证。

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

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

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

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

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

dart/// 提供 `YouTubeApi` 类。
import 'package:googleapis/youtube/v3.dart';

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

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

使用google_sign_in 包使用用户的 Google 身份对用户进行身份验证。为要支持的每个平台配置登录。

dart/// 提供 `GoogleSignIn` 类
import 'package:google_sign_in/google_sign_in.dart';

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

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

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

身份验证后，您必须获取经过身份验证的 HTTP 客户端。

dartimport 'package:extension_google_sign_in_as_googleapis_auth/extension_google_sign_in_as_googleapis_auth.dart';

向onCurrentUserChanged 添加侦听器，当事件值不为 null 时，您可以创建经过身份验证的客户端。

dart

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

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

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

dartvar youTubeApi = YouTubeApi(httpClient);

var favorites = await youTubeApi.playlistItems.list(
  ['snippet'],
  playlistId: 'LL', // 收藏列表
);

您可能需要查看以下内容：

除非另有说明，否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。查看源代码或报告问题。

概述