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

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

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

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

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

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

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

You must set the fields system parameter on the get method to specify the fields to return in the response. In most Drive methods this action is only required to return non-default fields but it's mandatory for the about resource. If you omit the parameter, the method returns an error. For more information, see 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 بدون هیچ پارامتری استفاده کنید.

If you want to specify the fields to return in the response, you can set the fields system parameter . If you don't specify the fields parameter, the server returns a default set of fields. For more information, see 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 : Filter the search results using a comma-separated list of MIME types. Apps within the app query scope that can open the listed MIME types are included in the response. If appFilterExtensions are also provided, a union of the two resulting app lists is returned. Examples of MIME types include application/vnd.google-apps.form for Google Forms and application/vnd.google-apps.site for Google Sites. For more examples of MIME types, see Google Workspace and Google Drive supported MIME types .

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

مباحث مرتبط

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

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

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

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