يختلف تعديل صورة جهة اتصال مشترَكة قليلاً عن تعديل معلومات جهة اتصال مشترَكة. للحصول على معلومات عن التعامل مع معلومات ملف شخصي مشترَك، يُرجى الاطّلاع على مقالة تعديل ملف تجاري مشترَك أو حذفه. عند استخدام روابط الصور، يجب تحديد رمز التفويض في عنوان HTTP. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التعرّف على المصادقة والتفويض.
تعديل صورة لجهة اتصال مشتركة
تحتوي كل جهة اتصال مشترَكة على عنصر رابط صورة. يظهر عنصر رابط الصورة
سواء كانت جهة الاتصال مرتبطة بصورة أم لا. إذا كانت جهة الاتصال تتضمّن
صورة، سيحتوي العنصر على سمة gd:etag تحدّد عنوان ETag
HTTP للصورة. يتيح لك الرمز ETag الإشارة إلى إصدار معيّن من
إدخال معيّن. في هذه الحالة، يتيح لك الإشارة إلى إصدار معيّن من
صورة. إذا لم تكن جهة الاتصال تتضمّن صورة، لن تتوفّر سمة gd:etag، وتوفر سمة href عنوان URL لاستخدامه لإضافة صورة إلى جهة الاتصال.
لإضافة صورة أو تعديلها، أرسِل صورة جديدة باتّباع الخطوات التالية:
PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINKغيِّر القيم في السلسلة على الشكل التالي:
DOMAIN: عنوان URL لنطاقك، على سبيل المثال، example.comPHOTO_LINK: قيمة رقمية فريدة تُمثِّل رابط الصورة لجهة الاتصال التي تمت مشاركتها، على سبيل المثال، c9012de.
في ما يلي مثال على عنصر رابط صورة:
<link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.google.com/m8/feeds/photos/media/liz%40example.com/c9012de">
حذف صورة لجهة اتصال مشترَكة
لحذف صورة، يجب استخدام طريقة HTTP DELETE.
عند تعديل صورة أو حذفها، أرسِل ETag للصورة في If-Match
عنوان طلب HTTP. إذا لم يكن لديك أحدث إصدار من الصورة،
استخدِم If-Match: * لإلغاء نظام الإصدارات وحذف الصورة.
لمزيد من المعلومات عن ETags، اطّلِع على
مرجع بروتوكول Google Data APIs.