התהליכים לעדכון או למחיקה של איש קשר משותף דומים.
עדכון של איש קשר משותף
כשמעדכנים רשומה, צריך לשמור את כל ה-XML שהיה קיים כשאחזרתם את הרשומה מהשרת. אחרת, הרכיבים שהמערכת התעלמה מהם יימחקו. יכול להיות שיחלפו עד 24 שעות עד שהעדכונים יופיעו בהשלמה האוטומטית של כתובות האימייל ובמנהל אנשי הקשר.
כדי לעדכן איש קשר משותף קיים:
- מקבלים את הרשומה שרוצים לעדכן.
- עורכים את הרשומה.
שולחים בקשה מסוג
PUT
עם הרשומה המעודכנת בגוף ההודעה לכתובת ה-URL של עריכת איש הקשר. משתמשים בסוג התוכןapplication/atom+xml
ומוודאים שהערך<id>
ברשומה המעודכנת זהה לערך<id>
ברשומה הקיימת. כתובת ה-URL של העריכה מסתיימת במספר גרסה, כדי לזהות התנגשויות בין עדכונים ממקורות שונים. למידע נוסף, קראו את המאמר בנושא ניהול גרסאות.מעדכנים את הרשומה:
<entry> <id>https://www.google.com/m8/feeds/contacts/
DOMAIN /base/8411573</id> <updated>2008-02-28T18:47:02.303Z</updated> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <title type='text'>TITLE_NAME </title> <gd:name> <gd:fullName>FIRST_NAME LAST_NAME </gd:fullName> </gd:name> <content type='text'>NOTES</content> <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/DOMAIN /PROJECTION /8411573' /> <link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/DOMAIN /PROJECTION /8411573/1204224422303000' /> <gd:phoneNumber rel='http://schemas.google.com/g/2005#other' primary='true'>PRIMARY_PHONE_NUMBER </gd:phoneNumber> <gd:extendedProperty name="CUSTOM_PROPERTY " value="CUSTOM_PROPRTY_VALUE " /> </entry>מחליפים את מה שכתוב בשדות הבאים:
DOMAIN
: כתובת ה-URL של הדומיין שלכם – לדוגמה, example.com.TITLE_NAME
: שם של רשומת איש הקשר – לדוגמה, רשימת אנשי הקשר של example.com.FIRST_NAME
: השם הפרטי של איש הקשר המשותף, לדוגמה, Alex.LAST_NAME
: שם המשפחה של איש הקשר המשותף – לדוגמה, לוי.PROJECTION
: ערך ההקרנה שמציין את הרכיביםgd:extendedProperty
. רשימה של הערכים הנתמכים מופיעה במאמר ערכים של הקרנה.PRIMARY_PHONE_NUMBER
: מספר הטלפון המועדף של איש הקשר המשותף. לדוגמה, 055-1212-555.CUSTOM_PROPERTY
: שם למאפיין בהתאמה אישית שרוצים לאחסן לגבי איש הקשר המשותף. לדוגמה, 'חיות מחמד'.CUSTOM_PROPRTY_VALUE
: ערך של נכס בהתאמה אישית שרוצים לשמור לגבי איש הקשר המשותף. לדוגמה: 'ארנב'.בדוגמה הבאה מוצגת רשומה מעודכנת של איש קשר משותף, כאשר כתובת ה-URL לעריכה מודגשת:
<entry> <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id> <updated>2008-02-28T18:47:02.303Z</updated> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <title type='text'>Fitzgerald</title> <gd:name> <gd:fullName>Fitzgerald</gd:fullName> </gd:name> <content type='text'>Notes</content> <link rel='self' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' /> <link rel='edit' type='application/atom+xml' href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' /> <gd:phoneNumber rel='http://schemas.google.com/g/2005#other' primary='true'>456-123-2133</gd:phoneNumber> <gd:extendedProperty name="pet" value="hamster" /> <gd:extendedProperty name="cuisine"> <italian /> </gd:extendedProperty> </entry>
מחיקת אנשי קשר משותפים
יכול להיות שיחלפו עד 24 שעות עד שאנשי הקשר המשותפים שנמחקו ייעלמו מההשלמה האוטומטית של כתובות האימייל וממנהל אנשי הקשר. במאמר עדכון אנשי קשר מוסבר איך מעדכנים אנשי קשר קיימים. אל תעדכנו את אנשי הקשר על ידי מחיקה שלהם והוספה מחדש.
- כדי למחוק איש קשר משותף, שולחים בקשה מסוג
DELETE
לכתובת ה-URL של איש הקשר לצורך עריכה. זוהי אותה כתובת URL שמשמשת לעדכון אנשי הקשר.
Google שומרת את הסמנים של אנשי הקשר שנמחקו למשך 30 יום לאחר המחיקה.
במהלך התקופה הזו, תוכלו לבקש את ה-placeholders באמצעות פרמטר השאילתה showdeleted
.
השלבים הבאים
עדכון או מחיקה של תמונה של איש קשר משותף