google-api - 如何在来自特定用户的 Google People API 响应中唯一标识个人资源？

Question

Google People API ，不像 Google Plus API不提供唯一的 id每个Person响应中的资源。

为什么这被弃用/删除以及如何唯一标识 Person在没有 id 的用户联系人列表中?

Answer 1

简而言之，使用 resourceName作为身份证。

Google People API 是用户的联系人列表，并具有特定于用户的 ID。他们可以创建只有邮寄地址或只有姓名而没有联系信息的联系人。 Google 无法从逻辑上整理所有 Google 通讯录用户的所有这些联系人。

特定联系人或用户有 resourceName唯一标识身份验证用户的资源(联系人)的字段。您基本上想将其用作 id .这是您使用的值，例如用于查询 People.get .

这是来自 People.connections 的单个联系人的示例响应的一部分:

  {
    "resourceName": "people/103710953423417258027",
    "etag": "qwApd98gduQ=",
    "metadata": {
        "sources": [{
            "type": "CONTACT",
            "id": "1",
            "etag": "#rj+KMFHVyHY="
        }, {
            "type": "PROFILE",
            "id": "103710953423417258027",
            "etag": "#4eZfef/IuMFw="
        }],
        "objectType": "PERSON"
    },
    ...
  }

resourceName本质上是该联系人的“id”，然后在 metadata该字段列出了联系人数据的来源。例如。 CONTACT用于用户手动输入姓名/电话/电子邮件/等的 Google 通讯录条目。 PROFILE是 Google 个人资料，通常包含 Google+ 数据。

Person resource docs是了解更多关于这些值(value)观的好地方。