(Delphi DLL) Get File Metadata

Gets a file's metadata or content by ID.

See Google Drive Files get for additional details.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, StringBuilder, AuthGoogle, JsonObject, Rest;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
gAuth: HCkAuthGoogle;
rest: HCkRest;
bAutoReconnect: Boolean;
sbPath: HCkStringBuilder;
allFields: PWideChar;
jsonResponse: PWideChar;
json: HCkJsonObject;
wasLastModifiedUserMe: Boolean;
width: Integer;
i: Integer;
numParents: Integer;
numOwners: Integer;
numPermissions: Integer;

begin
success := True;

// 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.

gAuth := CkAuthGoogle_Create();
CkAuthGoogle_putAccessToken(gAuth,'GOOGLE-DRIVE-ACCESS-TOKEN');

rest := CkRest_Create();

// Connect using TLS.
// A single REST object, once connected, can be used for many Google Drive REST API calls.
// The auto-reconnect indicates that if the already-established HTTPS connection is closed,
// then it will be automatically re-established as needed.
bAutoReconnect := True;
success := CkRest_Connect(rest,'www.googleapis.com',443,True,bAutoReconnect);

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

// ------------------------------------------------------------------------------

// We need to send a GET request like this:
// GET https://www.googleapis.com/drive/v3/files/fileId
// The fileId is part of the path.
sbPath := CkStringBuilder_Create();
CkStringBuilder_Append(sbPath,'/drive/v3/files/');
// Assume we previously obtained the fileId for the file of interest...
CkStringBuilder_Append(sbPath,'0B53Q6OSTWYolbUF6WS1Gei1oalk');

// Indicate that we want ALL possible fields.
// If no fields are indicated, then only the basic fields are returned.
allFields := 'appProperties,capabilities,contentHints,createdTime,description,explicitlyTrashed,fileExtension,folderColorRgb,fullFileExtension,headRevisionId,iconLink,id,imageMediaMetadata,isAppAuthorized,kind,lastModifyingUser,md5Checksum,mimeType,modifiedByMeTime,modifiedTime,name,originalFilename,ownedByMe,owners,parents,permissions,properties,quotaBytesUsed,shared,sharedWithMeTime,sharingUser,size,spaces,starred,thumbnailLink,trashed,version,videoMediaMetadata,viewedByMe,viewedByMeTime,viewersCanCopyContent,webContentLink,webViewLink,writersCanShare';

CkRest_AddQueryParam(rest,'fields',allFields);

jsonResponse := CkRest__fullRequestNoBody(rest,'GET',CkStringBuilder__getAsString(sbPath));
if (CkRest_getLastMethodSuccess(rest) <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// A successful response will have a status code equal to 200.
if (CkRest_getResponseStatusCode(rest) <> 200) then
  begin
    Memo1.Lines.Add('response status code = ' + IntToStr(CkRest_getResponseStatusCode(rest)));
    Memo1.Lines.Add('response status text = ' + CkRest__responseStatusText(rest));
    Memo1.Lines.Add('response header: ' + CkRest__responseHeader(rest));
    Memo1.Lines.Add('response JSON: ' + jsonResponse);
    Exit;
  end;

// ---------------------------------------------------
// Sample code for parsing this JSON is shown below...
// ---------------------------------------------------

// A successful response looks like this:
// {
//   "kind": "drive#file",
//   "id": "0B53Q6OSTWYolbUF6WS1Gei1oalk",
//   "name": "penguins.jpg",
//   "mimeType": "image/jpeg",
//   "starred": false,
//   "trashed": false,
//   "explicitlyTrashed": false,
//   "parents": [
//     "0B53Q6OSTWYola296ODZUSm5GYU0"
//   ],
//   "spaces": [
//     "drive"
//   ],
//   "version": "672",
//   "webContentLink": "https://docs.google.com/a/chilkatcloud.com/uc?id=0B53Q6OSTWYolbUF6WS1Gei1oalk&export=download",
//   "webViewLink": "https://drive.google.com/a/chilkatcloud.com/file/d/0B53Q6OSTWYolbUF6WS1Gei1oalk/view?usp=drivesdk",
//   "iconLink": "https://ssl.gstatic.com/docs/doclist/images/icon_11_image_list.png",
//   "thumbnailLink": "https://lh5.googleusercontent.com/uIV1dJdc8vsAQzaaIInpc9AV55AcdHhpM7fQeI2RN2qbCSnhjK9IDdNQAOTtkvjS9ZObqw=s220",
//   "viewedByMe": true,
//   "viewedByMeTime": "2016-10-08T12:38:02.258Z",
//   "createdTime": "2016-10-08T12:38:02.258Z",
//   "modifiedTime": "2016-10-08T12:38:02.258Z",
//   "modifiedByMeTime": "2016-10-08T12:38:02.258Z",
//   "owners": [
//     {
//       "kind": "drive#user",
//       "displayName": "Matthew Smith",
//       "me": true,
//       "permissionId": "08366696655122259092",
//       "emailAddress": "support@chilkatcloud.com"
//     }
//   ],
//   "lastModifyingUser": {
//     "kind": "drive#user",
//     "displayName": "Matthew Smith",
//     "me": true,
//     "permissionId": "08366696655122259092",
//     "emailAddress": "support@chilkatcloud.com"
//   },
//   "shared": false,
//   "ownedByMe": true,
//   "capabilities": {
//     "canEdit": true,
//     "canComment": true,
//     "canShare": true,
//     "canCopy": true,
//     "canReadRevisions": true
//   },
//   "viewersCanCopyContent": true,
//   "writersCanShare": true,
//   "permissions": [
//     {
//       "kind": "drive#permission",
//       "id": "08366696655122259092",
//       "type": "user",
//       "emailAddress": "support@chilkatcloud.com",
//       "role": "owner",
//       "displayName": "Matthew Smith"
//     }
//   ],
//   "originalFilename": "penguins.jpg",
//   "fullFileExtension": "jpg",
//   "fileExtension": "jpg",
//   "md5Checksum": "9d377b10ce778c4938b3c7e2c63a229a",
//   "size": "777835",
//   "quotaBytesUsed": "777835",
//   "headRevisionId": "0B53Q6OSTWYolUUlHVFhHdFlXQ0R1aHZuT0tORTVzc2h5NnZjPQ",
//   "imageMediaMetadata": {
//     "width": 1024,
//     "height": 768,
//     "rotation": 0,
//     "time": "2009:03:12 13:48:35"
//   },
//   "isAppAuthorized": false
// }

// Iterate over each file in the response and show the name, id, and mimeType.
json := CkJsonObject_Create();
CkJsonObject_Load(json,jsonResponse);

// Show the full JSON response.
CkJsonObject_putEmitCompact(json,False);
Memo1.Lines.Add(CkJsonObject__emit(json));
Memo1.Lines.Add('-');

// Demonstrate how to get pieces of information:
Memo1.Lines.Add('Original Filename: ' + CkJsonObject__stringOf(json,'originalFilename'));

wasLastModifiedUserMe := CkJsonObject_BoolOf(json,'lastModifyingUser.me');
Memo1.Lines.Add('Was Last Modified by Me: ' + IntToStr(Ord(wasLastModifiedUserMe)));

// Assuming this is an image file...
width := CkJsonObject_IntOf(json,'imageMediaMetadata.width');
Memo1.Lines.Add('Image Width: ' + IntToStr(width));

// Iterate over parents...

numParents := CkJsonObject_SizeOfArray(json,'parents');
i := 0;
while i < numParents do
  begin
    CkJsonObject_putI(json,i);
    Memo1.Lines.Add('Parent ' + IntToStr(i) + ': ' + CkJsonObject__stringOf(json,'parents[i]'));
    i := i + 1;
  end;

// Iterate over owners...
numOwners := CkJsonObject_SizeOfArray(json,'owners');
i := 0;
while i < numOwners do
  begin
    CkJsonObject_putI(json,i);
    Memo1.Lines.Add('Owner ' + IntToStr(i) + ': kind=' + CkJsonObject__stringOf(json,'owners[i].kind') + ' displayName=' + CkJsonObject__stringOf(json,'owners[i].displayName'));
    i := i + 1;
  end;

// Iterate over permissions...
numPermissions := CkJsonObject_SizeOfArray(json,'permissions');
i := 0;
while i < numPermissions do
  begin
    CkJsonObject_putI(json,i);
    Memo1.Lines.Add('Permission ' + IntToStr(i) + ': kind=' + CkJsonObject__stringOf(json,'permissions[i].kind') + ' id=' + CkJsonObject__stringOf(json,'permissions[i].id'));
    i := i + 1;
  end;

CkAuthGoogle_Dispose(gAuth);
CkRest_Dispose(rest);
CkStringBuilder_Dispose(sbPath);
CkJsonObject_Dispose(json);

end;