GSP154

概览

Google Cloud Video Intelligence 助您通过简单易用的 REST API 提取元数据，让视频更容易被搜索和发现。您现在可以搜索目录中每个视频文件的每个时刻。该 API 可快速为存储在 Cloud Storage 中的视频添加注释，并帮助您确定视频中的重要实体（名词），以及这些实体在视频中出现的时间。该 API 还可以在整个视频内检索相关信息，精确到一个镜头或一帧，从而将信号与杂讯相分离。

设置和要求

点击“开始实验”按钮前的注意事项

请阅读以下说明。实验是计时的，并且您无法暂停实验。计时器在您点击开始实验后即开始计时，显示 Google Cloud 资源可供您使用多长时间。

此实操实验可让您在真实的云环境中开展实验活动，免受模拟或演示环境的局限。我们会为您提供新的临时凭据，让您可以在实验规定的时间内用来登录和访问 Google Cloud。

为完成此实验，您需要：

• 能够使用标准的互联网浏览器（建议使用 Chrome 浏览器）。

注意：请使用无痕模式或无痕浏览器窗口运行此实验。这可以避免您的个人账号与学生账号之间发生冲突，这种冲突可能导致您的个人账号产生额外费用。

• 完成实验的时间 - 请注意，实验开始后无法暂停。

注意：如果您已有自己的个人 Google Cloud 账号或项目，请不要在此实验中使用，以避免您的账号产生额外的费用。

如何开始实验并登录 Google Cloud 控制台

1. 点击开始实验按钮。如果该实验需要付费，系统会打开一个弹出式窗口供您选择付款方式。左侧是实验详细信息面板，其中包含以下各项：

   • 打开 Google 控制台按钮
   • 剩余时间
   • 进行该实验时必须使用的临时凭据
   • 帮助您逐步完成本实验所需的其他信息（如果需要）

2. 点击打开 Google 控制台。 该实验会启动资源并打开另一个标签页，显示登录页面。

   提示：请将这些标签页安排在不同的窗口中，并将它们并排显示。

   注意：如果您看见选择帐号对话框，请点击使用其他帐号。

3. 如有必要，请从实验详细信息面板复制用户名，然后将其粘贴到登录对话框中。点击下一步。

4. 请从实验详细信息面板复制密码，然后将其粘贴到欢迎对话框中。点击下一步。

   重要提示：您必须使用左侧面板中的凭据。请勿使用您的 Google Cloud Skills Boost 凭据。 注意：在本次实验中使用您自己的 Google Cloud 帐号可能会产生额外费用。

5. 继续在后续页面中点击以完成相应操作：

   • 接受条款及条件。
   • 由于该帐号为临时帐号，请勿添加帐号恢复选项或双重验证。
   • 请勿注册免费试用。

片刻之后，系统会在此标签页中打开 Cloud 控制台。

注意：您可以点击左上角的导航菜单来查看列有 Google Cloud 产品和服务的菜单。

激活 Cloud Shell

Cloud Shell 是一种装有开发者工具的虚拟机。它提供了一个永久性的 5GB 主目录，并且在 Google Cloud 上运行。Cloud Shell 提供可用于访问您的 Google Cloud 资源的命令行工具。

1. 点击 Google Cloud 控制台顶部的激活 Cloud Shell 。

如果您连接成功，即表示您已通过身份验证，且当前项目会被设为您的 PROJECT_ID 环境变量所指的项目。输出内容中有一行说明了此会话的 PROJECT_ID：

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud 是 Google Cloud 的命令行工具。它已预先安装在 Cloud Shell 上，且支持 Tab 自动补全功能。

2. （可选）您可以通过此命令列出活跃账号名称：

gcloud auth list

3. 点击授权。

4. 现在，输出的内容应如下所示：

输出：

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`

5. （可选）您可以通过此命令列出项目 ID：

gcloud config list project

输出：

[core] project = <project_ID>

输出示例：

[core] project = qwiklabs-gcp-44776a13dea667a6 Note: For full documentation of gcloud, in Google Cloud, refer to the gcloud CLI overview guide.

任务 1. 启用 Video Intelligence API

本实验已为您启用 Cloud Video Intelligence API。

任务 2. 设置授权

本实验需要创建和使用一个绑定到您的 Google Cloud 项目的服务账号，从而进行授权。

1. 在 Cloud Shell 中，运行以下命令新建名为 quickstart 的服务账号：

gcloud iam service-accounts create quickstart

2. 运行以下命令，并将 <your-project-123> 替换为您的项目 ID，以创建服务账号的密钥文件：

gcloud iam service-accounts keys create key.json --iam-account quickstart@<your-project-123>.iam.gserviceaccount.com

3. 现在，传递您的服务账号密钥文件的位置，为您的服务账号进行身份验证：

gcloud auth activate-service-account --key-file key.json

4. 使用您的服务账号获取授权令牌：

gcloud auth print-access-token

令牌会显示在输出中，您在后面的步骤中需要使用该令牌。

点击检查我的进度以验证是否完成了以下目标： 设置授权

任务 3. 发出视频注释请求

1. 运行以下命令，创建一个包含如下文本的 JSON 请求文件，并将其存储为 request.json：

cat > request.json <<EOF { "inputUri":"gs://spls/gsp154/video/train.mp4", "features": [ "LABEL_DETECTION" ] } EOF 注意： 为了使流程更简单，我们使用您的项目可用的一个关于火车的公开视频作为 inputUri 的值。如果您有自己的偏好或者是在个人项目中运行实验，可改为使用任何视频，只需将其上传到 Cloud Storage 并提供其 Cloud Storage URI（格式：gs://bucket/object）作为 inputUri 的值即可。

2. 使用 curl 发出 videos:annotate 请求，并传递实体请求的文件名：

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/videos:annotate' \ -d @request.json

Video Intelligence API 会创建一个操作来处理您的请求。您现在应该会看到类似于以下示例的响应，其中包含操作名称：

{ "name": "projects/474887704060/locations/asia-east1/operations/16366331060670521152" }

您在下一步中需要使用上述操作名称、位置和项目。

3. 您可以调用 v1.operations 端点并使用以下脚本来请求有关操作的信息。请将 PROJECTS、LOCATIONS 和 OPERATION_NAME 替换为您使用上一个命令获取的值：

curl -s -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$(gcloud auth print-access-token)'' \ 'https://videointelligence.googleapis.com/v1/projects/PROJECTS/locations/LOCATIONS/operations/OPERATION_NAME'

您将看到与您操作相关的信息。如果操作完成，结果中会包含设为 true 的 done 字段：

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.Annota tionProgressMetadata", "progressMetadata": [ { "inputUri": "gs://spls/gsp154/video/train.mp4", "startTime": "2016-09-22T21:41:56.766091Z", "lastUpdateTime": "2016-09-22T21:42:03.889743Z" } ] }, ... }

4. 在发出请求一段时间后（通常约为一分钟），重新运行该命令，同一请求会返回加注释的结果：

{ "name": "projects/425437283751/locations/asia-east1/operations/17938636079131796601", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/spls/gsp154/video/train.mp4", "progressPercent": 100, "startTime": "2017-02-17T22:39:00.333942Z", "updateTime": "2017-02-17T22:39:11.414399Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/spls/gsp154/video/train.mp4", "segmentLabelAnnotations": [ { "entity": { "entityId": "/m/01yrx", "languageCode": "en-US" }, "segments": [ { "segment": { "startTimeOffset": "0s", "endTimeOffset": "14.833664s" }, "confidence": 0.98509187 } ] }, ...

您已向 Cloud Video Intelligence API 发送了您的第一个请求。

点击检查我的进度以验证是否完成了以下目标： 发出视频注释请求

恭喜！

完成挑战任务

本自学实验是以下挑战任务的组成部分：基准：部署和开发以及基准：数据、机器学习和 AI。一项挑战任务就是一系列相关的实验，学习时按部就班地完成这些实验即可。完成挑战任务即可赢得一枚徽章，以表彰您取得的成就。您可以公开展示徽章，还可以在您的在线简历或社交媒体账号中加入指向徽章的链接。欢迎注册参加任何包含此实验的挑战任务，完成后就能立即获得相应的积分。请参阅 Google Cloud Skills Boost 目录，查看所有可参加的挑战任务。

后续步骤/了解详情

本实验是 Qwik Starts 系列实验的其中一项。通过这些实验，您可以一窥 Google Cloud 的诸多功能。请在 Google Cloud Skills Boost 目录中搜索“Qwik Starts”，找到您要参与的下一项实验！

Google Cloud 培训和认证

…可帮助您充分利用 Google Cloud 技术。我们的课程会讲解各项技能与最佳实践，可帮助您迅速上手使用并继续学习更深入的知识。我们提供从基础到高级的全方位培训，并有点播、直播和虚拟三种方式选择，让您可以按照自己的日程安排学习时间。各项认证可以帮助您核实并证明您在 Google Cloud 技术方面的技能与专业知识。

上次更新手册的时间：2023 年 9 月 13 日

上次测试实验的时间：2023 年 12 月 22 日

版权所有 2024 Google LLC 保留所有权利。Google 和 Google 徽标是 Google LLC 的商标。其他所有公司名和产品名可能是其各自相关公司的商标。