אחרי הגדרת האימות, תוכלו להשתמש ב-Domain Shared Contacts API כדי לפרסם רשומות חדשות של אנשי קשר בדומיין של Google Workspace. ייתכן שיחלפו עד 24 שעות לפני שאנשי הקשר המשותפים יופיעו בהשלמה האוטומטית של כתובת האימייל ובמנהל אנשי הקשר.
צרו ייצוג 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
: כתובת האימייל המועדפת של איש הקשר המשותף. לדוגמה: alk@gmail.com.PREFERRED_NAME
: השם שמוצג למשתמש, לדוגמה, אלכס קיםSECONDARY_EMAIL_ADDRESS
: כתובת אימייל אחרת של איש הקשר המשותף – לדוגמה alk@example.org.PRIMARY_PHONE_NUMBER
: מספר הטלפון המועדף לאיש הקשר המשותף – לדוגמה, 555-0100 (800).SECONDARY_PHONE_NUMBER
: מספר טלפון נוסף של איש הקשר המשותף, לדוגמה 555-0101 (800).INSTANT_MESSAGING_ADDRESS
: כתובת האימייל המשויכת לפרטי ההודעות המיידיות של איש הקשר המשותף, לדוגמה: alk@gmail.com.CITY_NAME
: שם העיר של איש הקשר המשותף. למשל, לוס אנג'לס.ADDRESS
: הרחוב של איש הקשר המשותף – לדוגמה, רחוב אמפיביה 1600.REGION_NAME
: המדינה או המחוז שבהם נמצא איש הקשר המשותף – לדוגמה, CA.POST_CODE
: המיקוד של איש הקשר המשותף – לדוגמה: 94045.COUNTRY_NAME
: המדינה של איש הקשר המשותף. לדוגמה, ארצות הברית.FORMATTED_ADDRESS
: הכתובת של איש הקשר המשותף בפורמט המקובל במדינה או באזור שלו – לדוגמה,1800 Amphibious Balvd Mountain View.
כדי לפרסם את הרשומה הזו, יש לשלוח אותה לכתובת ה-URL של פיד רשימת אנשי הקשר:
- צריך למקם את רכיב ה-Atom
<entry>
בגוף של בקשתPOST
חדשה באמצעות סוג התוכןapplication/atom+xml
. - שולחים את הבקשה
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.
- צריך למקם את רכיב ה-Atom