Việc cập nhật ảnh cho một người liên hệ được chia sẻ sẽ hơi khác so với việc 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 phần 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 bài viết Tìm hiểu về việc xác thực và uỷ quyền.
Cập nhật ảnh của một 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 thuộc tính gd:etag chỉ định tiêu đề HTTP ETag 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 nhập cụ thể. Trong trường hợp này, thuộc tính 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 để sử dụng nhằm thêm ảnh vào người liên hệ.
Để thêm hoặc cập nhật ảnh, hãy gửi ảnh mới:
PUT https://www.google.com/m8/feeds/photos/media/liz%40
DOMAIN /PHOTO_LINK Thay thế nội dung sau:
DOMAIN: URL của miền, ví dụ: example.com.PHOTO_LINK: Một giá trị 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ề phần tử đường liên kết đến ả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 một người liên hệ được chia sẻ
Để xoá một ả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 ảnh mới nhất, hãy sử dụng If-Match: * để ghi đè hệ thống tạo 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 API Dữ liệu của Google.