העדכון והמחיקה של איש קשר משותף דומים כי בשניהם נעשה שימוש בכתובת ה-URL לעריכה של איש הקשר.
עדכון של איש קשר משותף
כשמעדכנים רשומה, צריך לשמור את כל ה-XML שאוחזר מהשרת. אחרת, המערכת תמחק את הרכיבים שהיא מתעלמת מהם. יכולות לעבור עד 24 שעות עד שהעדכונים יופיעו בהשלמה האוטומטית ובמרכז אנשי הקשר.
כדי לעדכן איש קשר משותף קיים:
- איך מקבלים את הרשומה לעדכון
- עורכים את הרשומה.
שולחים בקשת
PUTעם הרשומה המעודכנת לכתובת ה-URL לעריכה של איש הקשר. משתמשים בapplication/atom+xmlcontent type ומוודאים שהערך<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: הדומיין שלכם – לדוגמה, example.com. -
TITLE_NAME: שם לרשומה – לדוגמה, רשימת אנשי הקשר של example.com. -
FIRST_NAME: השם הפרטי של איש הקשר. -
LAST_NAME: שם המשפחה של איש הקשר. -
PROJECTION: ערך התחזית. במאמר ערכי תחזית מפורטים הערכים הנתמכים. -
PRIMARY_PHONE_NUMBER: מספר הטלפון המועדף. -
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 יום. כדי לבקש אותם, משתמשים בפרמטר השאילתה showdeleted.
השלבים הבאים
עדכון או מחיקה של תמונה של איש קשר משותף