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

بعد إعداد المصادقة، يمكنك استخدام واجهة برمجة التطبيقات Domain Shared Contacts API لنشر إدخالات جهات اتصال مشترَكة جديدة في نطاق 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: الاسم الأول لجهة الاتصال التي تمت مشاركتها، مثلاً "أدهم"
   • LAST_NAME: اسم العائلة لجهة الاتّصال المشترَكة، على سبيل المثال، "كيم"
   • ‫PRIMARY_EMAIL_ADDRESS: عنوان البريد الإلكتروني المفضّل للجهة المشترَكة، على سبيل المثال، [e-mail].
   • PREFERRED_NAME: الاسم الذي يظهر للمستخدم، على سبيل المثال، "علي كمال"
   • 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: الولاية أو المقاطعة التي تقع فيها جهة الاتصال المشتركة، على سبيل المثال، كاليفورنيا.
   • POST_CODE: الرمز البريدي للجهة المشترَكة المعنية، على سبيل المثال 94045
   • COUNTRY_NAME: بلد جهة العميل المشترَكة، على سبيل المثال، الولايات المتحدة
   • FORMATTED_ADDRESS: عنوان جهة الاتّصال المشترَكة الذي تم تنسيقه باستخدام اصطلاح بلده أو منطقته، على سبيل المثال، 1800 Amphibious Blvd Mountain View

2. لنشر هذا الإدخال، أرسِله إلى عنوان URL لخلاصة قائمة جهات الاتصال:

   1. ضَع عنصر <entry> في نص طلب POST جديد باستخدام نوع المحتوى application/atom+xml.
   2. أرسِل طلب POST إلى عنوان URL للخلاصة.

   على سبيل المثال، لإضافة جهة اتصال مشترَكة في النطاق إلى القائمة التي تنتمي إلى example.com، أرسِل طلب POST يتضمّن الإدخال الجديد إلى عنوان ملف شخصي على الويب التالي:

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

   ينشئ خادم Google جهة اتصال باستخدام الإدخال الذي أرسلته، ثم يعرض رمز الحالة HTTP 201 CREATED، بالإضافة إلى نسخة من جهة الاتصال الجديدة في شكل عنصر <entry>. إنّ الإدخال الذي يتم إرجاعه هو نفسه الذي أرسلته، ولكنه يحتوي أيضًا على عناصر مختلفة أضافها الخادم، مثل عنصر <id>.

   في حال تعذّر إكمال طلبك، قد تعرِض Google رمز حالة مختلفًا. للحصول على معلومات عن رموز الحالة، يُرجى الاطّلاع على مستند مرجعي لبروتوكول Google Data API.

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

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