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

بعد إعداد المصادقة، يمكنك استخدام 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: رقم الهاتف المفضل لجهة الاتصال المشتركة - على سبيل المثال، [phone].
   • SECONDARY_PHONE_NUMBER: رقم هاتف آخر جهة الاتصال المشتركة - على سبيل المثال، [phone].
   • INSTANT_MESSAGING_ADDRESS: عنوان البريد الإلكتروني المرتبط بمعلومات المراسلة الفورية لجهة الاتصال المشتركة، على سبيل المثال، [e-mail].
   • CITY_NAME: اسم المدينة لجهة الاتصال المشتركة—على سبيل المثال، ماونتن فيو.
   • ADDRESS: عنوان الشارع لجهة الاتصال المشتركة، على سبيل المثال، 1600 Amphibious Blvd.
   • REGION_NAME: الولاية أو المقاطعة لجهة الاتصال المشتركة، على سبيل المثال، CA.
   • POST_CODE: الرمز البريدي لجهة الاتصال المشتركة، على سبيل المثال، 94045.
   • COUNTRY_NAME: البلد الخاص بجهة الاتصال المشتركة، على سبيل المثال، الولايات المتحدة.
   • FORMATTED_ADDRESS: عنوان جهة الاتصال المشتركة الذي تم تنسيقه باستخدام اصطلاح بلدهم أو منطقتهم، على سبيل المثال، 1800 Amphibious Blvd 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.

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

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