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

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

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

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

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

واکشی اطلاعات در مورد یک کاربر

برای برگرداندن اطلاعات یک کاربر Drive به عنوان نمونه about ، از روش about.get استفاده کنید. متد about.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 ، از روش apps.list بدون هیچ پارامتری استفاده کنید.

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

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

درخواست

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 ، از روش 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 : شناسه فهرست محصول برای این برنامه.

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