借助批处理请求,服务器可以通过单个 HTTP 请求执行多项操作,从而提高应用响应速度。如需执行批量操作,请创建联系人 Feed 并为每项操作添加一个条目。
批量请求最多只能包含 100 项操作。如需了解详情,请参阅 Google Data Protocol 中的批处理。 更改最长可能需要 24 小时才会反映在自动补全功能和联系人管理器中。
以下代码示例展示了一个用于创建 2 个共享联系人的批量请求。批量请求还可以查询、更新和删除联系人。更新和删除条目需要用于乐观并发的编辑链接。
<?xml version='1.0' encoding='UTF-8'?> <feed xmlns='http://www.w3.org/2005/Atom' xmlns:gContact='http://schemas.google.com/contact/2008' xmlns:gd='http://schemas.google.com/g/2005' xmlns:batch='http://schemas.google.com/gdata/batch'> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2008#contact' /> <entry> <batch:id>1</batch:id> <batch:operation type='insert' /> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2008#contact'/> <gd:name> <gd:givenName>FIRST_NAME</gd:fullName> <gd:familyName>LAST_NAME</gd:fullName> </gd:name> <gd:email rel='http://schemas.google.com/g/2005#home' address='EMAIL_ADDRESS' primary='true'/> </entry> <entry> <batch:id>2</batch:id> <batch:operation type='insert' /> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2008#contact'/> <gd:name> <gd:givenName>FIRST_NAME</gd:fullName> <gd:familyName>LAST_NAME</gd:fullName> </gd:name> <gd:email rel='http://schemas.google.com/g/2005#home' address='EMAIL_ADDRESS' primary='true'/> </entry> </feed>
替换以下内容:
FIRST_NAME:联系人的名字。LAST_NAME:联系人的姓氏。EMAIL_ADDRESS:首选电子邮件地址。