Trang này được dịch bởi Cloud Translation API.

Cập nhật hoặc xoá người liên hệ dùng chung

Quy trình cập nhật hoặc xoá một người liên hệ được chia sẻ cũng tương tự như vậy.

Cập nhật người liên hệ dùng chung

Khi cập nhật một mục, bạn phải giữ lại tất cả tệp XML có sẵn khi bạn truy xuất mục đó từ máy chủ. Nếu không, các phần tử bị bỏ qua sẽ bị xoá. Có thể mất đến 24 giờ thì thông tin cập nhật mới được phản ánh trong tính năng tự động hoàn thành địa chỉ email và trình quản lý liên hệ.

Để cập nhật một người liên hệ được chia sẻ hiện có, hãy làm như sau:

Lấy mục bạn muốn cập nhật.
Chỉnh sửa mục nhập.

Gửi yêu cầu PUT có mục đã cập nhật trong phần nội dung thư đến URL chỉnh sửa của người liên hệ. Sử dụng loại nội dung application/atom+xml và đảm bảo rằng giá trị <id> trong mục đã cập nhật khớp chính xác với <id> của mục hiện có. URL chỉnh sửa kết thúc bằng số phiên bản để phát hiện xung đột của các bản cập nhật từ nhiều nguồn. Để biết thêm thông tin, hãy xem phần tạo phiên bản.

Cập nhật mục nhập:

<entry>
  <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
  <updated>2008-02-28T18:47:02.303Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>TITLE_NAME</title>
  <gd:name>
    <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <content type='text'>NOTES</content>
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
  <link rel='edit' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
    primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
  <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
</entry>

Thay thế nội dung sau:

DOMAIN: URL của miền, ví dụ: example.com.
TITLE_NAME: Tên cho mục danh bạ, ví dụ: danh bạ example.com.
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.
PROJECTION: Giá trị chiếu chỉ định các phần tử gd:extendedProperty. Để biết danh sách giá trị được hỗ trợ, hãy xem phần Giá trị chiếu.
PRIMARY_PHONE_NUMBER: Số điện thoại ưu tiên cho người liên hệ được chia sẻ, ví dụ: (206)555-1212.
CUSTOM_PROPERTY: Tên của một thuộc tính tuỳ chỉnh mà bạn muốn lưu trữ về người liên hệ được chia sẻ, ví dụ: thú cưng.

CUSTOM_PROPRTY_VALUE: Giá trị cho một thuộc tính tuỳ chỉnh mà bạn muốn lưu trữ về người liên hệ được chia sẻ, ví dụ: hamster.

Sau đây là ví dụ về một mục đã cập nhật cho một người liên hệ được chia sẻ, trong đó URL chỉnh sửa được làm nổi bật:

<entry>
<id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
<updated>2008-02-28T18:47:02.303Z</updated>
<category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#contact' />
<title type='text'>Fitzgerald</title>
<gd:name>
  <gd:fullName>Fitzgerald</gd:fullName>
</gd:name>
<content type='text'>Notes</content>
<link rel='self' type='application/atom+xml'
  href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
<link rel='edit' type='application/atom+xml'
  href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
<gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
  primary='true'>456-123-2133</gd:phoneNumber>
<gd:extendedProperty name="pet" value="hamster" />
<gd:extendedProperty name="cuisine">
  <italian />
</gd:extendedProperty>
</entry>

Xoá người liên hệ được chia sẻ

Những người liên hệ dùng chung đã xoá có thể mất đến 24 giờ để biến mất khỏi tính năng tự động hoàn thành địa chỉ email và trình quản lý danh bạ. Để cập nhật danh bạ hiện có, hãy xem phần Cập nhật danh bạ. Đừng cập nhật danh bạ bằng cách xoá rồi thêm lại người liên hệ.

Để xoá một người liên hệ được chia sẻ, hãy gửi yêu cầu DELETE đến URL chỉnh sửa của người liên hệ đó. Đây cũng là URL dùng để cập nhật thông tin liên hệ.

Google giữ lại phần giữ chỗ cho những người liên hệ đã bị xoá trong 30 ngày sau khi xoá. Trong thời gian đó, bạn có thể yêu cầu phần giữ chỗ bằng cách sử dụng tham số truy vấn showdeleted.

Các bước tiếp theo

Cập nhật hoặc xoá ảnh của một người liên hệ được chia sẻ