Việc cập nhật ảnh cho một người liên hệ được chia sẻ hơi khác so với việc cập nhật thông tin của một người liên hệ được chia sẻ. Để biết thông tin về cách làm việc với 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á một 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ề tính năng 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ó 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ử 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 phiên bản cụ thể của một mục 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 mục liên hệ không có ảnh thì sẽ không có thuộc tính gd:etag và thuộc tính href cung cấp URL cần sử dụng để thêm ảnh vào mục 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%40DOMAIN/PHOTO_LINK
Thay thế đoạn mã sau:
DOMAIN: URL cho miền của bạ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 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 ả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 Google Data API.