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

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

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
   

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

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

השלבים הבאים

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