使用Google People API获取Google联系人真实最后修改时间的更佳方法

针对你遇到的Google后台操作导致updateTime虚高、引发不必要同步的问题，可以通过以下几种方式优化：

• 筛选可信的来源记录：遍历person.metadata.sources时，只取source.type为CONTACT的条目。这类来源对应用户直接创建/编辑的联系人，其updateTime更贴近用户实际修改时间，后台系统维护的其他来源（如自动同步的第三方数据）可以直接忽略。
• 用ETag做变更校验：除了updateTime，同时记录每个联系人的person.etag字段。如果某次获取到的updateTime晚于本地记录，但etag和本地存储的完全一致，说明只是Google后台的无数据变更操作，无需执行同步。
• 改用增量同步接口：调用people.connections.list接口时，传入updatedMin参数（设置为上次同步的时间），同时利用syncToken实现增量同步。Google的增量同步逻辑会自动过滤掉仅后台操作、无实际数据变更的联系人，从根源减少无效同步。

Java代码示例（增量同步） #

// 初始化PeopleService
PeopleService peopleService = initializePeopleService();

ListConnectionsRequest request = peopleService.people().connections()
        .list("people/me")
        .setPersonFields("metadata,names,emailAddresses")
        .setUpdatedMin(LAST_SYNC_TIMESTAMP) // 上次同步的时间，格式为RFC3339
        .setSyncToken(LAST_SYNC_TOKEN); // 上次同步返回的syncToken

ListConnectionsResponse response = request.execute();
List<Person> connections = response.getConnections();

// 处理获取到的变更联系人
for (Person person : connections) {
    // 获取可信的updateTime
    String realUpdateTime = null;
    for (Source source : person.getMetadata().getSources()) {
        if ("CONTACT".equals(source.getType())) {
            realUpdateTime = source.getUpdateTime();
            break;
        }
    }
    // 结合etag校验后执行同步逻辑
    if (!person.getEtag().equals(localEtagMap.get(person.getResourceName()))) {
        // 执行同步操作
        syncContactToLocal(person, realUpdateTime);
    }
}

// 更新本地存储的syncToken和同步时间
LAST_SYNC_TOKEN = response.getNextSyncToken();
LAST_SYNC_TIMESTAMP = Instant.now().toString();

内容的提问来源于stack exchange，提问作者Eric S