إدارة محركات الأقراص المشتركة في Google Drive باستخدام برنامج Google Apps Script

توضح عينات التعليمات البرمجية هذه كيف يمكنك استخدام برنامج Google Apps Script لإدارتها والبحث من خلال محتوى محركات الأقراص المشتركة في Google Drive باستخدام واجهة برمجة تطبيقات محرك الأقراص.

للبدء ، انقر فوق + أيقونة في قسم الخدمات لإضافة بحث API Drive إلى مشروع Google الخاص بك. يدعم Script Google Apps حاليًا API V2 على الرغم من أن أحدث إصدار هو V3.

بمجرد تمكين خدمة API Drive ، يمكنك استخدام واجهة برمجة تطبيقات محرك الأقراص للبحث من خلال محتوى محركات الأقراص المشتركة.

إنشاء محرك مشترك

function createSharedDrive() {
  const driveName = 'Digital Inspiration';
  const sharedDrive = Drive.Drives.insert({ name: driveName }, Utilities.getUuid());
  console.log('Shared Drive created', sharedDrive.id);
}

شارك محرك أقراص مشترك مع مستخدم

function shareSharedDriveWithUser({ driveId, role, email }) {
  // role can be writer, reader, organizaer or commenter
  const response = Drive.Permissions.insert(
    {
      role: role,
      type: 'user',
      value: email
    },
    driveId,
    {
      supportsAllDrives: true,
      sendNotificationEmails: true,
      fields: 'emailAddress,role'
    }
  );
  console.log('Shared Drive shared with %s', response.emailAddress);
}

يرجى ملاحظة أنه لا يمكنك مشاركة محرك الأقراص المشترك إلا مع حسابات Google. لن يلقي API استثناءً إذا حاولت مشاركة محرك أقراص مشترك مع حساب غير طوابق.

قائمة جميع محركات الأقراص المشتركة

اطبع قائمة بجميع محركات الأقراص المشتركة التي يمكن الوصول إليها للمستخدم الحالي.

function listSharedDrives() {
  let pageToken = null;
  const response = [];

  do {
    const { items = [], nextPageToken = null } = Drive.Drives.list({
      pageToken,
      maxResults: 50,
      orderBy: 'name',
      fields: 'nextPageToken, items(id, name)'
    });
    items.forEach((item) => response.push(item));
    pageToken = nextPageToken;
  } while (pageToken !== null);

  console.log(response);
}

سرد الملفات في محرك أقراص مشترك

في المثال التالي ، سنقوم بطباعة قائمة بجميع الملفات الموجودة في محرك أقراص مشترك محدد تم تحديده بواسطة معرف محرك الأقراص الذي استعدناه في المثال السابق.

function listFilesInSharedDrive(teamDriveId) {
  let pageToken = null;
  const response = [];

  do {
    const { items = [], nextPageToken = null } = Drive.Files.list({
      pageToken,
      maxResults: 50,
      supportsAllDrives: true,
      includeItemsFromAllDrives: true,
      q: `'${teamDriveId}' in parents and trashed = false and mimeType != 'application/vnd.google-apps.folder'`,
      fields: 'nextPageToken, items(id,title,mimeType)'
    });
    items.forEach((item) => response.push(item));
    pageToken = nextPageToken;
  } while (pageToken !== null);

  console.log(response);
}

نقل الملفات في محركات الأقراص المشتركة

يمكن نقل الملفات الموجودة في محرك مشترك محدد إلى محرك مشترك آخر أو إلى مجلد آخر في نفس محرك الأقراص المشترك اعتمادًا على الأذونات.

function moveFilesBetweenSharedDrives({ parentFolderId, destinationFolderId, fileId }) {
  const data = Drive.Files.update({}, fileId, null, {
    addParents: destinationFolderId,
    removeParents: parentFolderId,
    supportsAllDrives: true,
    fields: 'title,embedLink'
  });
  console.log('File Moved', data.title, data.embedLink);
}

ال getCanMoveItemOutOfDrive() يمكن استخدام الطريقة لتحديد ما إذا كان يمكن للمستخدم الحالي نقل هذا العنصر خارج محرك الأقراص عن طريق تغيير الوالدين.

نسخ الملفات في محركات الأقراص المشتركة

يوضح المقتطف التالي كيف يمكنك نسخ الملفات من محرك أقراص مشترك إلى آخر أو بين مجلدات من نفس محرك الأقراص. ال destinationFolerId هو معرف المجلد حيث سيتم نسخ الملف إليه.

function copyFilesInSharedDrives({ title, destinationFolderId, fileId }) {
  const data = Drive.Files.copy({ parents: [{ id: destinationFolderId }], title }, fileId, {
    supportsAllDrives: true,
    fields: 'title,embedLink'
  });
  console.log('File Copied', data.title, data.embedLink);
}