Google Apps 脚本 - 联系人 - 查询多个字符串

Question

我正在编写一个脚本来删除和重新添加大约 100 个联系人。我对ContactsApp.getContactsByEmailAddress 有 12 种不同的搜索条件，最初知道这些条件需要 30 多秒才能运行。有什么方法我只能运行一次并搜索我的所有条件吗？我一直在寻找其他人尝试做同样的事情，但没有成功。

以下是我的函数中的搜索之一（重复 12 次，各种搜索词被传递给 ContactsApp.getContactsByEmailAddress）。我添加了try-catch 块，因为脚本在各种删除循环期间似乎无缘无故地抛出错误。

不胜感激。

var apa = ContactsApp.getContactsByEmailAddress('apa.')
  try{
for (var i in apa) {
apa[i].deleteContact()
}
  } catch(e){
      Logger.log(e)
}

Answer 1

使用Contacts Service，您只能使用一个搜索条件。因此，搜索多个模式的唯一方法是使用每个搜索参数调用一次该方法。幸运的是，您可以使用标准的编程实践来最大限度地减少重复代码的数量：

function getContactsWithEmails(emailSearchCriteria) {
  if (!emailSearchCriteria || !emailSearchCriteria.length)
    throw new Error("No search inputs given");

  // Collect the results of each search into a single Array.
  const matches = [];
  emailSearchCriteria.forEach(function (email) {
    var results = ContactsApp.getContactsByEmailAddress(email);
    if (results.length)
      Array.prototype.push.apply(matches, results);
    else
      console.log({message: "No results for search query '" + email + "'", query: email, resultsSoFar: matches});
  });

  return matches;
}

function deleteContacts(arrayOfContacts) {
  if (!arrayOfContacts || !arrayOfContacts.length)
    throw new Error("No contacts to delete");

  arrayOfContacts.forEach(function (contact) {
    ContactsApp.deleteContact(contact);
  });
}

// Our function that uses the above helper methods to do what we want.
function doSomething() {
  // Define all email searches to be performed.
  const emailFragmentsToSearchWith = [
    "email1",
    ...
    "emailN"
  ];
  const matchingContacts = getContactsWithEmails(emailFragmentsToSearchWith);
  if (matchingContacts.length) {
    /** do something with the contacts that matched the search.
     * someMethodThatSavesContacts(matchingContacts);
     * someMethodThatModifiesContacts(matchingContacts);
     * deleteContacts(matchingContacts);
     * ...
     */
  }
  /** do other stuff that doesn't need those contacts. */
}

this SO question 中提到的 Google Calendar v3 GData API 确实支持 multiple query parameters。但是，与此 API 没有简单的集成 - 您需要编写适当的 URL 请求并使用UrlFetchApp 执行它们。

除了 Google 联系人 API，您还可以使用 Google People REST API，特别是 people.connections#list 端点。

这两个 API 都要求您将您的 Apps 脚本项目与启用了相应 API 的 Google Cloud 项目相关联，并且可能需要您在其清单文件中手动设置您的 Apps 脚本项目所需的范围，此外为您向 API 端点发出的相关 HTTP 请求提供 OAuth2 授权。

参考文献

• Accessing External APIs
• Enabling Google APIs (steps 3-5)
• Google Contacts API v3
• Google People API
• Array#forEach