Cách cập nhật ảnh của một người liên hệ được chia sẻ hơi khác so với cách cập nhật thông tin của người liên hệ được chia sẻ. Để biết thông tin về cách xử lý thông tin của một người liên hệ được chia sẻ, hãy xem bài viết Cập nhật hoặc xoá người liên hệ được chia sẻ. Khi sử dụng đường liên kết đến ảnh, bạn phải chỉ định mã thông báo uỷ quyền trong tiêu đề HTTP. Để biết thêm thông tin, hãy xem phần Tìm hiểu về quy trình xác thực và uỷ quyền.
Cập nhật ảnh cho người liên hệ được chia sẻ
Mỗi người liên hệ được chia sẻ đều có một phần tử đường liên kết đến ảnh. Phần tử đường liên kết đến ảnh sẽ xuất hiện cho dù người liên hệ có ảnh được liên kết hay không. Nếu người liên hệ có ảnh, thì phần tử này sẽ chứa một thuộc tính gd:etag chỉ định tiêu đề ETag HTTP cho ảnh. ETag cho phép bạn tham chiếu đến một phiên bản cụ thể của một mục cụ thể. Trong trường hợp này, tính năng này cho phép bạn tham chiếu đến một phiên bản cụ thể của ảnh. Nếu người liên hệ không có ảnh, thì sẽ không có thuộc tính gd:etag và thuộc tính href sẽ cung cấp URL để dùng thêm ảnh vào người liên hệ.
Để thêm hoặc cập nhật ảnh, hãy gửi một bức ảnh mới:
PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINKThay thế nội dung sau:
DOMAIN: URL cho miền của bạn, ví dụ: example.com.PHOTO_LINK: Một giá trị bằng số duy nhất đại diện cho đường liên kết đến ảnh của người liên hệ được chia sẻ, ví dụ: c9012de.
Sau đây là ví dụ về một yếu tố liên kết ảnh:
<link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.google.com/m8/feeds/photos/media/liz%40example.com/c9012de">
Xoá ảnh của người liên hệ được chia sẻ
Để xoá ảnh, bạn phải sử dụng phương thức HTTP DELETE.
Khi cập nhật hoặc xoá ảnh, hãy gửi ETag của ảnh trong tiêu đề If-Match của yêu cầu HTTP. Nếu bạn không có phiên bản mới nhất của ảnh, hãy dùng If-Match: * để ghi đè hệ thống quản lý phiên bản và xoá ảnh.
Để biết thêm thông tin về ETags, hãy xem tài liệu tham khảo về giao thức Google Data API.