יצירת אנשי קשר משותפים

אחרי הגדרת האימות, אפשר להשתמש בממשק Domain Shared Contacts API כדי לפרסם רשומות חדשות של אנשי קשר משותפים בדומיין Google Workspace. יכולות לעבור עד 24 שעות עד שאנשי קשר משותפים יופיעו בהשלמה האוטומטית ובמרכז אנשי הקשר.

1. יוצרים ייצוג XML של איש הקשר ששותף כדי לפרסם אותו כרכיב Atom‏ <entry> של סוג איש הקשר:

   <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
       xmlns:gd='http://schemas.google.com/g/2005'>
     <atom:category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <gd:name>
        <gd:givenName>FIRST_NAME</gd:givenName>
        <gd:familyName>LAST_NAME</gd:familyName>
        <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <atom:content type='text'>NOTES</atom:content>
     <gd:email rel='http://schemas.google.com/g/2005#work'
       primary='true'
       address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
     <gd:email rel='http://schemas.google.com/g/2005#home'
       address='SECONDARY_EMAIL_ADDRESS' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
       primary='true'>
       PRIMARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
       SECONDARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:im address='INSTANT_MESSAGING_ADDRESS'
       protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
       primary='true'
       rel='http://schemas.google.com/g/2005#home' />
     <gd:structuredPostalAddress
         rel='http://schemas.google.com/g/2005#work'
         primary='true'>
       <gd:city>CITY_NAME</gd:city>
       <gd:street>ADDRESS</gd:street>
       <gd:region>REGION_NAME</gd:region>
       <gd:postcode>POST_CODE</gd:postcode>
       <gd:country>COUNTRY_NAME</gd:country>
       <gd:formattedAddress>
         FORMATTED_ADDRESS
       </gd:formattedAddress>
     </gd:structuredPostalAddress>
   </atom:entry>

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫FIRST_NAME: השם הפרטי של איש הקשר, למשל Dana.
   • ‫LAST_NAME: שם המשפחה של איש הקשר, למשל A.
   • ‫PRIMARY_EMAIL_ADDRESS: כתובת האימייל המועדפת, כמו [e-mail].
   • ‫PREFERRED_NAME: השם המוצג של המשתמש, כמו Dana A.
   • ‫SECONDARY_EMAIL_ADDRESS: כתובת אימייל משנית, כמו [e-mail].
   • PRIMARY_PHONE_NUMBER: מספר הטלפון המועדף, למשל 800-555-0100.
   • ‫SECONDARY_PHONE_NUMBER: מספר טלפון משני, כמו 800-555-0101.
   • ‫INSTANT_MESSAGING_ADDRESS: כתובת אימייל של הודעות מיידיות, כמו [e-mail].
   • ‫CITY_NAME: שם העיר, למשל Mountain View.
   • ‫ADDRESS: כתובת רחוב, כמו 1800 Amphibious Blvd.
   • ‫REGION_NAME: מדינה או מחוז, כמו CA.
   • ‫POST_CODE: מיקוד, כמו 94045.
   • ‫COUNTRY_NAME: מדינה, כמו ארה"ב.
   • ‫FORMATTED_ADDRESS: כתובת בפורמט שמוגדר לפי המוסכמות המקומיות, כמו 1800 Amphibious Blvd., Mountain View, CA 94045, USA.

2. כדי לפרסם את הרשומה הזו, שולחים אותה לכתובת ה-URL של פיד רשימת אנשי הקשר:

   1. מציבים את רכיב ה-Atom <entry> בגוף של בקשת POST חדשה באמצעות סוג התוכן application/atom+xml.
   2. שולחים את הבקשה POST לכתובת ה-URL של הפיד.

   לדוגמה, כדי להוסיף איש קשר לרשימה example.com, שולחים את הבקשה POST לכתובת ה-URL הבאה:

   https://www.google.com/m8/feeds/contacts/example.com/full
   

   השרת יוצר את איש הקשר ומחזיר קוד סטטוס HTTP 201 CREATED, יחד עם רשומת איש הקשר החדשה. הערך שמוחזר כולל רכיבים שנוצרו על ידי השרת, כמו <id>.

   אם הבקשה נכשלת, השרת מחזיר קוד סטטוס אחר. מידע נוסף זמין במאמר בנושא הפניית פרוטוקול Google Data API.

השלבים הבאים

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