اطلاعات کاربر را برگردانید، اطلاعات کاربر را برگردانید

گوگل درایو دو گزینه برای جمع‌آوری اطلاعات کاربران درایو ارائه می‌دهد:

• با استفاده از منبع about ، می‌توانید اطلاعات مربوط به کاربر، تنظیمات درایو کاربر و قابلیت‌های سیستم او را بازیابی کنید.

• با استفاده از منبع apps ، می‌توانید لیستی از برنامه‌های نصب شده کاربر را به همراه اطلاعاتی در مورد انواع MIME پشتیبانی شده توسط هر برنامه، پسوند فایل‌ها و سایر جزئیات بازیابی کنید.

این راهنما نحوه بازیابی اطلاعات کاربر در Drive را توضیح می‌دهد.

دریافت جزئیات مربوط به یک کاربر

برای بازگرداندن اطلاعات مربوط به یک کاربر Drive به عنوان نمونه‌ای از about ، از متد get استفاده کنید. مقادیر برگردانده شده بر حسب بایت اندازه‌گیری می‌شوند.

شما باید پارامتر سیستمی fields را در متد get تنظیم کنید تا فیلدهایی که باید در پاسخ برگردانده شوند، مشخص شوند. در اکثر متدهای Drive این عمل فقط برای برگرداندن فیلدهای غیر پیش‌فرض لازم است، اما برای منبع about اجباری است. اگر پارامتر را حذف کنید، متد خطا برمی‌گرداند. برای اطلاعات بیشتر، به بخش Return specific fields مراجعه کنید.

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

فهرست کردن برنامه‌های کاربر

برنامه‌های گوگل درایو در بازار فضای کاری گوگل فهرست شده‌اند و برای راحت‌تر کردن استفاده از درایو استفاده می‌شوند، مانند برنامه گوگل داکز یا افزونه‌ای که در داکز برای امضای اسناد استفاده می‌شود. برای اطلاعات بیشتر، به بخش «استفاده از برنامه‌های گوگل درایو» مراجعه کنید.

برای بازگرداندن لیستی از تمام برنامه‌های نصب‌شده‌ی کاربر به عنوان نمونه‌ای از apps ، از متد list بدون هیچ پارامتری استفاده کنید.

اگر می‌خواهید فیلدهایی را که باید در پاسخ برگردانده شوند، مشخص کنید، می‌توانید پارامتر سیستمی fields تنظیم کنید. اگر پارامتر fields را مشخص نکنید، سرور مجموعه‌ای پیش‌فرض از فیلدها را برمی‌گرداند. برای اطلاعات بیشتر، به بخش «Return specific fields» مراجعه کنید.

GET https://www.googleapis.com/drive/v3/apps

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

فهرست کردن برنامه‌های کاربر با پارامترهای پرس‌وجو

برای یافتن یک برنامه خاص، از یک یا چند پارامتر اختیاری پرس و جو استفاده کنید:

• appFilterExtensions : نتایج جستجو را با استفاده از فهرستی از پسوندهای فایل که با کاما از هم جدا شده‌اند، فیلتر می‌کند. برنامه‌هایی که در محدوده‌ی کوئری برنامه قرار دارند و می‌توانند پسوندهای فایل ذکر شده را باز کنند، در پاسخ گنجانده می‌شوند. اگر appFilterMimeTypes نیز ارائه شود، ترکیبی از دو فهرست برنامه‌ی حاصل بازگردانده می‌شود. نمونه‌هایی از پسوندها شامل docx برای Microsoft Word و pptx برای Microsoft PowerPoint است. برای نمونه‌های بیشتر از پسوندهای فایل، به Export MIME types for Google Workspace documents مراجعه کنید.

  نمونه کد زیر نحوه ارائه چندین پسوند فایل را به عنوان پارامتر پرس و جو نشان می‌دهد: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx .

• appFilterMimeTypes : نتایج جستجو را با استفاده از لیستی از انواع MIME که با کاما از هم جدا شده‌اند، فیلتر می‌کند. برنامه‌هایی که در محدوده‌ی کوئری برنامه قرار دارند و می‌توانند انواع MIME فهرست‌شده را باز کنند، در پاسخ گنجانده می‌شوند. اگر appFilterExtensions نیز ارائه شود، ترکیبی از دو لیست برنامه‌ی حاصل بازگردانده می‌شود. نمونه‌هایی از انواع MIME شامل application/vnd.google-apps.form برای Google Forms و application/vnd.google-apps.site برای Google Sites است. برای مثال‌های بیشتر از انواع MIME، به انواع MIME پشتیبانی‌شده توسط Google Workspace و Google Drive مراجعه کنید.

  نمونه کد زیر نحوه ارائه چندین نوع MIME را به عنوان پارامتر پرس و جو نشان می‌دهد: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site .

• languageCode : نتایج جستجو را با استفاده از یک کد زبان یا منطقه، همانطور که توسط BCP 47 تعریف شده است، با برخی از افزونه‌های فرمت LDML یونیکد، فیلتر کنید. نمونه‌هایی از کدهای زبان شامل en-us برای انگلیسی (ایالات متحده) و fr-ca برای فرانسوی (کانادا) است.

  نمونه کد زیر نحوه ارائه کدهای چندین زبان را به عنوان پارامتر پرس و جو نشان می‌دهد: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca .

دریافت برنامه کاربر بر اساس شناسه

برای دانلود اطلاعات دقیق برنامه به عنوان نمونه‌ای از apps ، از متد get به همراه شناسه برنامه استفاده کنید.

GET https://www.googleapis.com/drive/v3/apps/APP_ID

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

مباحث مرتبط

در اینجا چند مرحله بعدی وجود دارد که می‌توانید امتحان کنید:

• برای ایجاد فایل در درایو، به ایجاد و مدیریت فایل‌ها مراجعه کنید.

• برای آپلود داده‌های فایل هنگام ایجاد یا به‌روزرسانی یک فایل، به «بارگذاری داده‌های فایل» مراجعه کنید.

• برای دانلود و خروجی گرفتن فایل‌ها، به «دانلود و خروجی گرفتن فایل‌ها» مراجعه کنید.