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

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

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

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

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

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

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

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

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"
  }
}

لیست برنامه های کاربر

برنامه‌های Google Drive در Google Workspace Marketplace فهرست شده‌اند و برای راحت‌تر کردن Drive استفاده می‌شوند، مانند برنامه Google Docs یا افزونه‌ای که در Docs برای امضای اسناد استفاده می‌شود. برای اطلاعات بیشتر، به استفاده از برنامه‌های Google Drive مراجعه کنید.

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

اگر می‌خواهید فیلدهایی را برای بازگشت در پاسخ مشخص کنید، می‌توانید پارامتر سیستم fields را تنظیم کنید. اگر پارامتر 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. برای نمونه‌های بیشتر پسوند فایل، صادرات انواع MIME برای اسناد Google Workspace را ببینید.

  نمونه کد زیر نحوه ارائه چند پسوند فایل را به عنوان پارامتر جستجو نشان می دهد: 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"
}

موضوعات مرتبط

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

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

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

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