עדכון או מחיקה של איש קשר משותף

התהליכים לעדכון או למחיקה של איש קשר משותף דומים.

עדכון איש קשר משותף

כשמעדכנים רשומה, צריך לשמור את כל ה-XML שהיה קיים כשאחזרתם את הערך מהשרת. אחרת, המערכת תמחק את הרכיבים שהתעלמו מהם. עשויות לחלוף עד 24 שעות לפני שהעדכונים יופיעו בהשלמה האוטומטית של כתובת האימייל ובמנהל אנשי הקשר.

כדי לעדכן איש קשר משותף קיים, מבצעים את הפעולות הבאות:

1. מזינים את הרשומה שרוצים לעדכן.
2. עריכת הרשומה.

3. שולחים בקשת 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: השם הפרטי של איש הקשר המשותף — לדוגמה, אלכס.
   • LAST_NAME: שם המשפחה של איש הקשר המשותף — לדוגמה, מיכל.
   • PROJECTION: ערך התחזית שמציין את רכיבי gd:extendedProperty. בערכי ההיטל מופיעה רשימה של הערכים הנתמכים.
   • PRIMARY_PHONE_NUMBER: מספר הטלפון המועדף של איש הקשר המשותף. לדוגמה: [phone].
   • 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 שומרת ערכי placeholder של אנשי קשר שנמחקו למשך 30 יום לאחר המחיקה. בזמן הזה תוכלו לבקש את ה-placeholders באמצעות הפרמטר showdeleted של השאילתה.

השלבים הבאים

עדכון או מחיקה של תמונות של איש קשר משותף