การอัปเดตรูปภาพสำหรับรายชื่อติดต่อที่แชร์จะแตกต่างจากการอัปเดตข้อมูลของรายชื่อติดต่อที่แชร์เล็กน้อย ดูข้อมูลเกี่ยวกับการทำงานกับข้อมูลของรายชื่อติดต่อที่แชร์ได้ที่อัปเดตหรือลบรายชื่อติดต่อที่แชร์ เมื่อใช้ลิงก์รูปภาพ คุณต้องระบุโทเค็นการให้สิทธิ์ในส่วนหัว HTTP ดูข้อมูลเพิ่มเติมได้ที่ ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์
อัปเดตรูปภาพสำหรับรายชื่อติดต่อที่แชร์
รายชื่อติดต่อที่แชร์ทุกรายการจะมีองค์ประกอบลิงก์รูปภาพ องค์ประกอบลิงก์รูปภาพจะปรากฏขึ้น
ไม่ว่ารายชื่อติดต่อจะมีรูปภาพที่เชื่อมโยงหรือไม่ก็ตาม หากรายชื่อติดต่อมีรูปภาพ องค์ประกอบจะมีแอตทริบิวต์ gd:etag ที่ระบุETagส่วนหัว HTTP สำหรับรูปภาพ
ETag ช่วยให้คุณอ้างอิงถึงรายการที่เฉพาะเจาะจงในเวอร์ชันหนึ่งๆ ได้
ในกรณีนี้ จะช่วยให้คุณอ้างอิงถึงรูปภาพเวอร์ชันใดเวอร์ชันหนึ่งได้ หากรายชื่อติดต่อไม่มีรูปภาพ ก็จะไม่มีแอตทริบิวต์ gd:etag และแอตทริบิวต์ href จะระบุ URL ที่ใช้เพื่อเพิ่มรูปภาพลงในรายชื่อติดต่อ
หากต้องการเพิ่มหรืออัปเดตรูปภาพ ให้ส่งรูปภาพใหม่โดยทำดังนี้
PUT https://www.google.com/m8/feeds/photos/media/USER_ID%40DOMAIN/PHOTO_LINKแทนที่ค่าต่อไปนี้
USER_ID: ชื่อผู้ใช้ เช่น AlexDOMAIN: URL ของโดเมน เช่น example.comPHOTO_LINK: ค่าตัวเลขที่ไม่ซ้ำกันซึ่ง แสดงถึงลิงก์รูปภาพของรายชื่อติดต่อที่แชร์ เช่น c9012de
ต่อไปนี้เป็นตัวอย่างขององค์ประกอบลิงก์รูปภาพ
<link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.google.com/m8/feeds/photos/media/Alex%40example.com/c9012de">
ลบรูปภาพสำหรับรายชื่อติดต่อที่แชร์
หากต้องการลบรูปภาพ คุณต้องใช้เมธอด HTTP DELETE
เมื่ออัปเดตหรือลบรูปภาพ ให้ส่ง ETag ของรูปภาพในส่วนหัว If-Match
ของคำขอ HTTP หากคุณไม่มีรูปภาพเวอร์ชันล่าสุด ให้ใช้ If-Match: * เพื่อลบล้างระบบการควบคุมเวอร์ชันและลบรูปภาพ
ดูข้อมูลเพิ่มเติมเกี่ยวกับ ETags ได้ที่เอกสารอ้างอิงโปรโตคอล Google Data APIs