عکسی را برای یک مخاطب مشترک به‌روزرسانی یا حذف کنید

به‌روزرسانی عکس برای یک مخاطب مشترک کمی متفاوت از به‌روزرسانی اطلاعات یک مخاطب مشترک است. برای اطلاعات بیشتر در مورد کار با اطلاعات یک مخاطب مشترک، به «به‌روزرسانی یا حذف یک مخاطب مشترک » مراجعه کنید. هنگام استفاده از لینک‌های عکس، باید توکن مجوز را در هدر 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 : آدرس اینترنتی دامنه شما - برای مثال، 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 مراجعه کنید.