Google People API联系人最后更新来源字段查询及同步循环问题

核心逻辑 #

你提出的通过Google联系人更新主体标识做过滤的方案可直接解决当前的循环同步问题，核心原理是区分「用户手动在Google端修改的更新」和「Podio同步服务通过API写入Google的更新」，仅对前者触发回Podio的同步流程。

具体落地步骤 #

• 优先利用Google Contacts原生元数据字段做判断：调用People API拉取联系人数据时，请求metadata字段，返回结果中sources数组的主联系人条目type可直接区分更新来源：值为API代表最后一次更新来自接口写入，值为CONTACT代表最后一次更新来自用户手动在Google端操作。
• 在Google侧更新回调的最前置位置加过滤逻辑：拉取触发回调的联系人最新元数据，若最后一次更新来源为API，直接终止流程，无需执行后续Podio同步操作。
• 兜底兼容方案：如果原生字段存在误判场景，可在通过Podio更新Google联系人时，额外写入一个自定义用户字段，比如userDefined中新增键为sync_source、值为podio的标识，回调时先检查该字段是否存在，存在则直接删除该标识同时终止同步流程，避免字段残留影响后续判断。

参考代码示例（Node.js） #

// Google联系人更新回调处理函数
async function handleGoogleContactUpdate(contactResourceName) {
  // 拉取联系人核心校验字段
  const contact = await people.people.get({
    resourceName: contactResourceName,
    personFields: 'metadata,userDefined',
  });
  const contactMetadata = contact.data.metadata;

  // 校验是否为Podio同步触发的API更新
  const isApiInitiated = contactMetadata.sources.some(source => 
    source.type === 'API' && source.updateTime === contactMetadata.updateTime
  );
  // 额外校验自定义同步标识
  const hasPodioSyncTag = contact.data.userDefined?.some(item => 
    item.key === 'sync_source' && item.value === 'podio'
  );

  if (isApiInitiated || hasPodioSyncTag) {
    // 存在API更新标识时直接终止流程，如有自定义标签需先清理避免残留
    if (hasPodioSyncTag) {
      await clearPodioSyncTag(contactResourceName);
    }
    return;
  }

  // 正常同步到Podio的业务逻辑
  await syncContactToPodio(contact.data);
}

内容的提问来源于stack exchange，提问作者Pete C