تعديل صورة أو حذفها لجهة اتصال مشتركة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يختلف تعديل صورة جهة اتصال مشترَكة قليلاً عن تعديل
معلومات جهة اتصال مشترَكة. للحصول على معلومات عن التعامل مع معلومات جهة اتصال
مشترَكة، يُرجى الاطّلاع على مقالة تعديل جهة اتصال مشترَكة أو حذفها.
عند استخدام روابط الصور، يجب تحديد رمز التفويض في عنوان 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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Update or delete a photo for a shared contact\n\nUpdating a photo for a shared contact is slightly different than updating a\nshared contact's information. For information about working with a shared\ncontact's information, see\n[Update or delete a shared contact](/workspace/admin/domain-shared-contacts/update-delete-shared-contacts).\nWhen using photo links, you must specify the authorization token in the HTTP\nheader. For more information, see\n[Learn about authentication and authorization](https://developers.google.com/workspace/guides/auth-overview).\n\nUpdate a photo for a shared contact\n-----------------------------------\n\nEvery shared contact has a photo link element. The photo link element appears\nwhether the contact has an associated photo or not. If the contact does have a\nphoto, then the element contains a `gd:etag` attribute that specifies an `ETag`\nHTTP header for the photo. An `ETag` lets you refer to a specific version of a\nparticular entry. In this case, it lets you refer to a specific verion of a\nphoto. If the contact has no photo, then there's no `gd:etag` attribute, and\nthe `href` attribute provides the URL to use to add a\nphoto to the contact.\n\n- To add or update a photo, send a new photo:\n\n ```xml\n PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eDOMAIN\u003c/var\u003e: The URL for your domain---for example, example.com.\n - \u003cvar translate=\"no\"\u003ePHOTO_LINK\u003c/var\u003e: A unique numerical value that represents the photo link for the shared contact---for example, c9012de.\n\n The following is an example of a photo link element: \n\n ```\n \u003clink rel=\"http://schemas.google.com/contacts/2008/rel#photo\"\n type=\"image/*\" href=\"https://www.google.com/m8/feeds/photos/media/liz%40example.com/c9012de\"\u003e\n ```\n\nDelete a photo for a shared contact\n-----------------------------------\n\nTo delete a photo, you must use the HTTP `DELETE` method.\n\nWhen updating or deleting a photo, send the photo's `ETag` in the `If-Match`\nheader of the HTTP request. If you don't have the latest version of the photo\nuse `If-Match: *` to override the versioning system and delete the photo.\n\nFor more information about `ETags`, see the\n[Google Data APIs protocol reference](https://developers.google.com/gdata/docs/2.0/reference#ResourceVersioning)."]]
