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

אחרי הגדרת האימות, משתמשים ב-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

השלבים הבאים

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