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

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

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

عند تعديل إدخال، يجب الاحتفاظ بجميع ملف XML الذي كان متوفّرًا عند retrieving the entry from the server. وبخلاف ذلك، تتم إزالة العناصر التي تم تجاهلها. قد يستغرق ظهور التعديلات في قائمة الإكمال التلقائي لعناوين البريد الإلكتروني ومدير جهات الاتصال مدة تصل إلى 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.

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

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