إنشاء جهات اتصال مشتركة

بعد إعداد المصادقة، استخدِم واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" لنشر إدخالات جهات الاتصال المشتركة الجديدة في نطاق Google Workspace. قد يستغرق ظهور جهات الاتصال المشتركة في الإكمال التلقائي وفي "مدير جهات الاتصال" ما يصل إلى 24 ساعة.

1. أنشئ تمثيلاً بتنسيق XML لجهة الاتصال المشتركة لنشره كعنصر <entry> بتنسيق Atom من نوع جهة الاتصال:

   <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: الاسم الأخير لجهة الاتصال، مثل أ.
   • PRIMARY_EMAIL_ADDRESS: عنوان البريد الإلكتروني المفضّل، مثل [e-mail].
   • PREFERRED_NAME: الاسم المعروض للمستخدم، مثل "دانا أ."
   • 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: الولاية أو المقاطعة، مثل كاليفورنيا
   • استبدِل 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.

الخطوات التالية

• تعديل صورة جهة اتصال مشترَكة أو حذفها