我正在按照Google的要求从Contacts API过渡到People API。我很惊讶网上没有示例，但我现在可以创建、删除和修改/更新（感谢@Tanaike回复Omar F. here：Cannot update contactusgin People api using Google Apps Script）联系人，可以通过迭代People. People. Connections. List（）进行删除和修改，最多可获得100个结果（来自此处的应用程序脚本示例：https://developers.google.com/people/quickstart/apps-script）。
但是我有大约12,000个联系人，需要使用（我假设）People.People.searchContacts()，我还没有找到任何应用程序脚本的例子，文档都是Java的，我不知道如何翻译成应用程序脚本：

...

// Send search request
SearchResponse response = peopleService.people().searchContacts()
    .setQuery("query")
    .setReadMask("names,emailAddresses")
    .execute();

或"协议"，这同样没有用（对我来说-我已经尝试过了!）：

...
// Send search request after several seconds
GET /v1/people:searchContacts?query=query&readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com

我最好的猜测是使用Google云端硬盘查询参数样式，因为此页面的People API链接（https://developers.google.com/people/v1/query-parameters）似乎没有帮助：

let searchResp = People.People.searchContacts(
    "phoneNumbers contains 5632",
    { readMask: "names,phoneNumbers,addresses,emailAddresses" }
  );

let personBob = searchResp.results.find(p =>
    p.names[0].displayName.includes("Bob Q22222")
  );

因此，在花了大量令人尴尬的时间讨论到这一点之后，我认输了，希望有人能给出一个通过People.People.searchContacts()获得searchResponse的示例来说明
1.搜索查询类似于和

1. readMask是什么样子的。
   我知道searchResponse.results只是一个人的数组，从那里应该没问题。
   谢谢你，我希望这不是太华夫饼干（困惑非程序员为我们的小丈夫和妻子的业务）。

编辑：快到了

根据Rafi的回复修改，这是从一个表单附加的Appscript文件开始的，这是我想要的***但是***它没有检索所有结果，请参见下文）：

function run() {
  let query = "Q12755";
  let found = People.People.searchContacts({
    "query": query,
    "readMask": "names,addresses,emailAddresses,phoneNumbers"
  });

  if (found.results) {
    for (i = 0; i < found.results.length; i++) {
      let thisResult = found.results[i];
      Logger.log(`Result ${i}: ${thisResult.person.names[0].displayName}`);
    }
  } else {
    Logger.log(`No results for ${query}`);
  }
}

......但是，它没有收集所有结果。

"Q12755"查询的测试函数和结果：

Google联系人中该字符串的两个结果：

在我的手机上有两个相同的结果：

***知道为什么没有检索到所有结果吗？***我测试了几个查询，它总是错过结果。所有（我相信）测试的联系人都是通过Appscript脚本通过弃用的联系人API创建的。

另外，我想补充的是，它只检索一个结果并不是一个问题，在其他情况下，"应该"有20个结果，在检索了半打左右。
P.P.S.建议/要求对缓存进行"预热"，我假设下面的更新脚本可以完成这一操作，结果没有任何差异：

function run() {
  let blankQueryForWarmUp = "";
  let found = People.People.searchContacts({
    "query": blankQueryForWarmUp,
    "readMask": "names,addresses,emailAddresses,phoneNumbers"
  });

  Utilities.sleep(5000);

  let query = "Q12755";
  found = People.People.searchContacts({
    "query": query,
    "readMask": "names,addresses,emailAddresses,phoneNumbers"
  });

  if (found.results) {
    for (i = 0; i < found.results.length; i++) {
      let thisResult = found.results[i];
      Logger.log(`Result ${i}: ${thisResult.person.names[0].displayName}`);
    }
  } else {
    Logger.log(`No results for ${query}`);
  }
}