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

يختلف تعديل صورة لجهة اتصال مشتركة قليلاً عن تعديل معلومات جهة اتصال مشتركة. للحصول على معلومات حول استخدام معلومات جهة اتصال مشتركة ، يُرجى الاطّلاع على مقالة تعديل جهة اتصال مشتركة أو حذفها. عند استخدام روابط الصور، يجب تحديد رمز التفويض في رأس 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.