Nếu bạn đang thực hiện một số thao tác, thì thời gian gửi và nhận tất cả các thông báo HTTP đó có thể khiến ứng dụng của bạn bị chậm và không phản hồi. Với các yêu cầu hàng loạt, bạn có thể yêu cầu máy chủ thực hiện nhiều thao tác bằng một yêu cầu HTTP duy nhất. Ý tưởng cơ bản là bạn tạo một nguồn cấp dữ liệu danh bạ và thêm một mục nhập cho mỗi thao tác mà bạn muốn thực hiện.
Mỗi yêu cầu theo lô chỉ được thực hiện tối đa 100 thao tác. Bạn có thể tìm thêm thông tin về các thao tác hàng loạt trong phần Xử lý hàng loạt trong Giao thức dữ liệu của Google. Các thay đổi có thể mất đến 24 giờ mới được thể hiện trong tính năng tự động điền địa chỉ email và trình quản lý liên hệ.
Mẫu mã sau đây cho thấy một yêu cầu hàng loạt tạo 2 người liên hệ dùng chung; tuy nhiên, bạn cũng có thể sử dụng yêu cầu hàng loạt để truy vấn, cập nhật và xoá người liên hệ. Các mục cập nhật và xoá yêu cầu một đường liên kết chỉnh sửa để tính năng tính năng đồng thời lạc quan hoạt động.
<?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>
Thay thế nội dung sau:
FIRST_NAME
: Tên của người liên hệ được chia sẻ, ví dụ: Alex.LAST_NAME
: Họ của người liên hệ được chia sẻ, ví dụ: Kim.EMAIL_ADDRESS
: Địa chỉ email ưu tiên của người liên hệ được chia sẻ, ví dụ: alk@gmail.com.