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

Cập nhật ảnh cho người liên hệ được chia sẻ hơi khác so với 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 làm việc với thông tin của người liên hệ, xem Cập nhật hoặc xoá người liên hệ dùng chung. Khi sử dụng đường liên kết ảnh, bạn phải chỉ định mã thông báo uỷ quyền trong HTTP . Để biết thêm thông tin, hãy xem 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ó một thành phần đường liên kết đến ảnh. Thành phần đường liên kết của ảnh xuất hiện xem 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 chứa thuộc tính gd:etag chỉ định một ETag Tiêu đề 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 nhập cụ thể. Trong trường hợp này, nó cho phép bạn tham chiếu đến phiên bản cụ thể của ảnh. Nếu người liên hệ không có ảnh thì không có thuộc tính gd:etag và thuộc tính href cung cấp URL để sử dụng để thêm ảnh với địa chỉ 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ụ: vidu.com.
    • PHOTO_LINK: Một giá trị số duy nhất biểu thị đường liên kết ảnh của người liên hệ chung – 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">
    

Xóa ảnh cho 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 xóa một ảnh, hãy gửi ETag của ảnh đó trong 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 sử dụng If-Match: * để ghi đè hệ thống đánh dấu 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.