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

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

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

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