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

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

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

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

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

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

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

متد get() به پارامتر fields نیاز دارد تا فیلدهایی را که باید در پاسخ برگردانده شوند فهرست کند. اگر پارامتر را حذف کنید، متد یک خطا برمی گرداند. برای برگرداندن فیلدهای دقیق مورد نیاز، به بازگشت فیلدهای خاص مراجعه کنید.

یک مثال نشان دهید

نمونه کد زیر نحوه ارائه چندین 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"
  }
}

پاسخ شامل مقادیر زیر است:

  • DISPLAY_NAME : نام کاربر در متن ساده.
  • PHOTO_LINK : URL عکس نمایه کاربر.
  • PERMISSION_ID : شناسه کاربر در منابع Permission .
  • EMAIL_ADDRESS : آدرس ایمیل کاربر

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

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

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

می‌توانید پارامتر 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"
  ]
}

پاسخ شامل مقادیر زیر است:

  • ID : شناسه برنامه
  • PRODUCT_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() با شناسه برنامه استفاده کنید.

یک مثال نشان دهید

نمونه کد زیر نحوه ارائه appId را به عنوان پارامتر پرس و جو در درخواست نشان می دهد. پاسخ مقادیر فیلد درخواست را برمی گرداند.

درخواست کنید

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

پاسخ شامل مقادیر زیر است:

  • ID : شناسه برنامه
  • PRODUCT_ID : شناسه فهرست محصول برای این برنامه.

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