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

يختلف تعديل صورة جهة اتصال مشترَكة قليلاً عن تعديل معلومات جهة اتصال مشترَكة. للحصول على معلومات حول استخدام معلومات جهة اتصال مشترَكة، يُرجى الاطّلاع على تعديل جهة اتصال مشترَكة أو حذفها. عند استخدام روابط الصور، يجب تحديد رمز الإذن في عنوان HTTP. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض.

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

تحتوي كل جهة اتصال مشترَكة على عنصر رابط صورة. يظهر عنصر رابط الصورة سواء كانت جهة الاتصال تتضمّن صورة مرتبطة بها أم لا. إذا كانت جهة الاتصال تتضمّن صورة، سيحتوي العنصر على السمة gd:etag التي تحدّد عنوان HTTP ETag للصورة. تتيح لك ETag الإشارة إلى إصدار معيّن من إدخال معيّن. في هذه الحالة، يتيح لك ذلك الإشارة إلى إصدار معيّن من صورة. إذا لم يكن لدى جهة الاتصال صورة، لن تتوفّر السمة gd:etag، وستوفّر السمة href عنوان URL الذي يمكن استخدامه لإضافة صورة إلى جهة الاتصال.

• لإضافة صورة أو تعديلها، أرسِل صورة جديدة:

  PUT https://www.google.com/m8/feeds/photos/media/USER_ID%40DOMAIN/PHOTO_LINK

  غيِّر القيم في السلسلة على الشكل التالي:

  • ‫USER_ID: اسم المستخدم، مثل Alex.
  • DOMAIN: عنوان URL الخاص بنطاقك، مثل example.com.
  • PHOTO_LINK: قيمة رقمية فريدة تمثّل رابط الصورة الخاصة بجهة الاتصال المشترَكة، مثل c9012de.

  في ما يلي مثال على عنصر رابط صورة:

  <link rel="http://schemas.google.com/contacts/2008/rel#photo"
  type="image/*" href="https://www.google.com/m8/feeds/photos/media/Alex%40example.com/c9012de">
  

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

لحذف صورة، يجب استخدام طريقة HTTP DELETE.

عند تعديل صورة أو حذفها، أرسِل ETag الصورة في عنوان If-Match لطلب HTTP. إذا لم يكن لديك أحدث إصدار من الصورة، استخدِم If-Match: * لتجاوز نظام تحديد الإصدارات وحذف الصورة.

لمزيد من المعلومات حول ETags، يُرجى الاطّلاع على مرجع بروتوكول Google Data APIs.