Các 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ư nhau.
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ả mã XML xuất hiện khi bạn đã 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á. Quá trình cập nhật có thể mất tối đa 24 giờ mới được thể hiện trong địa chỉ email tính năng tự động hoàn tất 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:
- Lấy mục nhập mà bạn muốn cập nhật.
- Chỉnh sửa mục cần nhập.
Gửi yêu cầu
PUT
kèm theo mục nhập đã cập nhật trong nội dung thư đến URL chỉnh sửa của địa chỉ liên hệ. Sử dụng loại nội dungapplication/atom+xml
và tạo đảm bảo rằng giá trị<id>
trong mục nhập đã cập nhật khớp chính xác với<id>
của mục nhập 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ập nhật từ các nguồn khác nhau. Để biết thêm thông tin, xem 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ụ: vidu.com.TITLE_NAME
: Tên cho mục nhập thông tin liên hệ—cho ví dụ: danh bạ trên example.com.FIRST_NAME
: Tên của người được chia sẻ người liên hệ – ví dụ: Alex.LAST_NAME
: Họ của người được chia sẻ người liên hệ – 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ị, xem Giá trị chiếu.PRIMARY_PHONE_NUMBER
: Điện thoại ưu tiên số của người liên hệ được chia sẻ—ví dụ: (206)555-1212.CUSTOM_PROPERTY
: Tên cho thuộc tính tuỳ chỉnh mà bạn muốn lưu trữ về người liên hệ chung, ví dụ: thú cưng.CUSTOM_PROPRTY_VALUE
: Giá trị cho một tuỳ chỉnh thuộc tính mà bạn muốn lưu trữ về thông tin liên hệ được chia sẻ, ví dụ: chuột hamster.Sau đây là ví dụ về mục nhập được cập nhật cho một người liên hệ được chia sẻ với 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á 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ờ mới biến mất khỏi email tự động hoàn thành địa chỉ và trình quản lý liên hệ. Để cập nhật người liên hệ hiện có, hãy xem Cập nhật danh bạ. Đừng cập nhật người liên hệ bằng cách xoá rồi thêm lại người liên hệ.
- Để xoá một người liên hệ dùng chung, hãy gửi yêu cầu
DELETE
đến chỉnh sửa URL. Đây cũng là URL được dùng để cập nhật danh bạ.
Google giữ lại phần giữ chỗ cho các mục liên hệ đã xóa trong 30 ngày sau khi xóa.
Trong thời gian đó, bạn có thể yêu cầu phần giữ chỗ bằng cách sử dụng showdeleted
tham số truy vấn.
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