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

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

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

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

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

1. احصل على الإدخال المطلوب تعديله.
2. عدِّل الإدخال.

3. أرسِل طلب PUT يتضمّن الإدخال المعدَّل إلى عنوان URL لتعديل جهة الاتصال. استخدِم نوع المحتوى application/atom+xml وتأكَّد من أنّ قيمة <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: نطاقك، مثل example.com
   • TITLE_NAME: اسم للإدخال، مثل قائمة جهات الاتصال في example.com
   • FIRST_NAME: الاسم الأول لجهة الاتصال
   • LAST_NAME: الاسم الأخير لجهة الاتصال
   • PROJECTION: قيمة العرض للاطّلاع على القيم المسموح بها، راجِع قيم العرض.
   • PRIMARY_PHONE_NUMBER: رقم الهاتف المفضّل
   • 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 لطلبها.

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

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