Google 人物 API / 其他联系人 - 如何获取其他联系人的照片？

Question

Google 迫使我们从已弃用的联系人 API 迁移到新人员 API。

他们甚至在人们 API 中实现了“其他联系人”功能，这是非常需要的。

但是现在我遇到了另一个问题——无法获取人物中其他联系人的照片API。

我正在深入研究这个问题，发现可以将 photos 添加到 readMask 中（即使没有记录）：

https://people.googleapis.com/v1/otherContacts?access_token=<...>&readMask=emailAddresses,names,photos

...但这无济于事，因为它 returns 所有联系人的首字母默认图片，即使是拥有真实照片的联系人。就像这个：https://lh3.googleusercontent.com/cm/ABXenNkcRSTRZU8PEFQfJtaeEBZnxLgN-UO555npUt1idzcMohoSGuJFfKx0JX2AR6Qp=s100

我试图将 coverPhotos 添加到 readMask 中，但它没有放在那里。

然后我在检查旧联系人 API 格式化照片 url 的时间并找出格式：

https://www.google.com/m8/feeds/photos/media/<user-email-address>/<contact-id>

但是它有两个缺点：

必须使用 access_token
仅当联系人上传自定义照片时有效，否则returns错误

所以这是我的问题：

有没有更简单更干净的方法来获取People中其他联系人的真实照片API？

Answer 1

otherContacts.list 方法接受的 readMask 字段如下：

emailAddresses
metadata
names
phoneNumbers
photos

如您所见，photos 字段在发出上述请求时是一个被接受的字段。

但是，返回的响应应该会产生一个 url，它将您重定向到用户的个人资料图片。因此，我借此机会在 Google 的问题跟踪器 here 上报告了它。我建议您给问题加注星标，因为有关此问题的任何更新都会发布在那里。

参考

Answer 2

这个错误已经解决，现在我们有了解决方案！

更新文档：https://developers.google.com/people/api/rest/v1/otherContacts/list

有一个新的 sources[] 请求参数。要获取“其他联系人”的真实照片，您需要指定 2 个值：READ_SOURCE_TYPE_CONTACT 和 READ_SOURCE_TYPE_PROFILE。

请求将如下所示：

GET https://people.googleapis.com/v1/otherContacts?readMask=photos&key=API_KEY&sources=READ_SOURCE_TYPE_CONTACT&sources=READ_SOURCE_TYPE_PROFILE

现在某些联系人将在 photos 数组中包含 2 个条目：

photos: [
  {
    metadata: {
      primary: true,
      source: {
        type: "PROFILE",
        id: "11111"
      }
    },
    url: "<THIS IS THE REAL PROFILE PICTURE>"
  },
  {
    metadata: {
      source: {
        type: "OTHER_CONTACT",
        id: "6666666"
      }
    },
    url: "<THIS IS THE DEFAULT PHOTO STUB>",
    default: true
  }
]

Google 人物 API / 其他联系人 - 如何获取其他联系人的照片？

Google People API / Other Contacts - how to get photos of other contacts?

google-api

google-contacts-api

google-photos-api

google-people-api

参考