Google Calendar API v3搜索privateExtendedProperty无匹配结果问题求助

问题还原 #

我在使用Google Calendar API v3搜索带有特定私有扩展属性的事件，已经成功给目标事件添加了如下私有扩展属性：

{
  "kind": "calendar#events",
  "etag": "\"p33cf16d5ousve0g\"",
  "summary": "Ryan's Personal Camptivities",
  "updated": "2022-04-29T15:11:23.687Z",
  "timeZone": "America/Los_Angeles",
  "accessRole": "owner",
  "defaultReminders": [
    {
      "method": "popup",
      "minutes": 10
    }
  ],
  "nextSyncToken": "CNjwmaXHufcCENjwmaXHufcCGAUg67Ly0wE=",
  "items": [
    {
      "extendedProperties": {
        "private": {
          "OutlookEventGO": "AAMkADNkODYzZGQ5LWY5ZGItNGFjZi1iMWMzLTI3MmY0YmIxMTcxNQBGAAAAAAC5E322QQ7ORLEmN7zGNq0zBwAUl432Bg61QItQhHQwcosuAAAAAAENAAAUl432Bg61QItQhHQwcosuAAF6QI0zAAA="
        }
      }
    }
  ]
}

但调用以下搜索接口时，返回的items数组是空的，完全匹配不到目标事件：

https://www.googleapis.com/calendar/v3/calendars/ryan%40camptivities.com/events?privateExtendedProperty=OutlookEventGO%3DAAMkADNkODYzZGQ5LWY5ZGItNGFjZi1iMWMzLTI3MmY0YmIxMTcxNQBGAAAAAAC5E322QQ7ORLEmN7zGNq0zBwAUl432Bg61QItQhHQwcosuAAAAAAENAAAUl432Bg61QItQhHQwcosuAAF6QI0zAAA%3D

接口返回内容：

{
  "kind": "calendar#events",
  "etag": "\"p33cf16d5ousve0g\"",
  "summary": "Ryan's Personal Camptivities",
  "updated": "2022-04-29T15:11:23.687Z",
  "timeZone": "America/Los_Angeles",
  "accessRole": "owner",
  "defaultReminders": [
    {
      "method": "popup",
      "minutes": 10
    }
  ],
  "nextSyncToken": "CNjwmaXHufcCENjwmaXHufcCGAUg67Ly0wE=",
  "items": []
}

问题根源：扩展属性值的双重编码需求 #

没错，这就是编码问题导致的！原因在于Google Calendar API对privateExtendedProperty参数的解析逻辑：

这个参数的格式是privateExtendedProperty=key=value，当你传递参数时，API会先对整个参数做一次URL解码。你现在只对值里的=做了一次编码（变成%3D），解码后会还原成=，这时候API会错误地把值里的=当成键值对的分隔符，导致它实际搜索的是OutlookEventGO=AAMkADNk...AAA，而不是完整的属性值，自然匹配不到。

修复步骤 #

你需要对扩展属性的值做双重URL编码，具体操作如下：

1. 先单独对属性值AAMkADNkODYzZGQ5LWY5ZGItNGFjZi1iMWMzLTI3MmY0YmIxMTcxNQBGAAAAAAC5E322QQ7ORLEmN7zGNq0zBwAUl432Bg61QItQhHQwcosuAAAAAAENAAAUl432Bg61QItQhHQwcosuAAF6QI0zAAA=做一次URL编码，得到：

   AAMkADNkODYzZGQ5LWY5ZGItNGFjZi1iMWMzLTI3MmY0YmIxMTcxNQBGAAAAAAC5E322QQ7ORLEmN7zGNq0zBwAUl432Bg61QItQhHQwcosuAAAAAAENAAAUl432Bg61QItQhHQwcosuAAF6QI0zAAA%253D
   

   （注意最后原来的=变成了%253D，这是因为第一次编码把=转成%3D，第二次编码又把%转成%25）
2. 把编码后的值拼到参数中，形成：

   privateExtendedProperty=OutlookEventGO=AAMkADNkODYzZGQ5LWY5ZGItNGFjZi1iMWMzLTI3MmY0YmIxMTcxNQBGAAAAAAC5E322QQ7ORLEmN7zGNq0zBwAUl432Bg61QItQhHQwcosuAAAAAAENAAAUl432Bg61QItQhHQwcosuAAF6QI0zAAA%253D
   

3. 最后再对整个参数字符串做一次URL编码（或者直接用HTTP客户端工具/库自动处理参数编码，比如Postman、Python的requests库，它们会帮你自动完成编码，避免手动出错）

修正后的完整请求URL应该是：

https://www.googleapis.com/calendar/v3/calendars/ryan%40camptivities.com/events?privateExtendedProperty=OutlookEventGO%3DAAMkADNkODYzZGQ5LWY5ZGItNGFjZi1iMWMzLTI3MmY0YmIxMTcxNQBGAAAAAAC5E322QQ7ORLEmN7zGNq0zBwAUl432Bg61QItQhHQwcosuAAAAAAENAAAUl432Bg61QItQhHQwcosuAAF6QI0zAAA%253D

额外排查点 #

如果还是不行，再检查这两个地方：

• 确认调用接口使用的日历ID和创建扩展属性时的日历ID完全一致（你的例子里是ryan@camptivities.com，看起来没问题，但再核对下）
• 确认扩展属性是private类型，你用的privateExtendedProperty参数是正确的；如果是公共扩展属性，才需要用extendedProperty参数

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