مدیریت فراداده فایل

این سند ملاحظات مهمی را برای نام‌گذاری فایل‌ها و کار با ابرداده‌ها مانند متن و تصاویر کوچک نمایه‌سازی می‌کند. برای درج و بازیابی فایل ها، به منبع files مراجعه کنید.

نام فایل ها و پسوندها را مشخص کنید

هنگام درج فایل‌ها با Google Drive API، برنامه‌ها باید پسوند فایل را در ویژگی عنوان مشخص کنند. به عنوان مثال، عملیات درج یک فایل JPEG باید چیزی مانند "name": "cat.jpg" در ابرداده.

پاسخ‌های بعدی GET می‌توانند شامل ویژگی fileExtension فقط خواندنی باشند که با پسوندی که در اصل در ویژگی name مشخص شده است، پر شده است. وقتی کاربر Google Drive درخواست دانلود فایلی را می‌کند، یا زمانی که فایل از طریق سرویس گیرنده همگام‌سازی دانلود می‌شود، Drive یک نام فایل کامل (با پسوند) را بر اساس عنوان می‌سازد. در مواردی که برنامه افزودنی وجود ندارد، Drive تلاش می‌کند پسوند را بر اساس نوع MIME فایل تعیین کند.

ذخیره متن قابل نمایه سازی

Drive به‌طور خودکار اسناد را برای جستجو فهرست‌بندی می‌کند که نوع فایل را تشخیص می‌دهد، از جمله اسناد متنی، فایل‌های PDF، تصاویر دارای متن، و انواع رایج دیگر. اگر برنامه شما انواع دیگری از فایل‌ها را ذخیره می‌کند (مانند نقاشی‌ها، ویدیوها و میانبرها)، می‌توانید با ارائه متن قابل نمایه‌سازی در قسمت contentHints.indexableText فایل، قابلیت شناسایی را بهبود ببخشید.

متن قابل نمایه سازی به صورت HTML نمایه می شود. اگر رشته متن قابل نمایه سازی <section attribute="value1">Here's some text</section> ذخیره کنید، "در اینجا مقداری متن" نمایه می شود، اما "value1" ایندکس نمی شود. به همین دلیل، ذخیره XML به عنوان متن قابل نمایه سازی به اندازه ذخیره HTML مفید نیست.

هنگام تعیین indexableText ، همچنین به خاطر داشته باشید:

  • محدودیت اندازه برای contentHints.indexableText 128 کیلوبایت است.
  • عبارات و مفاهیم کلیدی را که از کاربر انتظار دارید جستجو کند را ضبط کنید.
  • سعی نکنید متن را به ترتیب اهمیت مرتب کنید زیرا نمایه ساز این کار را به طور موثر برای شما انجام می دهد.
  • برنامه شما باید متن قابل نمایه سازی را با هر ذخیره به روز کند.
  • مطمئن شوید که متن مربوط به محتوای فایل یا ابرداده است.

این نکته آخر ممکن است بدیهی به نظر برسد، اما مهم است. این ایده خوبی نیست که عباراتی که معمولاً جستجو می‌شوند را اضافه کنید تا فایلی را مجبور کنید در نتایج جستجو ظاهر شود. این می تواند کاربران را ناامید کند و حتی ممکن است آنها را تشویق کند که فایل را حذف کنند.

تصاویر کوچک را آپلود کنید

Drive به‌طور خودکار برای بسیاری از انواع فایل‌های رایج، مانند Google Docs، Sheets و Slides، تصاویر کوچک تولید می‌کند. ریز عکسها به کاربر کمک می کند تا فایل های Drive را بهتر شناسایی کند.

برای انواع فایل‌هایی که Drive نمی‌تواند یک تصویر کوچک استاندارد ایجاد کند، می‌توانید یک تصویر کوچک ایجاد شده توسط برنامه خود ارائه دهید. در طول ایجاد یا به‌روزرسانی فایل، با تنظیم فیلد contentHints.thumbnail در منبع files ، یک تصویر کوچک آپلود کنید.

به طور مشخص:

  • فیلد contentHints.thumbnail.image را روی URL و نام فایل تصویر کدگذاری شده با پایه 64 ایمن تنظیم کنید (به بخش 5 RFC 4648 مراجعه کنید).
  • فیلد contentHints.thumbnail.mimeType را روی نوع MIME مناسب برای تصویر کوچک تنظیم کنید.

اگر Drive بتواند یک تصویر کوچک از فایل ایجاد کند، از تصویری که به طور خودکار تولید می‌شود استفاده می‌کند و هر چیزی را که ممکن است آپلود کرده باشید نادیده می‌گیرد. اگر نتواند یک تصویر کوچک ایجاد کند، از تصویری که شما ارائه می‌کنید استفاده می‌کند.

تصاویر کوچک باید از این قوانین پیروی کنند:

  • می توان در فرمت های PNG، GIF یا JPG آپلود کرد.
  • عرض توصیه شده 1600 پیکسل است.
  • حداقل عرض 220 پیکسل است.
  • حداکثر حجم فایل 2 مگابایت است.
  • آنها باید با هر ذخیره توسط برنامه شما به روز شوند.

برای اطلاعات بیشتر به منبع files مراجعه کنید.

ریز عکسها را بازیابی کنید

می‌توانید ابرداده‌ها، از جمله تصاویر کوچک، را برای فایل‌های Drive بازیابی کنید. اطلاعات بند انگشتی در قسمت thumbnailLink منبع files قرار می گیرد.

یک تصویر کوچک خاص را برگردانید

نمونه کد زیر یک درخواست متد files.get را با چندین فیلد به عنوان پارامتر پرس و جو برای برگرداندن ابرداده thumbnailLink برای یک فایل خاص نشان می دهد. برای اطلاعات بیشتر، به بازگشت فیلدهای خاص برای یک فایل مراجعه کنید.

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

FILE_ID با fileId فایلی که می خواهید پیدا کنید جایگزین کنید.

در صورت موجود بودن، درخواست یک URL کوتاه مدت را به تصویر کوچک فایل برمی گرداند. به طور معمول، لینک برای چند ساعت طول می کشد. این فیلد فقط زمانی پر می شود که برنامه درخواست کننده بتواند به محتوای فایل دسترسی داشته باشد. اگر فایل به‌صورت عمومی به اشتراک گذاشته نمی‌شود، URL بازگردانده شده در thumbnailLink باید با استفاده از یک درخواست اعتبارسنجی واکشی شود.

فهرستی از تصاویر کوچک را برگردانید

نمونه کد زیر یک درخواست روش files.list را با چندین فیلد به عنوان پارامتر پرس و جو برای برگرداندن ابرداده thumbnailLink برای لیستی از فایل ها نشان می دهد. برای اطلاعات بیشتر، به جستجوی فایل‌ها و پوشه‌ها مراجعه کنید.

GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)

برای محدود کردن نتایج جستجو به یک نوع فایل خاص، یک رشته کوئری برای تنظیم نوع MIME اعمال کنید. برای مثال، نمونه کد زیر نحوه محدود کردن لیست را به فایل‌های Google Sheets نشان می‌دهد. برای اطلاعات بیشتر در مورد انواع MIME، به انواع MIME پشتیبانی شده Google Workspace و Google Drive مراجعه کنید.

GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)