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
: شناسه فهرست محصول برای این برنامه.
مطالب مرتبط
در اینجا چند مرحله بعدی وجود دارد که ممکن است امتحان کنید:
برای ایجاد فایل در Drive، به ایجاد فایلها مراجعه کنید.
برای آپلود دادههای فایل هنگام ایجاد یا بهروزرسانی فایل، به آپلود دادههای فایل مراجعه کنید.
برای دانلود و صادر کردن فایلها، به دانلود و صادرات فایلها مراجعه کنید.