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

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

تعديل جهة اتصال مشتركة

عند تعديل إدخال، يجب الاحتفاظ بجميع ملفات XML التي كانت متوفّرة عند استرداد الإدخال من الخادم. وإلا يتم حذف العناصر التي تم تجاهلها. قد يستغرق ظهور التحديثات ما يصل إلى 24 ساعة في الإكمال التلقائي لعنوان البريد الإلكتروني ومدير جهات الاتصال.

لتعديل جهة اتصال مشتركة حالية، يُرجى اتّباع الخطوات التالية:

1. احصل على الإدخال الذي تريد تعديله.
2. عدِّل الإدخال.

3. أرسِل طلب PUT مع الإدخال المعدّل في نص الرسالة إلى عنوان URL للتعديل الخاص بجهة الاتصال. استخدِم نوع محتوى application/atom+xml وتأكَّد من أنّ قيمة <id> في الإدخال المعدّل تتطابق تمامًا مع <id> للإدخال الحالي. ينتهي عنوان URL للتعديل برقم إصدار، من أجل رصد تعارض التحديثات من مصادر مختلفة. لمزيد من المعلومات، راجع الإصدار.

   عدِّل الإدخال:

   <entry>
     <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>TITLE_NAME</title>
     <gd:name>
       <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <content type='text'>NOTES</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
     <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
   </entry>
   

   استبدِل ما يلي:

   • DOMAIN: عنوان URL لنطاقك، مثلاً example.com.
   • TITLE_NAME: اسم لإدخال جهة الاتصال، مثلاً example.com قائمة جهات الاتصال
   • FIRST_NAME: الاسم الأول لجهة الاتصال المشتركة، مثل "أليكس".
   • LAST_NAME: الاسم الأخير لجهة الاتصال المشتركة، مثل كيم.
   • PROJECTION: قيمة العرض التي تحدّد عناصر gd:extendedProperty. للحصول على قائمة بالقيم المسموح بها، يُرجى الاطّلاع على قيم التوقّع.
   • PRIMARY_PHONE_NUMBER: رقم الهاتف المفضّل لجهة الاتصال المشتركة، مثلاً [phone].
   • CUSTOM_PROPERTY: اسم خاصية مخصّصة تريد تخزينها حول جهة الاتصال المشتركة، مثل حيوان أليف.

   • CUSTOM_PROPRTY_VALUE: قيمة لخاصية مخصّصة تريد تخزينها حول جهة الاتصال المشتركة، مثل الهامستر.

     فيما يلي مثال على إدخال محدّث لجهة اتصال مشتركة مع تمييز عنوان URL للتعديل:

     <entry>
     <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>Fitzgerald</title>
     <gd:name>
       <gd:fullName>Fitzgerald</gd:fullName>
     </gd:name>
     <content type='text'>Notes</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>456-123-2133</gd:phoneNumber>
     <gd:extendedProperty name="pet" value="hamster" />
     <gd:extendedProperty name="cuisine">
       <italian />
     </gd:extendedProperty>
     </entry>
     

حذف جهات الاتصال المشتركة

قد يستغرق اختفاء جهات الاتصال المشتركة المحذوفة ما يصل إلى 24 ساعة من الإكمال التلقائي لعنوان البريد الإلكتروني ومن مدير جهات الاتصال. لتعديل جهات الاتصال الحالية، يُرجى الاطّلاع على تحديث جهات الاتصال. لا تعدِّل جهات الاتصال من خلال حذف جهات الاتصال ثم إعادة إضافتها.

• لحذف جهة اتصال مشتركة، يمكنك إرسال طلب DELETE إلى عنوان URL لتعديل جهة الاتصال. هذا هو عنوان URL نفسه المُستخدَم لتحديث جهات الاتصال.

تحتفظ Google بالعناصر النائبة لجهات الاتصال المحذوفة لمدة 30 يومًا بعد الحذف. خلال ذلك الوقت، يمكنك طلب العناصر النائبة باستخدام مَعلمة طلب البحث showdeleted.

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

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