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

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

1. יוצרים ייצוג XML של איש הקשר המשותף שרוצים לפרסם, בצורת רכיב Atom <entry> מסוג Contact kind. הקובץ עשוי להיראות כך:

   <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: שם הפרטי של איש הקשר המשותף, לדוגמה, אלכס.
   • LAST_NAME: שם המשפחה של איש הקשר המשותף, לדוגמה: לוי.
   • PRIMARY_EMAIL_ADDRESS: כתובת האימייל המועדפת של איש הקשר המשותף – לדוגמה, [e-mail].
   • PREFERRED_NAME: השם שמוצג למשתמש – לדוגמה, Alex Kim
   • SECONDARY_EMAIL_ADDRESS: כתובת אימייל נוספת של איש הקשר המשותף, לדוגמה: [e-mail].
   • PRIMARY_PHONE_NUMBER: מספר הטלפון המועדף של איש הקשר המשותף, לדוגמה ‎[phone].
   • SECONDARY_PHONE_NUMBER: מספר טלפון נוסף של איש הקשר המשותף, לדוגמה [phone].
   • INSTANT_MESSAGING_ADDRESS: כתובת האימייל שמשויכת לפרטי הצ'אט של איש הקשר המשותף, לדוגמה: [e-mail].
   • CITY_NAME: שם העיר של איש הקשר המשותף, לדוגמה, תל אביב.
   • ADDRESS: רחוב של איש הקשר המשותף – לדוגמה, 1600 Amphibious Blvd.
   • REGION_NAME: המדינה או המחוז של איש הקשר המשותף, לדוגמה CA.
   • POST_CODE: המיקוד של איש הקשר המשותף – לדוגמה, 94045.
   • COUNTRY_NAME: המדינה של איש הקשר המשותף, לדוגמה: United States.
   • FORMATTED_ADDRESS: הכתובת של איש הקשר המשותף בפורמט שמקובל במדינה או באזור שלו. לדוגמה: 1800 Amphibious Blvd Mountain View.

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

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

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

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

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

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

השלבים הבאים

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