Thực hiện thao tác theo lô

Nếu bạn đang thực hiện một số thao tác, thời gian cần để 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 chậm và không phản hồi. Với 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à tạo một nguồn cấp dữ liệu danh bạ và thêm mục nhập cho từng thao tác bạn muốn thực hiện.

Yêu cầu hàng loạt chỉ được có 100 thao tác tại một thời điểm. Bạn có thể tìm thêm thông tin về 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 tới 24 giờ mới được phản ánh trong tính năng tự động hoàn tất địa chỉ email và trình quản lý liên hệ.

Mã mẫu sau đây cho thấy một yêu cầu hàng loạt tạo ra 2 danh bạ 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á danh bạ. Các mục cập nhật và xoá cần có một đường liên kết chỉnh sửa để cơ chế đồng thời tối ưu 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ế đoạn mã sau:

• FIRST_NAME: Tên của người liên hệ dùng chung, ví dụ: Alex.
• LAST_NAME: Họ của người liên hệ dùng chung – ví dụ: Kim.
• EMAIL_ADDRESS: Địa chỉ email ưu tiên của người liên hệ được chia sẻ, ví dụ: [e-mail].