إدارة مساحات Drive المشتركة

يتضمّن هذا الدليل مهامًا متعلّقة بإدارة مساحات التخزين السحابي المشتركة، مثل إنشاء مساحات تخزين سحابي مشتركة وإدارة الأعضاء والأذونات باستخدام Google Drive API.

إذا أردت تحديد الحقول التي سيتم عرضها في الردّ، يمكنك ضبط المَعلمة fields system باستخدام أي طريقة من طرق المورد drives. في حال عدم تحديد المَعلمة fields، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. على سبيل المثال، تعرض الطريقة list الحقول kind وid وname فقط لكل مساحة تخزين سحابي مشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على عرض حقول معيّنة.

لمزيد من المعلومات عن حدود مجلدات مساحة التخزين السحابي المشتركة، يُرجى الاطّلاع على المقالة حدود مجلدات مساحة التخزين السحابي المشتركة.

إنشاء "مساحة تخزين سحابي مشتركة"

لإنشاء مساحة تخزين سحابي مشتركة، استخدِم طريقة create في مورد drives مع المَعلمة requestId.

تحدّد المَعلمة requestId المحاولة المنطقية لإنشاء مساحة تخزين سحابي مشتركة بشكل متكرر. إذا انتهت مهلة الطلب أو عرض خطأ غير محدّد من الخلفية، يمكن تكرار الطلب نفسه ولن يؤدي ذلك إلى إنشاء نسخ مكررة. يجب أن يظل requestId ونص الطلب كما هما.

يوضّح نموذج الرمز البرمجي التالي كيفية إنشاء مساحة تخزين سحابي مشتركة:

Java

drive/snippets/drive_v3/src/main/java/CreateDrive.java
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.DriveScopes;
import com.google.api.services.drive.model.Drive;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;
import java.util.UUID;

/* class to demonstrate use-case of Drive's create drive. */
public class CreateDrive {

  /**
   * Create a drive.
   *
   * @return Newly created drive id.
   * @throws IOException if service account credentials file not found.
   */
  public static String createDrive() throws IOException {
        /*Load pre-authorized user credentials from the environment.
        TODO(developer) - See https://developers.google.com/identity for
        guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials =
        GoogleCredentials.getApplicationDefault().createScoped(Arrays.asList(DriveScopes.DRIVE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    com.google.api.services.drive.Drive service =
        new com.google.api.services.drive.Drive.Builder(new NetHttpTransport(),
            GsonFactory.getDefaultInstance(),
            requestInitializer)
            .setApplicationName("Drive samples")
            .build();

    Drive driveMetadata = new Drive();
    driveMetadata.setName("Project Resources");
    String requestId = UUID.randomUUID().toString();
    try {
      Drive drive = service.drives().create(requestId,
              driveMetadata)
          .execute();
      System.out.println("Drive ID: " + drive.getId());

      return drive.getId();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to create drive: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/drive_snippet/create_drive.py
import uuid

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def create_drive():
  """Create a drive.
  Returns:
      Id of the created drive

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)

    drive_metadata = {"name": "Project Resources"}
    request_id = str(uuid.uuid4())
    # pylint: disable=maybe-no-member
    drive = (
        service.drives()
        .create(body=drive_metadata, requestId=request_id, fields="id")
        .execute()
    )
    print(f'Drive ID: {drive.get("id")}')

  except HttpError as error:
    print(f"An error occurred: {error}")
    drive = None

  return drive.get("id")


if __name__ == "__main__":
  create_drive()

Node.js

drive/snippets/drive_v3/drive_snippets/create_drive.js
/**
 * Create a drive.
 * */
async function createDrive() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');
  const uuid = require('uuid');

  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  const driveMetadata = {
    name: 'Project resources',
  };
  const requestId = uuid.v4();
  try {
    const Drive = await service.drives.create({
      resource: driveMetadata,
      requestId: requestId,
      fields: 'id',
    });
    console.log('Drive Id:', Drive.data.id);
    return Drive.data.id;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveCreateDrive.php
<?php
use Google\Client;
use Google\Service\Drive;
use Ramsey\Uuid\Uuid;
function createDrive()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);

        $driveMetadata = new Drive\Drive(array(
                'name' => 'Project Resources'));
        $requestId = Uuid::uuid4()->toString();
        $drive = $driveService->drives->create($requestId, $driveMetadata, array(
                'fields' => 'id'));
        printf("Drive ID: %s\n", $drive->id);
        return $drive->id;
    } catch(Exception $e)  {
        echo "Error Message: ".$e;
    }  

}

NET.

drive/snippets/drive_v3/DriveV3Snippets/CreateDrive.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Drive.v3.Data;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive's create drive.
    public class CreateDrive
    {
        /// <summary>
        /// Create a drive.
        /// </summary>
        /// <returns>newly created drive Id.</returns>
        public static string DriveCreateDrive()
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var driveMetadata = new Drive()
                {
                    Name = "Project Resources"
                };
                var requestId = Guid.NewGuid().ToString();
                var request = service.Drives.Create(driveMetadata, requestId);
                request.Fields = "id";
                var drive = request.Execute();
                Console.WriteLine("Drive ID: " + drive.Id);
                return drive.Id;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

تكون طلبات الطريقة create متكررة.

إذا تم إنشاء مساحة التخزين السحابي المشتركة بنجاح في طلب سابق أو بسبب إعادة المحاولة، ستعرض الطريقة مثيلاً لمورد drives. في بعض الأحيان، مثل بعد فترة طويلة أو إذا تم تغيير نص الطلب، قد يتم عرض خطأ يشير إلى أنّه يجب تجاهل requestId.409

الحصول على مساحة تخزين سحابي مشتركة

للحصول على البيانات الوصفية لمساحة تخزين سحابي مشتركة، استخدِم طريقة get في مورد drives مع مَعلمة المسار driveId. إذا كنت لا تعرف معرّف مساحة التخزين، يمكنك إدراج جميع مساحات التخزين السحابي المشتركة باستخدام طريقة list.

تعرض الطريقة get مساحة تخزين سحابي مشتركة كمثيل لمورد drives.

لإصدار الطلب بصفتك مشرف نطاق، اضبط معلَمة طلب البحث useDomainAdminAccess على true. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.

عرض قائمة بمساحات التخزين السحابي المشتركة

لعرض قائمة بمساحات التخزين السحابي المشتركة الخاصة بمستخدم، استخدِم طريقة list في المورد drives. تعرض الطريقة قائمة بمساحات التخزين السحابي المشتركة.

مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم الصفحات أو فلترة مساحات Drive المشتركة:

  • pageSize: الحد الأقصى لعدد مساحات التخزين المشتركة التي سيتم عرضها في كل صفحة

  • pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.

  • q: سلسلة طلب البحث للبحث في مساحات Drive المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على البحث عن مساحات التخزين السحابي المشتركة.

  • useDomainAdminAccess: اضبط القيمة على true لإصدار الطلب بصفتك مشرف نطاق من أجل عرض جميع مساحات التخزين السحابي المشتركة في النطاق الذي يكون فيه مقدّم الطلب مشرفًا. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.

تعديل مساحة تخزين سحابي مشتركة

لتعديل البيانات الوصفية لمساحة تخزين سحابي مشتركة، استخدِم طريقة update في المورد drives مع مَعلمة المسار driveId.

تعرض الطريقة مساحة تخزين سحابي مشتركة كمثيل لمورد drives.

لإصدار الطلب بصفتك مشرف نطاق، اضبط معلَمة طلب البحث useDomainAdminAccess على true. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.

إخفاء مساحة تخزين سحابي مشتركة وإظهارها

لإخفاء مساحة تخزين سحابي مشتركة من العرض التلقائي، استخدِم طريقة hide في المورد drives مع المَعلمة driveId.

عند إخفاء مساحة تخزين سحابي مشتركة، يضع Drive علامة hidden=true على مصدر مساحة التخزين السحابي المشتركة. لا تظهر مساحات التخزين السحابي المشتركة المخفية في واجهة مستخدم Drive أو في قائمة الملفات التي تم عرضها.

لاستعادة مساحة تخزين سحابي مشتركة إلى العرض التلقائي، استخدِم طريقة unhide في مورد drives مع المَعلمة driveId.

تعرض كلتا الطريقتَين مساحة تخزين سحابي مشتركة كمثيل لمورد drives.

حذف مساحة تخزين سحابي مشتركة

لحذف مساحة تخزين سحابي مشتركة نهائيًا، استخدِم طريقة delete في المورد drives مع المَعلمة driveId.

قبل حذف مساحة تخزين سحابي مشتركة، يجب نقل كل المحتوى فيها إلى المهملات أو حذفه. يجب أن يكون لدى المستخدم أيضًا إذن role=organizer على مجلد مساحة التخزين السحابي المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على نقل الملفات والمجلدات إلى المهملات أو حذفها.

مرِّر مَعلمات طلب البحث التالية لفلترة مساحات التخزين السحابي المشتركة:

  • useDomainAdminAccess: اضبط القيمة على true لإصدار الطلب بصفتك مشرف نطاق من أجل عرض جميع مساحات التخزين السحابي المشتركة في النطاق الذي يكون فيه مقدّم الطلب مشرفًا. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.

  • allowItemDeletion: اضبط القيمة على true لحذف الملفات داخل مساحة التخزين السحابي المشتركة. لا تتوفّر هذه السمة إلا عندما تكون قيمة useDomainAdminAccess هي true أيضًا.

إضافة أعضاء مساحة التخزين السحابي المشتركة أو إزالتهم

يمكنك إضافة أعضاء مساحة التخزين السحابي المشتركة أو إزالتهم باستخدام المورد permissions.

لإضافة عضو، يجب إنشاء الإذن في مساحة التخزين السحابي المشتركة. يمكن أيضًا استخدام طرق منح الأذونات على الملفات الفردية داخل مساحة التخزين السحابي المشتركة لمنح الأعضاء امتيازات إضافية أو السماح لغير الأعضاء بالتعاون في عناصر معيّنة.

لمزيد من المعلومات ونموذج الرمز البرمجي، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين.

إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق

طبِّق المَعلمة useDomainAdminAccess مع الموردَين drives وpermissions لإدارة مساحات التخزين السحابي المشتركة في جميع أنحاء المؤسسة.

يجب أن يكون لدى المستخدمين الذين يستدعون هذه الطرق باستخدام useDomainAdminAccess=true امتيازات المشرف Drive and Docs. يمكن للمشرفين البحث عن مساحات تخزين سحابي مشتركة أو تعديل أذونات مساحات التخزين السحابي المشتركة التي تملكها مؤسستهم، بغض النظر عن عضوية المشرف في أي مساحة تخزين سحابي مشتركة.

عند استخدام حسابات الخدمة، قد تحتاج إلى انتحال هوية مشرف تمت مصادقته باستخدام انتحال هوية حساب الخدمة. يُرجى العِلم أنّ حسابات الخدمة لا تنتمي إلى نطاقك على Google Workspace، على عكس حسابات المستخدمين. إذا شاركت مواد عرض Google Workspace، مثل المستندات أو الأحداث، مع نطاق Google Workspace بأكمله، لن تتم مشاركتها مع حسابات الخدمة. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على حسابات الخدمة.

استرداد مساحة تخزين سحابي مشتركة ليس لديها منظِّم

يوضّح نموذج الرمز التالي كيفية استرداد مساحات التخزين السحابي المشتركة التي لم يعُد لديها منظِّم.

Java

drive/snippets/drive_v3/src/main/java/RecoverDrive.java
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.DriveScopes;
import com.google.api.services.drive.model.Drive;
import com.google.api.services.drive.model.DriveList;
import com.google.api.services.drive.model.Permission;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

/* class to demonstrate use-case of Drive's shared drive without an organizer. */
public class RecoverDrive {

  /**
   * Find all shared drives without an organizer and add one.
   *
   * @param realUser User's email id.
   * @return All shared drives without an organizer.
   * @throws IOException if shared drive not found.
   */
  public static List<Drive> recoverDrives(String realUser)
      throws IOException {
        /*Load pre-authorized user credentials from the environment.
        TODO(developer) - See https://developers.google.com/identity for
        guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials =
        GoogleCredentials.getApplicationDefault().createScoped(Arrays.asList(DriveScopes.DRIVE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    com.google.api.services.drive.Drive service =
        new com.google.api.services.drive.Drive.Builder(new NetHttpTransport(),
            GsonFactory.getDefaultInstance(),
            requestInitializer)
            .setApplicationName("Drive samples")
            .build();
    List<Drive> drives = new ArrayList<Drive>();

    // Find all shared drives without an organizer and add one.
    // Note: This example does not capture all cases. Shared drives
    // that have an empty group as the sole organizer, or an
    // organizer outside the organization are not captured. A
    // more exhaustive approach would evaluate each shared drive
    // and the associated permissions and groups to ensure an active
    // organizer is assigned.
    String pageToken = null;
    Permission newOrganizerPermission = new Permission()
        .setType("user")
        .setRole("organizer");

    newOrganizerPermission.setEmailAddress(realUser);


    do {
      DriveList result = service.drives().list()
          .setQ("organizerCount = 0")
          .setFields("nextPageToken, drives(id, name)")
          .setUseDomainAdminAccess(true)
          .setPageToken(pageToken)
          .execute();
      for (Drive drive : result.getDrives()) {
        System.out.printf("Found drive without organizer: %s (%s)\n",
            drive.getName(), drive.getId());
        // Note: For improved efficiency, consider batching
        // permission insert requests
        Permission permissionResult = service.permissions()
            .create(drive.getId(), newOrganizerPermission)
            .setUseDomainAdminAccess(true)
            .setSupportsAllDrives(true)
            .setFields("id")
            .execute();
        System.out.printf("Added organizer permission: %s\n",
            permissionResult.getId());

      }

      drives.addAll(result.getDrives());

      pageToken = result.getNextPageToken();
    } while (pageToken != null);

    return drives;
  }
}

Python

drive/snippets/drive-v3/drive_snippet/recover_drives.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def recover_drives(real_user):
  """Find all shared drives without an organizer and add one.
  Args:
      real_user:User ID for the new organizer.
  Returns:
      drives object

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()
  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)

    drives = []

    # pylint: disable=maybe-no-member
    page_token = None
    new_organizer_permission = {
        "type": "user",
        "role": "organizer",
        "emailAddress": "user@example.com",
    }
    new_organizer_permission["emailAddress"] = real_user

    while True:
      response = (
          service.drives()
          .list(
              q="organizerCount = 0",
              fields="nextPageToken, drives(id, name)",
              useDomainAdminAccess=True,
              pageToken=page_token,
          )
          .execute()
      )
      for drive in response.get("drives", []):
        print(
            "Found shared drive without organizer: "
            f"{drive.get('title')}, {drive.get('id')}"
        )
        permission = (
            service.permissions()
            .create(
                fileId=drive.get("id"),
                body=new_organizer_permission,
                useDomainAdminAccess=True,
                supportsAllDrives=True,
                fields="id",
            )
            .execute()
        )
        print(f'Added organizer permission: {permission.get("id")}')

      drives.extend(response.get("drives", []))
      page_token = response.get("nextPageToken", None)
      if page_token is None:
        break

  except HttpError as error:
    print(f"An error occurred: {error}")

  return drives


if __name__ == "__main__":
  recover_drives(real_user="gduser1@workspacesamples.dev")

Node.js

drive/snippets/drive_v3/drive_snippets/recover_drives.js
/**
 * Find all shared drives without an organizer and add one.
 * @param{string} userEmail user ID to assign ownership to
 * */
async function recoverDrives(userEmail) {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});
  const drives = [];
  const newOrganizerPermission = {
    type: 'user',
    role: 'organizer',
    emailAddress: userEmail, // Example: 'user@example.com'
  };

  let pageToken = null;
  try {
    const res = await service.drives.list({
      q: 'organizerCount = 0',
      fields: 'nextPageToken, drives(id, name)',
      useDomainAdminAccess: true,
      pageToken: pageToken,
    });
    Array.prototype.push.apply(drives, res.data.items);
    for (const drive of res.data.drives) {
      console.log(
          'Found shared drive without organizer:',
          drive.name,
          drive.id,
      );
      await service.permissions.create({
        resource: newOrganizerPermission,
        fileId: drive.id,
        useDomainAdminAccess: true,
        supportsAllDrives: true,
        fields: 'id',
      });
    }
    pageToken = res.nextPageToken;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
  return drives;
}

PHP

drive/snippets/drive_v3/src/DriveRecoverDrives.php
<?php
use Google\Client;
use Google\Service\Drive;
use Ramsey\Uuid\Uuid;
function recoverDrives()
{
   try {
    $client = new Client();
    $client->useApplicationDefaultCredentials();
    $client->addScope(Drive::DRIVE);
    $driveService = new Drive($client);

    $realUser = readline("Enter user email address: ");

    $drives = array();
    // Find all shared drives without an organizer and add one.
    // Note: This example does not capture all cases. Shared drives
    // that have an empty group as the sole organizer, or an
    // organizer outside the organization are not captured. A
    // more exhaustive approach would evaluate each shared drive
    // and the associated permissions and groups to ensure an active
    // organizer is assigned.
    $pageToken = null;
    $newOrganizerPermission = new Drive\Permission(array(
        'type' => 'user',
        'role' => 'organizer',
        'emailAddress' => 'user@example.com'
    ));
    $newOrganizerPermission['emailAddress'] = $realUser;
    do {
        $response = $driveService->drives->listDrives(array(
            'q' => 'organizerCount = 0',
            'fields' => 'nextPageToken, drives(id, name)',
            'useDomainAdminAccess' => true,
            'pageToken' => $pageToken
        ));
        foreach ($response->drives as $drive) {
            printf("Found shared drive without organizer: %s (%s)\n",
                $drive->name, $drive->id);
            $permission = $driveService->permissions->create($drive->id,
                $newOrganizerPermission,
                array(
                    'fields' => 'id',
                    'useDomainAdminAccess' => true,
                    'supportsAllDrives' => true
                ));
            printf("Added organizer permission: %s\n", $permission->id);
        }
        array_push($drives, $response->drives);
        $pageToken = $response->pageToken;
    } while ($pageToken != null);
    return $drives;
   } catch(Exception $e) {
      echo "Error Message: ".$e;
   }
}

NET.

drive/snippets/drive_v3/DriveV3Snippets/RecoverDrives.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Drive.v3.Data;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use-case of Drive's shared drive without an organizer.
    public class RecoverDrives
    {
        /// <summary>
        /// Find all shared drives without an organizer and add one.
        /// </summary>
        /// <param name="realUser">User ID for the new organizer.</param>
        /// <returns>all shared drives without an organizer.</returns>
        public static IList<Drive> DriveRecoverDrives(string realUser)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var drives = new List<Drive>();
                // Find all shared drives without an organizer and add one.
                // Note: This example does not capture all cases. Shared drives
                // that have an empty group as the sole organizer, or an
                // organizer outside the organization are not captured. A
                // more exhaustive approach would evaluate each shared drive
                // and the associated permissions and groups to ensure an active
                // organizer is assigned.
                string pageToken = null;
                var newOrganizerPermission = new Permission()
                {
                    Type = "user",
                    Role = "organizer",
                    EmailAddress = realUser
                };

                do
                {
                    var request = service.Drives.List();
                    request.UseDomainAdminAccess = true;
                    request.Q = "organizerCount = 0";
                    request.Fields = "nextPageToken, drives(id, name)";
                    request.PageToken = pageToken;
                    var result = request.Execute();
                    foreach (var drive in result.Drives)
                    {
                        Console.WriteLine(("Found abandoned shared drive: {0} ({1})",
                            drive.Name, drive.Id));
                        // Note: For improved efficiency, consider batching
                        // permission insert requests
                        var permissionRequest = service.Permissions.Create(
                            newOrganizerPermission,
                            drive.Id
                        );
                        permissionRequest.UseDomainAdminAccess = true;
                        permissionRequest.SupportsAllDrives = true;
                        permissionRequest.Fields = "id";
                        var permissionResult = permissionRequest.Execute();
                        Console.WriteLine("Added organizer permission: {0}", permissionResult.Id);
                    }

                    pageToken = result.NextPageToken;
                } while (pageToken != null);

                return drives;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

منع المستخدمين من تنزيل ملفك أو طباعته أو نسخه

يمكنك فرض قيود على طريقة تنزيل المستخدمين للملفات وطباعتها ونسخها داخل مساحات التخزين السحابي المشتركة.

لتحديد ما إذا كان بإمكان المستخدم تغيير قيود التنزيل التي فرضها المنظّم على مساحة تخزين سحابي مشتركة، تحقّق من الحقل المنطقي capabilities.canChangeDownloadRestriction. إذا تم ضبط capabilities.canChangeDownloadRestriction على true، يمكن تطبيق قيود التنزيل على مساحة التخزين السحابي المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على إمكانات الملفات.

يحتوي مرجع drives على مجموعة من حقول restrictions المنطقية المستخدَمة لتحديد ما إذا كان يمكن تنفيذ إجراء في مساحة تخزين سحابي مشتركة. تنطبق القيود على مساحة تخزين سحابي مشتركة أو العناصر داخل مساحة تخزين سحابي مشتركة. يمكن ضبط القيود باستخدام الطريقة drives.update.

لتطبيق قيود التنزيل على مساحة تخزين سحابي مشتركة، يمكن لمدير مساحة التخزين السحابي المشتركة ضبط حقل restrictions.downloadRestriction الخاص بمورد drives باستخدام عنصر DownloadRestriction. يؤدي ضبط الحقل المنطقي restrictedForReaders على true إلى الإشارة إلى أنّ التنزيل والنسخ محظوران على القرّاء. يؤدي ضبط الحقل restrictedForWritersمن النوع المنطقي على true إلى الإشارة إلى أنّ ميزتَي التنزيل والنسخ محظورتان على الكتّاب. يُرجى العِلم أنّه إذا كان الحقل restrictedForWriters هو true، سيتم أيضًا حظر التنزيل والنسخ على القرّاء. وبالمثل، فإنّ ضبط restrictedForWriters على true وrestrictedForReaders على false يعادل ضبط كل من restrictedForWriters وrestrictedForReaders على true.

التوافق مع الإصدارات السابقة

مع طرح العنصر DownloadRestriction، تم تعديل وظيفة الحقل المنطقي restrictions.copyRequiresWriterPermission.

الآن، يؤدي ضبط restrictions.copyRequiresWriterPermission على true إلى تعديل الحقل المنطقي restrictedForReaders الخاص بالكائن DownloadRestriction إلى true للإشارة إلى أنّ القراءة مقيّدة لكل من التنزيل والنسخ.

يؤدي ضبط الحقل copyRequiresWriterPermission على false إلى تعديل الحقلين restrictedForWriters وrestrictedForReaders إلى false. وهذا يعني أنّه ستتم إزالة إعدادات حظر التنزيل أو النسخ لجميع المستخدمين.

الحقول التي تتحكّم في ميزات التنزيل والطباعة والنسخ

يسرد الجدول التالي حقول موارد drives التي تؤثر في وظائف التنزيل والطباعة والنسخ:

الحقل الوصف الإصدار
capabilities.canCopy تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نسخ الملفات في مساحة تخزين سحابي مشتركة. الإصداران 2 و3
capabilities.canDownload تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تنزيل الملفات في مساحة تخزين سحابي مشتركة. الإصداران 2 و3
capabilities.canChangeCopyRequiresWriterPermission تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تغيير القيود المفروضة على copyRequiresWriterPermission في مساحة تخزين سحابي مشتركة. الإصداران 2 و3
capabilities.canResetDriveRestrictions تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إعادة ضبط قيود مساحة التخزين السحابي المشتركة على الإعدادات التلقائية. الإصداران 2 و3
capabilities.canChangeDownloadRestriction تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تغيير قيود التنزيل في مساحة تخزين سحابي مشتركة. الإصدار 3 فقط
restrictions.copyRequiresWriterPermission تحديد ما إذا كانت خيارات نسخ الملفات أو طباعتها أو تنزيلها داخل مساحة تخزين سحابي مشتركة غير متاحة للقراء والمعلِّقين عندما تكون القيمة true، يتم ضبط الحقل الذي يحمل الاسم نفسه على true لأي ملف داخل مساحة التخزين السحابي المشتركة هذه. الإصداران 2 و3
restrictions.downloadRestriction قيود التنزيل التي يفرضها مديرو مساحة التخزين السحابي المشتركة الإصدار 3 فقط

حدود المجلدات

تخضع مجلدات مساحة التخزين السحابي المشتركة لبعض القيود المتعلقة بمساحة التخزين. للحصول على معلومات، يُرجى الاطّلاع على مقالة حدود مساحة التخزين السحابي المشتركة في Google Drive.

الحد الأقصى لعدد العناصر

يبلغ الحد الأقصى لعدد العناصر في مساحة التخزين السحابي المشتركة لكل مستخدم 500,000 عنصر، بما في ذلك الملفات والمجلدات والاختصارات.

عند بلوغ الحدّ الأقصى، لن تتمكّن مساحة التخزين السحابي المشتركة من قبول العناصر. لاستئناف تلقّي الملفات، على المستخدمين حذف العناصر نهائيًا من مساحة التخزين السحابي المشتركة. يُرجى العِلم أنّ العناصر في المهملات تُحتسب ضمن الحدّ الأقصى، ولكن لا تُحتسب العناصر المحذوفة نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على نقل الملفات والمجلدات إلى المهملات أو حذفها.

الحدّ الأقصى لعمق المجلد

لا يمكن أن يحتوي مجلد في مساحة تخزين سحابي مشتركة على أكثر من 100 مستوى من المجلدات المُدمجة. وهذا يعني أنّه لا يمكن تخزين مجلد فرعي ضمن مجلد يتضمّن أكثر من 99 مستوى. لا ينطبق هذا الحدّ إلا على المجلدات الفرعية.

تؤدي محاولات إضافة أكثر من 100 مستوى من المجلدات إلى عرض رمز حالة HTTP ‏teamDriveHierarchyTooDeep.