파일, 폴더, 드라이브 공유하기

모든 Google Drive 파일, 폴더, 공유 드라이브에는 연결된 permissions 리소스가 있습니다. 각 리소스는 특정 type (user, group, domain, anyone) 및 role (owner, organizer, fileOrganizer, writer, commenter, reader)에 대한 권한을 식별합니다. 예를 들어 파일에는 특정 사용자 (type=user)에게 읽기 전용 액세스 권한 (role=reader)을 부여하는 권한이 있을 수 있으며, 다른 권한은 특정 그룹 (type=group)의 구성원에게 파일에 댓글을 추가할 수 있는 기능 (role=commenter)을 부여할 수 있습니다.

역할 및 각 역할에서 허용되는 작업의 전체 목록은 역할 및 권한을 참고하세요.

참고: 파일, 폴더 또는 공유 드라이브와 연결된 모든 권한 리소스 목록을 액세스 제어 목록 (ACL)이라고 합니다.

권한 작동 방식

폴더의 권한 목록은 아래로 전파됩니다. 모든 하위 파일과 폴더는 상위 폴더의 권한을 상속합니다. 권한이나 계층 구조가 변경될 때마다 모든 중첩 폴더를 통해 재귀적으로 전파가 발생합니다. 예를 들어 폴더에 파일이 있고 해당 폴더가 다른 폴더 내로 이동되면 새 폴더의 권한이 파일에 전파됩니다. 새 폴더에서 파일 사용자에게 '작성자'와 같은 새 역할을 부여하면 이전 역할이 재정의됩니다.

반대로 파일이 폴더에서 role=writer를 상속받고 '읽기 권한 사용자' 역할을 제공하는 다른 폴더로 이동하면 이제 파일이 role=reader를 상속받습니다.

공유 드라이브의 파일 또는 폴더에서 상속된 권한을 삭제할 수 없습니다. 대신 이러한 권한은 상속된 직접 또는 간접 상위 항목에서 조정해야 합니다. '내 드라이브' 또는 '공유 문서함'에 있는 항목에서 상속된 권한을 삭제할 수 있습니다.

반대로 내 드라이브의 파일 또는 폴더에서는 상속된 권한을 재정의할 수 있습니다. 따라서 파일이 내 드라이브 폴더에서 role=writer를 상속하는 경우 파일에 role=reader를 설정하여 권한 수준을 낮출 수 있습니다.

동일한 파일에 대한 동시 권한 작업은 지원되지 않습니다. 마지막 업데이트만 적용됩니다.

경고: '내 드라이브' 및 '나와 공유됨'에서 다른 사용자가 하위 파일 또는 폴더를 소유하고 파일 또는 폴더에 전파를 재정의하는 더 제한적인 권한이 있는 경우 전파가 중지될 수 있습니다. 예를 들어 상위 폴더에는 type=group 및 role=commenter이 있지만 하위 폴더에는 type=group (이메일 동일) 및 role=reader이 있습니다. reader가 commenter보다 더 제한적이므로 하위 폴더의 권한이 상위 폴더의 전파를 재정의합니다.

파일 기능 이해하기

permissions 리소스는 궁극적으로 현재 사용자가 파일 또는 폴더에서 작업을 수행할 수 있는 능력을 결정하지 않습니다. 대신 files 리소스에는 파일 또는 폴더에서 작업을 실행할 수 있는지 여부를 나타내는 데 사용되는 불리언 capabilities 필드 모음이 포함되어 있습니다. Google Drive API는 파일 또는 폴더와 연결된 현재 사용자의 permissions 리소스를 기반으로 이러한 필드를 설정합니다.

예를 들어 Alex가 앱에 로그인하여 파일을 공유하려고 하면 파일에 대한 권한이 있는지 Alex의 역할이 확인됩니다. 역할에서 파일 공유를 허용하는 경우 파일과 관련된 capabilities(예: canShare)는 역할을 기준으로 설정됩니다. Alex가 파일을 공유하려고 하면 앱에서 capabilities를 확인하여 canShare이 true로 설정되어 있는지 확인합니다.

파일 기능 가져오기

앱이 파일을 열면 파일의 기능을 확인하고 현재 사용자의 권한을 반영하도록 UI를 렌더링해야 합니다. 예를 들어 사용자에게 파일에 대한 canComment 기능이 없는 경우 UI에서 댓글 기능이 사용 중지되어야 합니다.

기능을 확인하려면 fileId 경로 매개변수와 fields 매개변수를 capabilities 필드로 설정하여 files 리소스에서 get 메서드를 호출합니다. fields 매개변수를 사용하여 필드를 반환하는 방법에 관한 자세한 내용은 특정 필드 반환을 참고하세요.

다음 코드 샘플은 사용자 권한을 확인하는 방법을 보여줍니다. 응답은 사용자가 파일에 대해 갖는 기능 목록을 반환합니다. 각 기능은 사용자가 취할 수 있는 세부 작업에 해당합니다. 일부 필드는 공유 드라이브의 항목에 대해서만 채워집니다.

요청

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=capabilities

응답

{
  "capabilities": {
    "canAcceptOwnership": false,
    "canAddChildren": false,
    "canAddMyDriveParent": false,
    "canChangeCopyRequiresWriterPermission": true,
    "canChangeItemDownloadRestriction": true,
    "canChangeSecurityUpdateEnabled": false,
    "canChangeViewersCanCopyContent": true,
    "canComment": true,
    "canCopy": true,
    "canDelete": true,
    "canDisableInheritedPermissions": false,
    "canDownload": true,
    "canEdit": true,
    "canEnableInheritedPermissions": true,
    "canListChildren": false,
    "canModifyContent": true,
    "canModifyContentRestriction": true,
    "canModifyEditorContentRestriction": true,
    "canModifyOwnerContentRestriction": true,
    "canModifyLabels": true,
    "canMoveChildrenWithinDrive": false,
    "canMoveItemIntoTeamDrive": true,
    "canMoveItemOutOfDrive": true,
    "canMoveItemWithinDrive": true,
    "canReadLabels": true,
    "canReadRevisions": true,
    "canRemoveChildren": false,
    "canRemoveContentRestriction": false,
    "canRemoveMyDriveParent": true,
    "canRename": true,
    "canShare": true,
    "canTrash": true,
    "canUntrash": true
  }
}

Drive 리소스 공유 시나리오

공유 시나리오에는 5가지 유형이 있습니다.

1. 내 드라이브에서 파일을 공유하려면 사용자에게 role=writer 또는 role=owner 권한이 있어야 합니다.

   • writersCanShare 불리언 값이 파일에 대해 false로 설정된 경우 사용자에게 role=owner이 있어야 합니다.

   • role=writer 권한이 있는 사용자에게 만료일 및 시간에 따라 관리되는 임시 액세스 권한이 있는 경우 파일을 공유할 수 없습니다. 자세한 내용은 파일 액세스 권한을 제한하는 만료일 설정하기를 참고하세요.

2. 내 드라이브에서 폴더를 공유하려면 사용자에게 role=writer 또는 role=owner 권한이 있어야 합니다.

   • 파일의 writersCanShare 불리언 값이 false로 설정된 경우 사용자에게 더 허용적인 role=owner이 있어야 합니다.

   • role=writer이 있는 내 드라이브 폴더에서는 만료일과 만료 시간으로 관리되는 임시 액세스가 허용되지 않습니다. 자세한 내용은 파일 액세스를 제한하는 만료일 설정하기를 참고하세요.

3. 공유 드라이브의 파일을 공유하려면 사용자에게 role=writer, role=fileOrganizer 또는 role=organizer 권한이 있어야 합니다.

   • writersCanShare 설정은 공유 드라이브의 항목에는 적용되지 않습니다. 항상 true로 설정된 것처럼 처리됩니다.

4. 공유 드라이브에서 폴더를 공유하려면 사용자에게 role=organizer 권한이 있어야 합니다.

   • 공유 드라이브의 sharingFoldersRequiresOrganizerPermission 제한이 false로 설정된 경우 role=fileOrganizer 권한이 있는 사용자는 해당 공유 드라이브의 폴더를 공유할 수 있습니다.

5. 공유 드라이브 멤버십을 관리하려면 사용자에게 role=organizer 권한이 있어야 합니다. 사용자와 그룹만 공유 드라이브의 구성원이 될 수 있습니다.

fields 매개변수 사용

응답에서 반환할 필드를 지정하려면 permissions 리소스의 메서드를 사용하여 fields 시스템 매개변수를 설정하면 됩니다. fields 매개변수를 생략하면 서버는 메서드에 특정한 기본 필드 집합을 반환합니다. 예를 들어 list 메서드는 각 파일에 대해 id, type, kind, role 필드만 반환합니다. 다른 필드를 반환하려면 특정 필드 반환을 참고하세요.

권한 만들기

권한을 만들 때는 다음 두 필드가 필요합니다.

• type: type은 권한 범위 (user, group, domain 또는 anyone)를 식별합니다. type=user이 있는 권한은 특정 사용자에게 적용되는 반면 type=domain이 있는 권한은 특정 도메인의 모든 사용자에게 적용됩니다.

• role: role 필드는 type가 실행할 수 있는 작업을 식별합니다. 예를 들어 type=user 및 role=reader 권한이 있으면 특정 사용자에게 파일 또는 폴더에 대한 읽기 전용 액세스 권한이 부여됩니다. 또는 type=domain 및 role=commenter 권한을 사용하면 도메인의 모든 사용자가 파일에 댓글을 추가할 수 있습니다. 역할 및 각 역할에서 허용되는 작업의 전체 목록은 역할 및 권한을 참고하세요.

type=user 또는 type=group인 권한을 만들 때는 특정 사용자 또는 그룹을 권한에 연결하는 emailAddress도 제공해야 합니다.

type=domain인 권한을 만들 때는 특정 도메인을 권한에 연결하는 domain도 제공해야 합니다.

권한을 만들려면 다음 단계를 따르세요.

1. 연결된 파일 또는 폴더의 fileId 경로 매개변수와 함께 permissions 리소스에서 create 메서드를 사용합니다.
2. 요청 본문에서 type 및 role을 지정합니다.
3. type=user 또는 type=group인 경우 emailAddress를 제공합니다. type=domain인 경우 domain를 제공합니다.

다음 코드 샘플은 권한을 만드는 방법을 보여줍니다. 응답은 할당된 permissionId을 포함하여 permissions 리소스의 인스턴스를 반환합니다.

요청

POST https://www.googleapis.com/drive/v3/files/FILE_ID/permissions

{
  "requests": [
    {
        "type": "user",
        "role": "commenter",
        "emailAddress": "[e-mail]"
    }
  ]
}

응답

{
    "kind": "drive#permission",
    "id": "PERMISSION_ID",
    "type": "user",
    "role": "commenter"
}

공유 대상 그룹 사용

공유 대상 그룹은 사용자에게 항목을 공유하도록 권장할 수 있는 부서나 팀 등의 사용자 그룹입니다. 사용자가 전체 조직이 아닌 특정 대상 또는 제한된 대상과 항목을 공유하도록 할 수 있습니다. 공유 대상 그룹을 사용하면 데이터의 보안 및 개인 정보 보호를 개선하고 사용자가 적절하게 공유할 수 있습니다. 자세한 내용은 타겟 고객 정보를 참고하세요.

공유 대상 그룹을 사용하려면 다음 단계를 따르세요.

1. Google 관리 콘솔에서 메뉴 > 디렉터리 > 공유 대상 그룹으로 이동합니다.

   공유 대상 그룹으로 이동

   이 작업을 수행하려면 최고 관리자 권한이 있는 계정으로 로그인해야 합니다.

2. 공유 대상 그룹 목록에서 공유 대상 그룹의 이름을 클릭합니다. 공유 대상 그룹을 만들려면 공유 대상 그룹 만들기를 참고하세요.

3. 공유 대상 그룹 URL(https://admin.google.com/ac/targetaudiences/ID)에서 고유 ID를 복사합니다.

4. type=domain로 권한을 만들고 domain 필드를 ID.audience.googledomains.com로 설정합니다.

사용자가 타겟 잠재고객과 상호작용하는 방식을 확인하려면 링크 공유 사용자 환경을 참고하세요.

권한 가져오기

권한을 가져오려면 fileId 및 permissionId 경로 매개변수와 함께 permissions 리소스에서 get 메서드를 사용합니다. 권한 ID를 모르는 경우 list 메서드를 사용하여 모든 권한을 나열할 수 있습니다.

다음 코드 샘플은 ID로 권한을 가져오는 방법을 보여줍니다. 응답은 permissions 리소스의 인스턴스를 반환합니다.

요청

GET https://www.googleapis.com/drive/v3/files/FILE_ID/permissionsPERMISSION_ID

응답

{
  "kind": "drive#permissionList",
  "permissions": [
    {
      "kind": "drive#permission",
      "id": "PERMISSION_ID",
      "type": "user",
      "role": "commenter"
    }
  ]
}

모든 권한 나열

파일, 폴더 또는 공유 드라이브의 권한을 나열하려면 fileId 경로 매개변수와 함께 permissions 리소스에서 list 메서드를 사용합니다.

다음 쿼리 매개변수를 전달하여 권한의 페이지로 나누기를 맞춤설정하거나 권한을 필터링합니다.

• pageSize: 페이지당 반환할 최대 권한 수입니다. 공유 드라이브의 파일에 대해 설정되지 않은 경우 최대 100개의 결과가 반환됩니다. 공유 드라이브에 없는 파일에 대해 설정되지 않은 경우 전체 목록이 반환됩니다.

• pageToken: 이전 목록 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 가져오려면 이 토큰을 제공하세요.

• supportsAllDrives: 요청하는 앱이 내 드라이브와 공유 드라이브를 모두 지원하는지 여부입니다.

• useDomainAdminAccess: 도메인 관리자로 요청을 실행하려면 true로 설정합니다. fileId 매개변수가 공유 드라이브를 참조하고 요청자가 공유 드라이브가 속한 도메인의 관리자인 경우 자세한 내용은 도메인 관리자로 공유 드라이브 관리하기를 참고하세요.

• includePermissionsForView: 응답에 포함할 추가 뷰의 권한입니다. published만 지원됩니다.

다음 코드 샘플은 모든 권한을 가져오는 방법을 보여줍니다. 이 응답은 파일, 폴더 또는 공유 드라이브의 권한 목록을 반환합니다.

요청

GET https://www.googleapis.com/drive/v3/files/FILE_ID/permissions

응답

{
  "kind": "drive#permissionList",
  "permissions": [
    {
      "id": "PERMISSION_ID",
      "type": "user",
      "kind": "drive#permission",
      "role": "commenter"
    }
  ]
}

권한 업데이트

파일 또는 폴더의 권한을 업데이트하려면 할당된 역할을 변경하면 됩니다. 역할 소스를 찾는 방법에 대한 자세한 내용은 역할 소스 확인을 참고하세요.

1. fileId 경로 매개변수가 연결된 파일, 폴더 또는 공유 드라이브로 설정되고 permissionId 경로 매개변수가 변경할 권한으로 설정된 permissions 리소스에서 update 메서드를 호출합니다. permissionId를 찾으려면 fileId 경로 매개변수를 사용하여 permissions 리소스에서 list 메서드를 사용합니다.

   참고: permissionId는 [e-mail] 또는 [e-mail]와 같이 권한이 부여된 사용자 또는 그룹을 나타냅니다. permissionId는 모든 파일, 폴더, 공유 드라이브에서 해당 사용자 또는 그룹에 대해 동일하게 유지됩니다.

2. 요청에서 새 role를 식별합니다.

사용자 또는 그룹이 이미 멤버인 경우에도 공유 드라이브의 개별 파일 또는 폴더에 대한 권한을 부여할 수 있습니다. 예를 들어 Alex는 공유 드라이브의 멤버십에 role=commenter가 포함되어 있습니다. 하지만 앱은 공유 드라이브의 파일에 대해 Alex에게 role=writer를 부여할 수 있습니다. 이 경우 새 역할이 멤버십을 통해 부여된 역할보다 더 허용적이므로 새 권한이 파일 또는 폴더의 유효한 역할이 됩니다.

패치 시맨틱을 통해 업데이트를 적용할 수 있습니다. 즉, 리소스를 부분적으로 수정할 수 있습니다. 요청에서 수정할 필드를 명시적으로 설정해야 합니다. 요청에 포함되지 않은 필드는 기존 값을 유지합니다. 자세한 내용은 부분 리소스 작업을 참고하세요.

다음 코드 샘플은 파일 또는 폴더의 권한을 commenter에서 writer로 변경하는 방법을 보여줍니다. 응답은 permissions 리소스의 인스턴스를 반환합니다.

요청

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID/permissions/PERMISSION_ID

{
  "requests": [
    {
        "role": "writer"
    }
  ]
}

응답

{
  "kind": "drive#permission",
  "id": "PERMISSION_ID",
  "type": "user",
  "role": "writer"
}

역할 소스 확인

파일 또는 폴더의 역할을 변경하려면 역할의 소스를 알아야 합니다. 공유 드라이브의 경우 역할의 소스는 공유 드라이브의 멤버십, 폴더의 역할 또는 파일의 역할을 기반으로 할 수 있습니다.

공유 드라이브 또는 드라이브 내 항목의 역할 소스를 확인하려면 fileId 및 permissionId 경로 매개변수와 fields 매개변수가 permissionDetails 필드로 설정된 permissions 리소스에서 get 메서드를 호출합니다.

permissionId를 찾으려면 fileId 경로 매개변수를 사용하여 permissions 리소스에서 list 메서드를 사용합니다. list 요청에서 permissionDetails 필드를 가져오려면 fields 매개변수를 permissions/permissionDetails로 설정합니다.

이 필드는 사용자, 그룹 또는 도메인의 모든 상속된 파일 권한과 직접 파일 권한을 열거합니다.

다음 코드 샘플은 역할 소스를 확인하는 방법을 보여줍니다. 응답은 permissions 리소스의 permissionDetails를 반환합니다. inheritedFrom 필드는 권한이 상속된 항목의 ID를 제공합니다.

요청

GET https://www.googleapis.com/drive/v3/files/FILE_ID/permissions/PERMISSION_ID?fields=permissionDetails&supportsAllDrives=true

응답

{
  "permissionDetails": [
    {
      "permissionType": "member",
      "role": "commenter",
      "inheritedFrom": "INHERITED_FROM_ID",
      "inherited": true
    },
    {
      "permissionType": "file",
      "role": "writer",
      "inherited": false
    }
  ]
}

일괄 요청으로 여러 권한 업데이트

일괄 요청을 사용하여 여러 권한을 수정하는 것이 좋습니다.

다음은 클라이언트 라이브러리를 사용하여 일괄 권한 수정을 실행하는 예입니다.

참고: 이전 Drive API v2를 사용하는 경우 GitHub에서 코드 샘플을 확인할 수 있습니다. Drive API v3로 이전하는 방법을 알아보세요.

자바

drive/snippets/drive_v3/src/main/java/ShareFile.java

GitHub에서 보기

import com.google.api.client.googleapis.batch.BatchRequest;
import com.google.api.client.googleapis.batch.json.JsonBatchCallback;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpHeaders;
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.Drive;
import com.google.api.services.drive.DriveScopes;
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 modify permissions. */
public class ShareFile {

  /**
   * Batch permission modification.
   * realFileId file Id.
   * realUser User Id.
   * realDomain Domain of the user ID.
   *
   * @return list of modified permissions if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static List<String> shareFile(String realFileId, String realUser, String realDomain)
      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.application*/
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

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

    final List<String> ids = new ArrayList<String>();


    JsonBatchCallback<Permission> callback = new JsonBatchCallback<Permission>() {
      @Override
      public void onFailure(GoogleJsonError e,
                            HttpHeaders responseHeaders)
          throws IOException {
        // Handle error
        System.err.println(e.getMessage());
      }

      @Override
      public void onSuccess(Permission permission,
                            HttpHeaders responseHeaders)
          throws IOException {
        System.out.println("Permission ID: " + permission.getId());

        ids.add(permission.getId());

      }
    };
    BatchRequest batch = service.batch();
    Permission userPermission = new Permission()
        .setType("user")
        .setRole("writer");

    userPermission.setEmailAddress(realUser);
    try {
      service.permissions().create(realFileId, userPermission)
          .setFields("id")
          .queue(batch, callback);

      Permission domainPermission = new Permission()
          .setType("domain")
          .setRole("reader");

      domainPermission.setDomain(realDomain);

      service.permissions().create(realFileId, domainPermission)
          .setFields("id")
          .queue(batch, callback);

      batch.execute();

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

Python

drive/snippets/drive-v3/file_snippet/share_file.py

GitHub에서 보기

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


def share_file(real_file_id, real_user, real_domain):
  """Batch permission modification.
  Args:
      real_file_id: file Id
      real_user: User ID
      real_domain: Domain of the user ID
  Prints modified permissions

  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)
    ids = []
    file_id = real_file_id

    def callback(request_id, response, exception):
      if exception:
        # Handle error
        print(exception)
      else:
        print(f"Request_Id: {request_id}")
        print(f'Permission Id: {response.get("id")}')
        ids.append(response.get("id"))

    # pylint: disable=maybe-no-member
    batch = service.new_batch_http_request(callback=callback)
    user_permission = {
        "type": "user",
        "role": "writer",
        "emailAddress": "[e-mail]",
    }
    batch.add(
        service.permissions().create(
            fileId=file_id,
            body=user_permission,
            fields="id",
        )
    )
    domain_permission = {
        "type": "domain",
        "role": "reader",
        "domain": "example.com",
    }
    domain_permission["domain"] = real_domain
    batch.add(
        service.permissions().create(
            fileId=file_id,
            body=domain_permission,
            fields="id",
        )
    )
    batch.execute()

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

  return ids


if __name__ == "__main__":
  share_file(
      real_file_id="1dUiRSoAQKkM3a4nTPeNQWgiuau1KdQ_l",
      real_user="[e-mail]",
      real_domain="workspacesamples.dev",
  )

Node.js

drive/snippets/drive_v3/file_snippets/share_file.js

GitHub에서 보기

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Shares a file with a user and a domain.
 * @param {string} fileId The ID of the file to share.
 * @param {string} targetUserEmail The email address of the user to share with.
 * @param {string} targetDomainName The domain to share with.
 * @return {Promise<Array<string>>} A promise that resolves to an array of permission IDs.
 */
async function shareFile(fileId, targetUserEmail, targetDomainName) {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  /** @type {Array<string>} */
  const permissionIds = [];

  // The permissions to create.
  const permissions = [
    {
      type: 'user',
      role: 'writer',
      emailAddress: targetUserEmail, // e.g., '[e-mail]'
    },
    {
      type: 'domain',
      role: 'writer',
      domain: targetDomainName, // e.g., 'example.com'
    },
  ];

  // Iterate through the permissions and create them one by one.
  for (const permission of permissions) {
    const result = await service.permissions.create({
      requestBody: permission,
      fileId,
      fields: 'id',
    });

    if (result.data.id) {
      permissionIds.push(result.data.id);
      console.log(`Inserted permission id: ${result.data.id}`);
    } else {
      throw new Error('Failed to create permission');
    }
  }
  return permissionIds;
}

PHP

drive/snippets/drive_v3/src/DriveShareFile.php

GitHub에서 보기

<?php
use Google\Client;
use Google\Service\Drive;
function shareFile()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $realFileId = readline("Enter File Id: ");
        $realUser = readline("Enter user email address: ");
        $realDomain = readline("Enter domain name: ");
        $ids = array();
            $fileId = '1sTWaJ_j7PkjzaBWtNc3IzovK5hQf21FbOw9yLeeLPNQ';
            $fileId = $realFileId;
            $driveService->getClient()->setUseBatch(true);
            try {
                $batch = $driveService->createBatch();

                $userPermission = new Drive\Permission(array(
                    'type' => 'user',
                    'role' => 'writer',
                    'emailAddress' => '[e-mail]'
                ));
                $userPermission['emailAddress'] = $realUser;
                $request = $driveService->permissions->create(
                    $fileId, $userPermission, array('fields' => 'id'));
                $batch->add($request, 'user');
                $domainPermission = new Drive\Permission(array(
                    'type' => 'domain',
                    'role' => 'reader',
                    'domain' => 'example.com'
                ));
                $userPermission['domain'] = $realDomain;
                $request = $driveService->permissions->create(
                    $fileId, $domainPermission, array('fields' => 'id'));
                $batch->add($request, 'domain');
                $results = $batch->execute();

                foreach ($results as $result) {
                    if ($result instanceof Google_Service_Exception) {
                        // Handle error
                        printf($result);
                    } else {
                        printf("Permission ID: %s\n", $result->id);
                        array_push($ids, $result->id);
                    }
                }
            } finally {
                $driveService->getClient()->setUseBatch(false);
            }
            return $ids;
    } catch(Exception $e) {
        echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/ShareFile.cs

GitHub에서 보기

using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Drive.v3.Data;
using Google.Apis.Requests;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use-case of Drive modify permissions.
    public class ShareFile
    {
        /// <summary>
        /// Batch permission modification.
        /// </summary>
        /// <param name="realFileId">File id.</param>
        /// <param name="realUser">User id.</param>
        /// <param name="realDomain">Domain id.</param>
        /// <returns>list of modified permissions, null otherwise.</returns>
        public static IList<String> DriveShareFile(string realFileId, string realUser, string realDomain)
        {
            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 ids = new List<String>();
                var batch = new BatchRequest(service);
                BatchRequest.OnResponse<Permission> callback = delegate(
                    Permission permission,
                    RequestError error,
                    int index,
                    HttpResponseMessage message)
                {
                    if (error != null)
                    {
                        // Handle error
                        Console.WriteLine(error.Message);
                    }
                    else
                    {
                        Console.WriteLine("Permission ID: " + permission.Id);
                    }
                };
                Permission userPermission = new Permission()
                {
                    Type = "user",
                    Role = "writer",
                    EmailAddress = realUser
                };

                var request = service.Permissions.Create(userPermission, realFileId);
                request.Fields = "id";
                batch.Queue(request, callback);

                Permission domainPermission = new Permission()
                {
                    Type = "domain",
                    Role = "reader",
                    Domain = realDomain
                };
                request = service.Permissions.Create(domainPermission, realFileId);
                request.Fields = "id";
                batch.Queue(request, callback);
                var task = batch.ExecuteAsync();
                task.Wait();
                return ids;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

권한 삭제

파일 또는 폴더에 대한 액세스 권한을 취소하려면 fileId 및 permissionId 경로 매개변수가 권한 삭제로 설정된 permissions 리소스에서 delete 메서드를 호출합니다.

'내 드라이브'의 항목의 경우 상속된 권한을 삭제할 수 있습니다. 상속된 권한을 삭제하면 항목 및 하위 항목(있는 경우)에 대한 액세스 권한이 취소됩니다.

공유 드라이브에 있는 항목의 경우 상속된 권한을 취소할 수 없습니다. 대신 상위 파일 또는 폴더의 권한을 업데이트하거나 삭제하세요.

delete 메서드는 공유 드라이브 파일 또는 폴더에 직접 적용된 권한을 삭제하는 데도 사용됩니다.

다음 코드 샘플은 permissionId를 삭제하여 액세스 권한을 취소하는 방법을 보여줍니다. 성공하면 응답 본문은 빈 JSON 객체입니다. 권한이 삭제되었는지 확인하려면 fileId 경로 매개변수를 사용하여 permissions 리소스에서 list 메서드를 사용합니다.

요청

DELETE https://www.googleapis.com/drive/v3/files/FILE_ID/permissions/PERMISSION_ID

만료일을 설정하여 파일 액세스 제한하기

민감한 프로젝트에서 사용자와 공동작업하는 경우 일정 시간이 지난 후 Drive의 특정 파일에 대한 액세스 권한을 제한해야 할 수 있습니다. 내 드라이브 파일에 대해 파일 액세스 권한의 만료일을 설정하여 액세스 권한을 제한 또는 삭제할 수 있습니다.

만료일을 설정하려면 다음 단계를 따르세요.

• permissions 리소스에서 create 메서드를 사용하고 expirationTime 필드 (및 기타 필수 필드)를 설정합니다. 자세한 내용은 권한 만들기를 참고하세요.

• permissions 리소스에서 update 메서드를 사용하고 expirationTime 필드 (및 기타 필수 필드)를 설정합니다. 자세한 내용은 권한 업데이트를 참고하세요.

expirationTime 필드는 RFC 3339 날짜-시간을 사용하여 권한이 만료되는 시점을 나타냅니다. 만료 시간에는 다음과 같은 제한사항이 있습니다.

• 사용자 및 그룹 권한에만 설정할 수 있습니다.
• 시간은 미래여야 합니다.
• 시간은 현재로부터 1년을 초과할 수 없습니다.

참고: 이전 Drive API v2를 사용하는 경우 expirationDate 필드를 사용하세요. Drive API v3로 마이그레이션하는 방법을 알아보세요.

만료일에 관한 자세한 내용은 다음 도움말을 참고하세요.

• 파일 액세스 권한의 만료일 설정하기
• 만료일 추가하기

관련 주제

• 대기 중인 액세스 제안 관리하기
• 액세스가 제한된 폴더와 광범위한 액세스 권한이 있는 폴더 관리하기
• 파일 소유권 이전
• 파일 콘텐츠 보호하기
• 리소스 키를 사용하여 링크로 공유된 드라이브 파일에 액세스하기
• 역할 및 권한