پرش به مطلب اصلی

ذخیره‌ی ظاهر صفحه‌ی اشتراک یک پوشه

PUT 
/api/v1/IOService/ShareBranding/Box/:boxId/Appearance

تنظیم ظاهر صفحه‌ی اشتراک یک پوشه را جایگزین می‌کند و تنظیم ذخیره‌شده را برمی‌گرداند.

دسترسی: کاربر واردشده با Authorization و x-container (مقدار container که GET /api/v1/services/current برمی‌گرداند). حق WRITE لازم است.

بدنه‌ی درخواست: logoFileId (شناسه‌ی یک تصویر در فضای کاربر، یا null)، colors (هر کدام از pageBackground، pageText، cardBackground، cardBorder، cardText، buttonBackground، buttonBorder، buttonText و link به شکل #rrggbb؛ رنگ خالی یا نیامده یعنی رنگ پیش‌فرض ابردرایو) و hideMyDrive. اگر نه نشانی باشد، نه رنگی و نه hideMyDrive، تنظیم پوشه پاک می‌شود و پوشه دوباره از پوشه‌ی بالاتر ارث می‌برد.

پاسخ: appearance (تنظیم خود پوشه: logoFileId، colors و hideMyDrive؛ یا null)، logo (id، name و box تصویر نشان، یا null اگر نشان نداشته باشد یا دیگر معتبر نباشد) و inherited (ظاهری که از نزدیک‌ترین پوشه‌ی بالاتر به ارث می‌رسد: box، colors، hasLogo و hideMyDrive؛ یا null).

محدودیت‌ها: نشان باید فایل PNG، JPEG یا WebP در فضای همین کاربر باشد، در سطل بازیافت یا پوشه‌ی رمزگذاری‌شده نباشد و از سقف اندازه (به‌طور پیش‌فرض ۲ مگابایت) بزرگ‌تر نباشد.

خطاها: 400 به شکل { error, code, limit } با code یکی از INVALID_COLOR، LOGO_NOT_FOUND، LOGO_LOCKED، LOGO_NOT_IMAGE یا LOGO_TOO_LARGE (با limit به کیلوبایت)؛ 403 بدون حق WRITE؛ و 403 با code: NOT_ENABLED وقتی مدیر سامانه این قابلیت را برای حساب روشن نکرده باشد؛ پوشه بیرون از فضای مشترک 404؛ پوشه‌ی رمزگذاری‌شده و قفل 409؛ نبودن Authorization یا ناهمخوانی x-container با کاربر 401، نبودن x-container در درخواست 400.

درخواست​

پاسخ‌ها​

OK