Dart

Google Drive Insert Permission

See more Google Drive Examples

This example demonstrates how to insert a permission for a file (see https://developers.google.com/drive/v2/reference/permissions/insert)

The impetus for creating this example was a need to be able to view files uploaded using a service account key in the Google Drive web interface. When using a service account access token, the files your application will see are those for the service account, and not the files for your main account. For example, the Google Account I use for testing has a username of "support@chilkatcloud.com". (Don't send email to support@chilkatcloud.com, it's just use for testing and not interactively read.) I use "support@chilkatcloud.com" when I log into Google interactively to view files in Google Drive at https://drive.google.com/drive/my-drive.

The files I upload to Google Drive using a service account key won't be visible in the browser UI. To make them visible, you need to insert a permission for the file so that the main user account, which in this case is "support@chilkatcloud.com", is a reader. After the permission is inserted, the file will be visible under "Shared with me" -- as if another Google Drive account shared the file with you.

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // It requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  // This example uses a previously obtained access token having permission for the 
  // Google Drive scope.

  final gAuth = CkAuthGoogle();
  gAuth.accessToken = 'GOOGLE-DRIVE-ACCESS-TOKEN';

  final rest = CkRest();

  // Connect using TLS.
  final bAutoReconnect = true;
  rest.connect('www.googleapis.com', 443, true, bAutoReconnect);

  // Provide the authentication credentials (i.e. the access token)
  rest.setAuthGoogle(gAuth);

  rest.addHeader('Content-Type', 'application/json; charset=UTF-8');

  final json = CkJsonObject();
  json.appendString('role', 'reader');
  json.appendString('type', 'user');
  json.appendString('value', 'support@chilkatcloud.com');

  // A note from a Chilkat customer:
  // 
  //   My coding attempt was frustrated because I tried a role of "owner".
  //   Even when providing the extra parameter of ...?transferOwnership=true
  //   that approach fails (400, Bad Request).
  // 

  // This example is inserting a permission for the file whose fileId is "0By-hrxCCDzSQUGxJY0hzNUFpNmc".
  final String jsonResponse;
  try {
    jsonResponse = rest.fullRequestString('POST', '/drive/v2/files/0By-hrxCCDzSQUGxJY0hzNUFpNmc/permissions', json.emit());
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A successful response will have a status code equal to 200.
  if (rest.responseStatusCode != 200) {
    print('response status code = ${rest.responseStatusCode}');
    print('response status text = ${rest.responseStatusText}');
    print('response header: ${rest.responseHeader}');
    print('response JSON: $jsonResponse');
    return;
  }

  // Show the JSON response.
  json.load(jsonResponse);

  // Show the full JSON response.
  json.emitCompact = false;
  print(json.emit());

  print('Success.');
}