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

Cập nhật hoặc xóa người liên hệ được chia sẻ

Quy trình cập nhật hoặc xoá một người liên hệ dùng chung 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 nhập, bạn phải giữ lại tất cả XML đã có khi truy xuất mục nhập từ máy chủ. Nếu không, các phần tử bị bỏ qua sẽ bị xoá. Nội dung cập nhật có thể mất đến 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ệ.

Để cập nhật một người liên hệ dùng chung hiện có, hãy làm như sau:

Xem 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 nội dung thông báo đến URL chỉnh sửa của người liên hệ. Hãy 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 với nội dung cập nhật từ nhiều nguồn. Để biết thêm thông tin, hãy xem nội dung 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ế đoạn mã sau:

DOMAIN: URL cho miền của bạn, ví dụ: example.com.
TITLE_NAME: Tên cho mục nhập danh bạ, ví dụ: danh bạ example.com.
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.
PROJECTION: Giá trị phép chiếu chỉ định các phần tử gd:extendedProperty. Để biết danh sách các giá trị được hỗ trợ, hãy xem phần Giá trị phép chiếu.
PRIMARY_PHONE_NUMBER: Số điện thoại ưu tiên cho người liên hệ dùng chung – 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ữ liên quan đến người liên hệ dùng chung (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ệ dùng chung (ví dụ: chuột đồng).

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

<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á danh bạ dùng chung

Những người liên hệ được chia sẻ đã bị xoá có thể mất tới 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ạ. Không cập nhật danh bạ bằng cách xoá người liên hệ rồi thêm lại.

Để xoá một mục liên hệ dùng chung, hãy gửi yêu cầu DELETE đến URL chỉnh sửa của mục liên hệ đó. Đây cũng chính là URL dùng để cập nhật danh bạ.

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 người liên hệ dùng chung