通过Google Apps脚本在People API中创建新联系人时,如何从响应体中访问”resourceName”
介绍
在Google Apps脚本中,可以使用People API创建新的联系人。当成功创建联系人后,People API会返回一个响应体,其中包含了一些有用的信息,如联系人的资源名称(resource name)。本文将详细介绍如何从响应体中访问资源名称(resource name),以便在脚本中进一步使用。
步骤
下面将按照以下步骤详细说明如何通过Google Apps脚本访问People API的响应体中的资源名称。
1. 开启People API
在开始之前,您需要确保已经在Google Cloud Console中启用了People API。
- 打开Google Cloud Console(https://console.developers.google.com/)
- 在项目选择器中选择您想要使用的项目
- 在导航菜单中选择”API和服务”,然后点击”库”
- 搜索并选择”People API”
- 点击”启用”按钮以启用API
2. 创建新的联系人
在您的Google Apps脚本中,您可以使用People API的People.People.createContact
方法来创建新的联系人。以下是一个示例代码:
function createNewContact() {
var resource = {
"names": [
{
"givenName": "John",
"familyName": "Doe"
}
],
"emailAddresses": [
{
"value": "johndoe@example.com"
}
]
};
var response = People.People.createContact(resource);
Logger.log(response);
}
在上面的例子中,我们创建了一个名为createNewContact
的函数,在该函数中,我们定义了要创建的联系人的一些属性,如给定名(given name)和姓氏(family name)以及电子邮件地址(email address)。
通过调用People.People.createContact
方法并传递资源(resource)作为参数,我们可以创建新的联系人。该方法将返回一个响应体(response),其中包含了一些有用的信息,如资源名称(resource name)和联系人的其他属性。
3. 访问资源名称
要访问People API响应体中的资源名称,您可以通过以下步骤进行:
- 使用
getResponseText()
方法获取响应体的文本表示形式。 - 解析响应体文本为JSON格式。
- 从JSON数据中提取资源名称字段。
以下是具体的代码示例:
function createNewContact() {
// ... 创建新的联系人的代码 ...
var response = People.People.createContact(resource);
var responseBody = response.getContentText(); // 获取响应体的文本表示形式
var responseObject = JSON.parse(responseBody); // 解析响应体为JSON格式
var resourceName = responseObject.resourceName; // 提取资源名称字段
Logger.log("Resource Name: " + resourceName);
}
在上述代码中,我们首先获取响应体的文本表示形式,然后使用JSON
对象的parse()
方法将其解析为JSON格式。最后,我们通过访问解析后的JSON对象中的resourceName
字段,获取到联系人的资源名称。
4. 使用资源名称
一旦您成功访问到了资源名称,您就可以根据需要在脚本中进一步使用它。例如,您可以将资源名称保存到变量中,以后方便使用。
function createNewContact() {
// ... 创建新的联系人的代码 ...
var response = People.People.createContact(resource);
var responseBody = response.getContentText();
var responseObject = JSON.parse(responseBody);
var resourceName = responseObject.resourceName;
// 使用资源名称进行其他操作
// 例如,更新联系人信息或将其添加到其他Google服务中
// ...
}
结论
通过Google Apps脚本访问People API响应体中的资源名称并不难。通过正确处理API响应体,您可以轻松地从中提取出资源名称并在脚本中进一步使用。