16.3 Connect GCP和BigQuery到Adobe Experience Platform

目标

  • 浏览Google Cloud Platform中的API和服务
  • 熟悉用于测试Google API的OAuth操场
  • 在Adobe Experience Platform中创建您的第一个BigQuery连接

上下文

Adobe Experience Platform在​Sources​中提供一个连接器,帮助您将BigQuery数据集导入Adobe Experience Platform。 此数据连接器基于Google BigQuery API。 因此,正确准备Google Cloud Platform和BigQuery环境以接收来自Adobe Experience Platform的API调用非常重要。

要在Adobe Experience Platform中配置BigQuery源连接器,您需要以下4个值:

  • 项目
  • clientId
  • clientSecret
  • refreshToken

到目前为止,您只有第一个,项目ID。 此​项目ID​值是在练习16.1期间创建BigQuery项目时由Google生成的随机ID。

请将项目ID复制到分隔的文本文件中。

凭据 命名 示例
项目ID random commented-任务-306413

您可以随时通过单击顶部菜单栏中的​项目名称​检查项目ID:

演示

右侧将显示项目ID:

演示

在本练习中,您将学习如何获取其他3个必填字段:

  • clientId
  • clientSecret
  • refreshToken

16.3.1 Google Cloud API & Services

要开始,请返回Google Cloud Platform主页。 为此,只需单击屏幕左上角的徽标。

演示

进入主页后,转到左菜单并单击​API和服务,然后单击​仪表板

演示

您现在将看到​API和服务​主页。

演示

在本页中,您可以看到各种Google API连接的使用情况。 要设置API连接以便Adobe Experience Platform能够从BigQuery读取,您需要执行以下步骤:

  • 首先,您需要创建一个OAuth同意屏幕,以启用将来的身份验证。 谷歌的安全理由还要求在允许程序化访问之前,首先进行身份验证。
  • 其次,您需要API凭据(clientId和clientSecret),以用于API身份验证和访问BigQuery Connector。

16.3.2 OAuth同意屏幕

让我们开始创建OAuth同意屏幕。 在​API和服务​主页的左侧菜单中,单击​OAuth同意屏幕

演示

然后您将看到:

演示

选择用户类型:外部。 接下来,单击​创建

演示

然后,您将位于​OAuth同意屏幕配置​窗口中。

此处唯一要做的就是在​应用程序名称​字段中输入同意屏幕的名称,然后选择​用户支持电子邮件。 对于应用程序名称,请使用以下命名约定:

命名 示例
ldap - AEP BigQuery Connector vangeluw - Platform BigQuery Connector

演示

接下来,向下滚动直到您看到​开发人员联系信息​并填写电子邮件地址。

演示

单击​保存并继续

演示

然后你会看到这个。 单击​保存并继续

演示

然后你会看到这个。 单击​保存并继续

演示

然后你会看到这个。 单击​返回仪表板

演示

然后你会看到这个。 单击​发布应用程序

演示

单击​确认

演示

然后你会看到这个。

演示

在下一步中,您将完成API设置并获取您的API凭据。

16.3.3 Google API凭据:客户端密码和客户端ID

在左侧菜单中,单击​凭据。 然后您将看到:

演示

单击​+ CREATE CREDENTIALS​按钮。

演示

您将看到3个选项。 单击​OAuth客户端ID:

演示

在下一个屏幕中,选择​Web 应用程序

演示

将弹出多个新字段。 现在,您需要输入OAuth客户端ID的​名称,并输入​授权的重定向URI

请遵循以下命名规范:

字段 示例
名称 ldap - AEP BigQuery Connector vangeluw - Platform BigQuery Connector
已授权的重定向URI https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground

已授权重定向URI​字段非常重要,因为您以后需要它来获取完成Adobe Experience Platform中BigQuery源连接器的设置所需的RefreshToken。

演示

在继续之前,您需要在输入URL后实际按​Enter​按钮,以将值存储在​已授权的重定向URI​字段中。 如果未单击​Enter​按钮,则在稍后的​OAuth 2.0 Parkyand​中,您将遇到问题。

接下来,单击​创建:

演示

现在您将看到您的客户端ID和客户端机密。

演示

请复制这两个字段并将其粘贴到桌面上的文本文件中。 您始终可以在以后的阶段访问这些凭据,但如果将它们保存在BigQuery项目ID旁边的文本文件中,则会更轻松。

作为Adobe Experience Platform中BigQuery Source Connector设置的回顾,您现在已有以下值可用:

BigQuery连接器凭据
项目ID 您自己的项目ID(例如:commented-任务-306413)
clientid yourclientid
cillsecret yourclientsecret

您仍缺少​refreshToken。 由于安全原因,需要refreshToken。 在API领域,令牌通常每24小时过期一次。 因此,每24小时需要​refreshToken​刷新一次安全令牌,这样您的源连接器设置就可以继续连接到Google Cloud Platform和BigQuery。

16.3.4 BigQuery API和refreshToken

获取refreshToken以访问Google Cloud Platform API有多种方法。 其中一个选项是例如使用Postman。
但是,Google已经构建了一些更易于测试和使用其API的工具,该工具名为​OAuth 2.0 Parkyout

要访问​OAuth 2.0 Paryground,请转到https://developers.google.com/oauthplayground

然后,您将看到​OAuth 2.0 Playment​主页。

演示

单击屏幕右上方的​gear​图标:

演示

确保设置与上图中显示的设置相同。

多次检查设置以100%确定。

完成后,选中​使用您自己的OAuth凭据​复选框

演示

应显示两个字段,并且您有相应的值。

演示

请填写下表中的字段:

操场API设置 您的Google API凭据
OAuth客户端ID 您自己的客户端ID(在桌面上的文本文件中)
OAuth客户端机密 您自己的客户端机密(在桌面上的文本文件中)

演示

从您在桌面上创建的文本文件中复制​客户端ID​和​客户端机密

演示

填写完凭据后,请单击​关闭

演示

在左侧菜单中,您可以看到所有可用的Google API。 搜索​BigQuery API v2

演示

接下来,选择下图所示的范围:

演示

选择API后,应显示一个蓝色按钮,表示“授权API”。 单击它。

演示

选择用于设置GCP和BigQuery的Google帐户。

你可能会看到一个重大警告:未验证此应用程序。 这是因为您的Platform BigQuery Connector尚未得到正式审查,所以Google不知道它是否是正版应用程序。 您应忽略此通知。

单击​高级

演示

接下来,单击​转至ldap - AEP BigQuery Connector(insave)

演示

您将被重定向到您创建的OAuth同意屏幕。

演示

如果您使用双因素身份验证(2FA),请输入发送给您的验证代码。

演示

Google现在将向您显示八个不同的​Permission​提示。 单击​允许​获取所有八个权限请求。 (在API允许程序化请求之前,必须由真人遵循并确认一次此过程)

同样,将不显示​8个不同的弹出窗口,您必须单击​允许​以查看所有窗口。

演示

八次权限请求后,您将看到此概述。 单击​允许​完成该过程。

演示

在最后一次​Allow​单击后,您将被发送回OAuth 2.0 Playment,您将看到:

演示

单击​令牌的Exchange授权码

演示

几秒钟后,令牌​视图的​步骤2 - Exchange授权代码将自动关闭,您将看到​步骤3 — 配置对API的请求

您必须返回至令牌​​步骤2 Exchange授权码,因此请再次单击令牌​步骤2 Exchange授权码以可视化​刷新令牌​

演示

您现在将看到​刷新令牌

演示

复制​刷新令牌​并将其与其他BigQuery源连接器凭据一起粘贴到桌面上的文本文件中:

BigQuery源连接器凭据
项目ID 您自己的随机项目ID(例如:apt-summer-273608)
clientid yourclientid
cilsecret yourclientsecret
refrestok yourrefrestoken

接下来,让我们在Adobe Experience Platform中设置源连接器。

练习16.3.5 - Connect Platform与您自己的BigQuery表

通过转到以下URL登录Adobe Experience Platform:https://experience.adobe.com/platform

登录后,您将登录Adobe Experience Platform主页。

数据获取

在继续之前,您需要选择​沙箱。 要选择的沙箱名为--aepSandboxId--。 单击屏幕顶部蓝线中的文本​Production Prod​即可执行此操作。

数据获取

选择适当的沙箱后,屏幕会发生变化,现在您就位于专用沙箱中。

数据获取

在左侧菜单中,转到“源”。

演示

然后,您将看到​Sources​主页。 在​​菜单中,单击​数据库

演示

单击​Google BigQuery​卡。 接下来,单击​+ Configure

演示

您现在应创建新连接。

单击​新建帐户。 您现在需要根据您在GCP和BigQuery中进行的设置填写以下所有字段。

演示

让我们通过命名连接来开始:

请使用此命名规范:

BigQuery连接器凭据 示例
帐户名称 ldap - BigQuery连接 vangeluw - BigQuery连接
描述 ldap - BigQuery连接 vangeluw - BigQuery连接

这应该给你这样的东西:

演示

然后,填写存储在桌面上文本文件中的GCP和BigQuery API 帐户身份验证-details:

BigQuery连接器凭据
项目ID 您自己的随机项目ID(例如:apt-summer-273608)
clientId
clientSecret
refreshToken

您的​帐户身份验证-details现在应当如下:

演示

填写完所有这些字段后,单击​连接到源

演示

如果您的​帐户身份验证​详细信息已正确填写,您现在应通过查看​已连接​确认,看到一条可视确认消息,确认连接正常工作。

演示

现在已创建连接,请单击​下一步:

演示

您现在将看到在练习16.2期间创建的BigQuery数据集。

演示

干得好! 在下一个练习中,您将从该表加载数据,并将其映射到Adobe Experience Platform中的模式和数据集。

下一步:16.4将数据从BigQuery加载到Adobe Experience Platform

返回模块16

返回到所有模块

在此页面上