feat: include a create permission sample for the drive API

samples/drive/README.md

@@ -1,6 +1,6 @@
 # Drive v3 API Samples
 
-These samples allow you to list, download, and upload files from Google Drive.
+These samples allow you to list, download, upload, and change the permissions of files from Google Drive.
 
 ## Running the samples
 
@@ -67,3 +67,17 @@ Example:
 ```
 node export.js 0B_Klegupc5gUcXhFZjZVUV9NeE0 ./file.pdf
 ```
+
+__Run the `create-permission.js` sample:__
+
+```
+node create-permission.js <fileId>
+```
+
+where `<fileId>` is the id of any file in Google Drive.
+
+Example:
+
+```
+node create-permission.js 0B_Klegupc5gUcXhFZjZVUV9NeE0
+```

samples/drive/create-permission.js

@@ -0,0 +1,49 @@
+// Copyright 2024 Google LLC
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+const {google} = require('googleapis');
+const path = require('path');
+const {authenticate} = require('@google-cloud/local-auth');
+
+const drive = google.drive('v3');
+
+async function runSample(fileId) {
+  // Obtain user credentials to use for the request
+  const auth = await authenticate({
+    keyfilePath: path.join(__dirname, '../oauth2.keys.json'),
+    scopes: [
+      'https://www.googleapis.com/auth/drive',
+      'https://www.googleapis.com/auth/drive.file',
+    ],
+  });
+  google.options({auth});
+
+  const res = await drive.permissions.create({
+    fileId: fileId,
+    requestBody: {
+      role: 'reader',
+      type: 'anyone',
+    },
+  });
+  console.log(res.data);
+  return res.data;
+}
+
+// if invoked directly (not tests), authenticate and run the samples
+if (module === require.main) {
+  const fileId = process.argv[2];
+  runSample(fileId).catch(console.error);
+}
+module.exports = runSample;

samples/test/test.samples.drive.js

@@ -29,6 +29,7 @@ const samples = {
   export: {path: '../drive/export'},
   list: {path: '../drive/list'},
   upload: {path: '../drive/upload'},
+  createPermission: {path: '../drive/create-permission'},
 };
 
 for (const sample of Object.values(samples)) {
@@ -87,4 +88,14 @@ describe('Drive samples', () => {
     assert(data);
     scope.done();
   });
+
+  it('should create a permission', async () => {
+    const fileId = '1EkgdLY3T-_9hWml0VssdDWQZLEc8qqpMB77Nvsx6khA';
+    const scope = nock(baseUrl)
+      .post(`/drive/v3/files/${fileId}/permissions`)
+      .reply(200, {});
+    const data = await samples.createPermission.runSample(fileId);
+    assert(data);
+    scope.done();
+  });
 });