ファイル、フォルダ、ドライブの共有

Google ドライブのすべてのファイル、フォルダ、共有ドライブが permissions リソースが含まれています。各リソース 特定の type(ユーザー、グループ、ドメイン、全員)の権限を識別します。 および role(「commenter」など)入力しますたとえば、ファイルに 特定のユーザー(type=user)に読み取り専用アクセス権を付与する権限 (role=reader)で、別の権限は特定のグループのメンバーに付与します (type=group)ファイルにコメントを追加する機能(role=commenter)。

ロールと各ロールで許可される操作の完全なリストについては、 役割と権限

ドライブ リソースの共有シナリオ

共有のシナリオには次の 5 種類があります。

  1. マイドライブ内のファイルを共有するには、role=writer または role=owner

  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 を持っている必要があります。単独 ユーザーとグループは共有ドライブのメンバーになることができます。

有効期限を設定してファイルへのアクセスを制限する

機密性の高いプロジェクトで同僚と作業するときは、 ドライブ内の特定のファイルへのアクセスを、一定期間後に制限する あります。マイドライブ内のファイルについては、有効期限を そのファイルへのアクセスを制限または削除できます。

有効期限を設定するには:

expirationTime フィールドは、RFC 3339 を使用して権限の有効期限を示します。 日時 をタップします。有効期限には次の制限があります。

  • ユーザーとグループの権限に対してのみ設定できます。
  • 時刻には将来の時刻を指定してください。
  • 1 年以内の日時は指定できません。
で確認できます。

有効期限の詳細については、次の記事をご覧ください。

権限の伝播

フォルダの権限リストは下位に伝播され、すべての子ファイルと フォルダの権限は親から継承されます。権限や API 呼び出しが 変更されると、伝播は、すべてのネストされた できます。たとえば、フォルダ内にファイルが存在し、そのフォルダを移動する場合です。 その新しいフォルダの権限がファイルに反映されます。 新しいフォルダでファイルのユーザーに「writer」などの新しいロールが付与される場合、 古いロールがオーバーライドされます

逆に、ファイルがフォルダから role=writer を継承し、別のフォルダに移動された場合 「リーダー」機能を備えた別のフォルダをロールが付与されていない場合、ファイルは role=reader

継承された権限を共有ドライブ内のファイルやフォルダから削除することはできません。 代わりに、直接的または間接的な親に対してこれらの権限を調整する必要があります。 継承されます。継承された権限は、 マイドライブまたは [共有アイテム] を選択します。

逆に、継承された権限は、[マイページ] 内のファイルまたはフォルダでオーバーライドできます。 。たとえば、ファイルが Myrole=writer ファイルに対して role=reader を設定すると、 権限レベルを指定できます。

機能

Permissions リソースは、 現在のユーザーがファイルやフォルダに対して実行できる操作を確認する。 代わりに、Files リソースには、 アクションの実行を許可するかどうかを示すブール値の capabilities フィールド 実行することもできます。Google Drive API は、これらのフィールドを ファイルまたはフォルダに関連付けられている現在のユーザーの権限リソース。

たとえば、Alex がアプリにログインし、ファイルを共有しようとすると、Alex の役割は チェックされます。ファイル共有が許可されるロールでは、 ファイルに関連する capabilitiescanShare など)が入力されます。 決定しますAlex がファイルを共有したい場合は、 capabilities: canSharetrue に設定されていることを確認します。

ファイル capabilities を取得する例については、ユーザーの確認をご覧ください。 権限

権限を作成する

権限を作成する際は、次の 2 つのフィールドが必要です。

  • type - type 権限の範囲(usergroupdomain、または 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. permissions.create メソッドを使用する 関連するファイルまたはフォルダの fileId に置き換えます。
  2. リクエストの本文で、typerole を指定します。
  3. type=user または type=group の場合は、emailAddress を指定します。type=domain の場合、 domain を指定します。

例を表示

次のコードサンプルは、権限の作成方法を示しています。レスポンスは、割り当てられた permissionId を含む Permission リソースのインスタンスを返します。

リクエスト

POST https://www.googleapis.com/drive/v3/files/FILE_ID/permissions
{
  "requests": [
    {
        "type": "user",
        "role": "commenter",
        "emailAddress": "alex@altostrat.com"
    }
  ]
}

レスポンス

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

対象グループを使用する

対象グループとは、部門やチームなどのグループ単位で、 ユーザーにアイテムの共有先としておすすめします。ユーザーに共有を促すことで、 オーディエンス全体ではなく、より限定的または限定的なオーディエンスに できます。対象グループを使用すると、Google Chat のセキュリティとプライバシーを強化でき、 ユーザーが簡単に適切に共有できるようになります。詳細情報 詳しくは、ターゲットについて オーディエンス をタップします。

対象グループを使用するには:

  1. Google 管理コンソールで、メニュー アイコン > ディレクトリ > [対象グループ] をタップします。

    [対象グループ] に移動

    このタスクを行うには、特権管理者権限を持つアカウントでログインする必要があります。

  2. [対象グループのリスト] で、対象グループの名前をクリックします。宛先 対象グループを作成するには、ターゲットを作成する オーディエンス

  3. 対象グループの URL から一意の ID(https://admin.google.com/ac/targetaudiences/ID)をコピーします。

  4. type=domain権限を作成し、domain フィールドを ID.audience.googledomains.com に設定します。

ユーザーが対象グループとどのようにやり取りしているかを確認するには、リンクのユーザー エクスペリエンスをご覧ください。 共有 をタップします。

ファイル、フォルダ、共有ドライブのすべての権限を取得する

permissions.list メソッドを使用して、以下を行います。 ファイル、フォルダ、共有ドライブのすべての権限を取得する。

例を表示

次のコードサンプルは、すべての権限を取得する方法を示しています。レスポンスで権限のリストが返されます。

リクエスト

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"
    }
  ]
}

ユーザー権限を確認する

アプリでファイルを開くと、ファイルの機能をチェックして、ファイルをレンダリング 現在のユーザーの権限を反映します。たとえば、ユーザーが そのファイルに対する canComment 機能がないが、コメントは UI で無効にする必要があります

capabilities の詳細については、機能をご覧ください。 ご覧ください。

機能を確認するには、次のように files.get を呼び出します。 fileIdfields パラメータを capabilities フィールドに設定。対象 fields パラメータを使用してフィールドを返す方法の詳細については、以下をご覧ください。 ファイルの特定のフィールドを返す

例を表示

次のコードサンプルは、ユーザー権限を確認する方法を示しています。レスポンスでは、ユーザーがファイルに対して持っている機能のリストが返されます。各ケーパビリティは、ユーザーが実行できるきめ細かいアクションに対応しています。一部のフィールドは共有ドライブ内のアイテムに対してのみ入力されます。

リクエスト

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

レスポンス

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

共有ドライブのファイルに対するロールのソースを特定するフォルダ

ファイルまたはフォルダのロールを変更するには、ロールのソースを把握している必要があります。 共有ドライブの場合、ロールのソースは共有ドライブのメンバーシップに基づいて フォルダに対するロール、ファイルに対するロールです。

共有ドライブまたは共有ドライブ内のアイテムに対するロールの参照元を特定する 場合、permissions.getfileIdpermissionIdfields パラメータを permissionDetails フィールド。permissionId を見つけるには、次のコマンドを使用します。 permissions.listfileId に置き換えます。宛先 permissions.list リクエストの permissionDetails フィールドを取得し、 fields パラメータを permissions/permissionDetails に追加します。

このフィールドには、そのユーザーのすべての継承された直接ファイル権限と、 グループ、ドメインです。

例を表示

次のコードサンプルは、ロールのソースを確認する方法を示しています。レスポンスは、Permission リソースの 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
    }
  ]
}

権限を変更

ファイルまたはフォルダの権限を変更するには、割り当てられているロールを変更します。

  1. 次で permissions.update を呼び出します。 変更する権限の permissionId と、変更する権限の fileId ファイルやフォルダ、共有ドライブを削除します。permissionId を見つけるには、次のコマンドを使用します。 permissions.listfileId に置き換えます。

  2. リクエスト内で、新しい role を特定します。

共有ドライブ内の個々のファイルまたはフォルダに対して権限を付与できます。 ユーザーまたはグループがすでにメンバーになっている場合。たとえば、Alex には role=commenter があります。 そのメンバーが共有ドライブのメンバーとして移動します。ただし、アプリは Alex に 共有ドライブのファイルに対する role=writer。今回の場合、新しいロールには 付与されているロールよりも制限が緩やかな場合、新しい その権限が、ファイルまたはフォルダの有効なロールになります。

例を表示

次のコードサンプルは、ファイルまたはフォルダの権限をコメント投稿者からライターに変更する方法を示しています。レスポンスは Permission リソースのインスタンスを返します。

リクエスト

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"
}

ファイルまたはフォルダへのアクセス権を取り消す

ファイルまたはフォルダへのアクセス権を取り消すには、 delete は、fileIdpermissionId で権限を削除します。

[マイドライブ] 内のアイテムについては、継承された 付与します。継承された権限を削除すると、そのアイテムへのアクセス権が取り消され、 子アイテム(存在する場合)を返します。

共有ドライブ内のアイテムについては、継承された権限を取り消すことはできません。更新または 親ファイルまたは親フォルダの権限を取り消すこともできます。

delete オペレーションは、サービスに直接適用された権限を削除するためにも使用されます。 共有ドライブのファイルまたはフォルダです。

例を表示

次のコードサンプルは、permissionId を削除してアクセス権を取り消す方法を示しています。成功すると、レスポンスの本文は空になります。権限が削除されたことを確認するには、fileIdpermissions.list を使用します。

リクエスト

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

ファイルのオーナー権限を同じ組織内の別の Google Workspace アカウントに譲渡する

[マイドライブ] にあるファイルのオーナー権限移行元のマシンから 1 つの Google Workspace アカウント 同じ組織内の別のアカウントに 移行する場合です共有バケットを所有する組織は ドライブ内のファイルを所有しますそのため、所有権の移転はサポートされていません。 共有ドライブ内のファイルとフォルダに対する共有ドライブの主催者は 自分の [マイドライブ] に移動できます。 所有権が譲渡されます。

[マイドライブ] 内のファイルのオーナー権限を譲渡するには、次のいずれかの操作を行います。 次のとおりです。

  • 特定のユーザーに付与するファイル権限を作成する (type=user)オーナー権限(role=owner)。

  • role=owner で既存のファイルの権限を更新し、転送する 指定したユーザー(transferOwnership=true)にオーナー権限が譲渡されます。

で確認できます。

ある一般ユーザー向けアカウントから別のアカウントにファイルのオーナー権限を移行する

ファイルの所有権は、ある一般ユーザー向けアカウント間で譲渡できます。 ただし、ドライブ間でファイルのオーナー権限が移管されることはありません。 消費者 アカウント 新しいオーナー候補が譲渡に明示的に同意するまでは、所有権が譲渡されません。移行方法 ある一般ユーザー向けアカウントから別の一般ユーザー向けアカウントのファイル所有権。

  1. 現在の所有者は、ファイルを作成または更新することで、所有権の譲渡を開始します。 新しいオーナーになりたいユーザーのファイル権限。この権限には、 role=writertype=userpendingOwner=true です。もし 新しい所有者が所有者候補の権限を作成する場合、メール 新しいオーナー候補に、新しいオーナーである ファイルのオーナーになるよう求められます。

  2. 新しいオーナーがオーナー権限の譲渡リクエストを承諾するには、新しいオーナーを作成または 付与できます。この権限には、次の設定を含める必要があります。 role=ownertransferOwnership=true。新しいオーナーが 新しい権限を許可すると、以前の所有者にメール通知が送信されます 所有権が譲渡されたことを示します。

ファイルを転送すると、以前のオーナーのロールは writer にダウングレードされます。

<ph type="x-smartling-placeholder">

バッチ リクエストで複数の権限を変更する

使用することを強く推奨します バッチ リクエストを使用して複数のリクエストを変更する 付与できます。

次の例は、コマンドを使用して権限の一括変更を行う クライアント ライブラリを使用します。

Java

drive/snippets/drive_v3/src/main/java/ShareFile.java
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
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": "user@example.com",
    }
    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="gduser1@workspacesamples.dev",
      real_domain="workspacesamples.dev",
  )

Node.js

drive/snippets/drive_v3/file_snippets/share_file.js
/**
 * Batch permission modification
 * @param{string} fileId file ID
 * @param{string} targetUserEmail username
 * @param{string} targetDomainName domain
 * @return{list} permission id
 * */
async function shareFile(fileId, targetUserEmail, targetDomainName) {
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});
  const permissionIds = [];

  const permissions = [
    {
      type: 'user',
      role: 'writer',
      emailAddress: targetUserEmail, // 'user@partner.com',
    },
    {
      type: 'domain',
      role: 'writer',
      domain: targetDomainName, // 'example.com',
    },
  ];
  // Note: Client library does not currently support HTTP batch
  // requests. When possible, use batched requests when inserting
  // multiple permissions on the same item. For this sample,
  // permissions are inserted serially.
  for (const permission of permissions) {
    try {
      const result = await service.permissions.create({
        resource: permission,
        fileId: fileId,
        fields: 'id',
      });
      permissionIds.push(result.data.id);
      console.log(`Inserted permission id: ${result.data.id}`);
    } catch (err) {
      // TODO(developer): Handle failed permissions
      console.error(err);
    }
  }
  return permissionIds;
}

PHP

drive/snippets/drive_v3/src/DriveShareFile.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' => 'user@example.com'
                ));
                $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
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;
        }
    }
}