Google Drive API

رابط برنامه‌نویسی کاربردی گوگل درایو به کاربران اجازه می‌دهد تا به منابع گوگل درایو دسترسی داشته باشند.

سرویس: googleapis.com/drive/v2

برای فراخوانی این سرویس، توصیه می‌کنیم از کتابخانه‌های کلاینت ارائه شده توسط گوگل استفاده کنید. اگر برنامه شما برای فراخوانی این سرویس نیاز به استفاده از کتابخانه‌های خودتان دارد، هنگام ارسال درخواست‌های API از اطلاعات زیر استفاده کنید.

سند کشف

یک سند کشف ، مشخصاتی قابل خواندن توسط ماشین برای توصیف و استفاده از APIهای REST است. از آن برای ساخت کتابخانه‌های کلاینت، افزونه‌های IDE و سایر ابزارهایی که با APIهای گوگل تعامل دارند، استفاده می‌شود. یک سرویس ممکن است چندین سند کشف ارائه دهد. این سرویس سند کشف زیر را ارائه می‌دهد:

نقطه پایانی سرویس

یک نقطه پایانی سرویس ، یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و تمام URI های زیر نسبت به این نقطه پایانی سرویس هستند:

  • https://www.googleapis.com

منبع REST: v2.about

روش‌ها
get GET /drive/v2/about
اطلاعات مربوط به کاربر فعلی را به همراه تنظیمات Drive API دریافت می‌کند.

منبع REST: v2.apps

روش‌ها
get GET /drive/v2/apps/{appId}
یک برنامه خاص را دریافت می‌کند.
list GET /drive/v2/apps
برنامه‌های نصب‌شده‌ی کاربر را فهرست می‌کند.

منبع REST: v2.changes

روش‌ها
get GET /drive/v2/changes/{changeId}
منسوخ شده: changes.getStartPageToken و changes.list برای بازیابی تغییرات اخیر استفاده کنید.
getStartPageToken GET /drive/v2/changes/startPageToken
توکن صفحه شروع را برای فهرست کردن تغییرات آینده دریافت می‌کند.
list GET /drive/v2/changes
تغییرات مربوط به یک کاربر یا درایو مشترک را فهرست می‌کند.
watch POST /drive/v2/changes/watch
مشترک شدن در تغییرات برای یک کاربر.

منبع REST: v2.channels

روش‌ها
stop POST /drive/v2/channels/stop
تماشای منابع از طریق این کانال را متوقف می‌کند.

منبع REST: v2.children

روش‌ها
delete DELETE /drive/v2/files/{folderId}/children/{childId}
یک فرزند را از یک پوشه حذف می‌کند.
get GET /drive/v2/files/{folderId}/children/{childId}
یک ارجاع فرزند خاص دریافت می‌کند.
insert POST /drive/v2/files/{folderId}/children
یک فایل را در یک پوشه قرار می‌دهد.
list GET /drive/v2/files/{folderId}/children
فرزندان یک پوشه را لیست می‌کند.

منبع REST: v2.comments

روش‌ها
delete DELETE /drive/v2/files/{fileId}/comments/{commentId}
یک نظر را حذف می‌کند.
get GET /drive/v2/files/{fileId}/comments/{commentId}
یک نظر را بر اساس شناسه دریافت می‌کند.
insert POST /drive/v2/files/{fileId}/comments
یک نظر جدید در فایل داده شده ایجاد می‌کند.
list GET /drive/v2/files/{fileId}/comments
نظرات یک فایل را لیست می‌کند.
patch PATCH /drive/v2/files/{fileId}/comments/{commentId}
یک نظر موجود را به‌روزرسانی می‌کند.
update PUT /drive/v2/files/{fileId}/comments/{commentId}
یک نظر موجود را به‌روزرسانی می‌کند.

منبع REST: v2.drives

روش‌ها
delete DELETE /drive/v2/drives/{driveId}
یک درایو مشترک که کاربر، organizer آن است را به‌طور دائم حذف می‌کند.
get GET /drive/v2/drives/{driveId}
ابرداده‌های یک درایو مشترک را بر اساس شناسه (ID) دریافت می‌کند.
hide POST /drive/v2/drives/{driveId}/hide
یک درایو مشترک را از نمای پیش‌فرض پنهان می‌کند.
insert POST /drive/v2/drives
یک درایو مشترک جدید ایجاد می‌کند.
list GET /drive/v2/drives

درایوهای اشتراکی کاربر را فهرست می‌کند.

unhide POST /drive/v2/drives/{driveId}/unhide
یک درایو مشترک را به نمای پیش‌فرض بازیابی می‌کند.
update PUT /drive/v2/drives/{driveId}
ابرداده‌های یک درایو مشترک را به‌روزرسانی می‌کند.

منبع REST: v2.files

روش‌ها
copy POST /drive/v2/files/{fileId}/copy
یک کپی از فایل مشخص شده ایجاد می‌کند.
delete DELETE /drive/v2/files/{fileId}
فایلی که متعلق به کاربر است را بدون انتقال به سطل زباله، به طور دائم حذف می‌کند.
emptyTrash DELETE /drive/v2/files/trash
تمام فایل‌های حذف‌شده‌ی کاربر را به‌طور دائم حذف می‌کند.
export GET /drive/v2/files/{fileId}/export
یک سند Google Workspace را به نوع MIME درخواستی صادر می‌کند و محتوای بایت صادر شده را برمی‌گرداند.
generateIds GET /drive/v2/files/generateIds
مجموعه‌ای از شناسه‌های فایل را تولید می‌کند که می‌توانند در درخواست‌های درج یا کپی ارائه شوند.
get GET /drive/v2/files/{fileId}

فراداده یا محتوای یک فایل را بر اساس شناسه (ID) آن دریافت می‌کند.

insert POST /drive/v2/files
POST /upload/drive/v2/files

یک فایل جدید درج می‌کند.

list GET /drive/v2/files

فایل‌های کاربر را فهرست می‌کند.

listLabels GET /drive/v2/files/{fileId}/listLabels
برچسب‌های روی یک فایل را فهرست می‌کند.
modifyLabels POST /drive/v2/files/{fileId}/modifyLabels
مجموعه برچسب‌های اعمال شده روی یک فایل را تغییر می‌دهد.
patch PATCH /drive/v2/files/{fileId}
فراداده و/یا محتوای یک فایل را به‌روزرسانی می‌کند.
touch POST /drive/v2/files/{fileId}/touch
زمان به‌روزرسانی فایل را روی زمان فعلی سرور تنظیم کنید.
trash POST /drive/v2/files/{fileId}/trash
یک فایل را به سطل زباله منتقل می‌کند.
untrash POST /drive/v2/files/{fileId}/untrash
یک فایل را از سطل زباله بازیابی می‌کند.
update PUT /drive/v2/files/{fileId}
PUT /upload/drive/v2/files/{fileId}

فراداده، محتوای یا هر دوی یک فایل را به‌روزرسانی می‌کند.

watch POST /drive/v2/files/{fileId}/watch
تغییرات اعمال شده در یک فایل را تایید می‌کند.

منبع REST: v2.parents

روش‌ها
delete DELETE /drive/v2/files/{fileId}/parents/{parentId}
یک والد را از یک فایل حذف می‌کند.
get GET /drive/v2/files/{fileId}/parents/{parentId}
یک مرجع والد خاص دریافت می‌کند.
insert POST /drive/v2/files/{fileId}/parents
یک پوشه والد برای یک فایل اضافه می‌کند.
list GET /drive/v2/files/{fileId}/parents
والدین یک فایل را لیست می‌کند.

منبع REST: v2.permissions

روش‌ها
delete DELETE /drive/v2/files/{fileId}/permissions/{permissionId}
یک مجوز را از یک فایل یا درایو مشترک حذف می‌کند.
get GET /drive/v2/files/{fileId}/permissions/{permissionId}
با ارائه کارت شناسایی مجوز می‌گیرد.
getIdForEmail GET /drive/v2/permissionIds/{email}
شناسه مجوز برای یک آدرس ایمیل را برمی‌گرداند.
insert POST /drive/v2/files/{fileId}/permissions
یک مجوز برای یک فایل یا درایو مشترک درج می‌کند.
list GET /drive/v2/files/{fileId}/permissions
مجوزهای یک فایل یا درایو مشترک را فهرست می‌کند.
patch PATCH /drive/v2/files/{fileId}/permissions/{permissionId}
با استفاده از معانی وصله، یک مجوز را به‌روزرسانی می‌کند.
update PUT /drive/v2/files/{fileId}/permissions/{permissionId}
یک مجوز را به‌روزرسانی می‌کند.

منبع REST: v2.properties

روش‌ها
delete DELETE /drive/v2/files/{fileId}/properties/{propertyKey}
یک ویژگی را حذف می‌کند.
get GET /drive/v2/files/{fileId}/properties/{propertyKey}
یک ویژگی را با استفاده از کلید آن دریافت می‌کند.
insert POST /drive/v2/files/{fileId}/properties
یک ویژگی را به یک فایل اضافه می‌کند، یا اگر از قبل وجود داشته باشد، آن را به‌روزرسانی می‌کند.
list GET /drive/v2/files/{fileId}/properties
ویژگی‌های یک فایل را فهرست می‌کند.
patch PATCH /drive/v2/files/{fileId}/properties/{propertyKey}
یک ویژگی را به‌روزرسانی می‌کند.
update PUT /drive/v2/files/{fileId}/properties/{propertyKey}
یک ویژگی را به‌روزرسانی می‌کند.

منبع REST: v2.replies

روش‌ها
delete DELETE /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
یک پاسخ را حذف می‌کند.
get GET /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
پاسخ دریافت می‌کند.
insert POST /drive/v2/files/{fileId}/comments/{commentId}/replies
یک پاسخ جدید برای نظر داده شده ایجاد می‌کند.
list GET /drive/v2/files/{fileId}/comments/{commentId}/replies
تمام پاسخ‌های داده شده به یک نظر را فهرست می‌کند.
patch PATCH /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
یک پاسخ موجود را به‌روزرسانی می‌کند.
update PUT /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
یک پاسخ موجود را به‌روزرسانی می‌کند.

منبع REST: نسخه ۲.revisions

روش‌ها
delete DELETE /drive/v2/files/{fileId}/revisions/{revisionId}
نسخه‌ای از فایل را به‌طور دائم حذف می‌کند.
get GET /drive/v2/files/{fileId}/revisions/{revisionId}
یک ویرایش خاص دریافت می‌کند.
list GET /drive/v2/files/{fileId}/revisions
لیست ویرایش‌های یک فایل را نمایش می‌دهد.
patch PATCH /drive/v2/files/{fileId}/revisions/{revisionId}
یک نسخه را به‌روزرسانی می‌کند.
update PUT /drive/v2/files/{fileId}/revisions/{revisionId}
یک نسخه را به‌روزرسانی می‌کند.