GoogleDrive Class

Properties   Methods   Events   Config Settings   Errors  

The GoogleDrive class makes it easy to upload, download, and manage files and folders within Google Drive.

Syntax

GoogleDrive

Remarks

The GoogleDrive class provides an easy-to-use interface for Google Drive. Capabilities include uploading and downloading files, file and folder manipulation and organization, Google Shared Drive support, strong client-side file encryption functionality, and more.

Authentication

This class requires authentication via OAuth 2.0. First, perform OAuth authentication using the OAuth* properties to set the appropriate fields for the chosen OAuthClientProfile and OAuthGrantType.

The class has the following defaults:

Below is a brief description of the different OAuthClientProfile and OAuthGrantType values that are supported by this class. For a more in-depth description of what needs to be set, refer to the service documentation.

Application Profile

This profile encompasses the most basic grant types that OAuth supports. When this profile is set, all the requests and response handling is done by the class. Depending on the grant type, this may involve launching a browser so a user can login to authenticate with a authorization server. It may also involve starting an embedded web server to receive a response from a redirect.

To start the authentication and authorization process, the Authorize method should be called. If the authorization and authentication was successful, then the OAuthAccessToken property will be populated. Additionally, if a refresh token was provided the OAuthRefreshToken property will be populated as well. These values of the fields are for informational purposes. The class will also cache these tokens along with when the OAuthAccessToken will be expired. When a method that makes requests to the service provider is called or the Authorize method is called the class will automatically check to see if the access token is expired. If it is, it will then automatically try to get a new OAuthAccessToken. If the Authorize method was not used and user interaction would be required, the class will throw an error which can be caught. When user interaction is needed depends on what grant type is set in the OAuthGrantType property. To force the component to only check the access token when the Authorize method is called, the OAuthAutomaticRefresh configuration setting can be set to false.

A brief description of the supported values for the OAuthGrantType property are below. For more information, see the service documentation.

Authorization Code

When using the Authorization Code grant type, the class will use an authorization code to get an access token. For this OAuthGrantType the class expects a OAuthClientId, OAuthClientSecret, OAuthServerAuthURL, and OAuthServerTokenURL to be set. When the Authorize method is called, the component will start the embedded web server and launch the browser so the user can authorize the application. Once the user authorizes, the service provider will redirect them to the embedded web server and the class will parse the authorization code, setting the OAuthAuthorizationCode property, from the redirect. Immediately, the class will make a request to the token server to exchange the authorization code for an access token. The token server will return an access token and possibly a refresh token. If the OAuthRefreshToken property is set, or a refresh token is cached, then the class will not launch the browser and use the refresh token in its request to the token server instead of an authorization code.

Example: GoogleDrive googledrive = new GoogleDrive(); googledrive.OAuth.ClientProfile = OAuthClientProfiles.cocpApplication; googledrive.OAuth.GrantType = OAuthGrantTypes.cogtAuthorizationCode; googledrive.OAuth.ClientId = CLIENT_ID; googledrive.OAuth.ClientSecret = CLIENT_SECRET; googledrive.Authorize();

Implicit

Note: This grant type is considered insecure and should only be used when necessary.

When using the Implicit grant type, the class will request the authorization server to get an access token. For this OAuthGrantType the class expects a OAuthClientId, OAuthClientSecret, and OAuthServerAuthURL to be set. When the Authorize method is called, the component will start the embedded web server and launch the browser so the user can authorize the application. Once the user authorizes, the service provider will redirect them to the embedded web server and the class will parse the access token from the redirect.

A disadvantage of the grant type is that can not use a refresh token to silently get a new access token. Most service providers offer a way to silently get a new access token. See the service documentation for specifics. This means the class will not be able to automatically get a fresh token once it expires.

Web Profile

External OAuth Support

Bearer ACCESS_TOKEN_VALUE

Assign this value to the Authorization property before attempting any operations. Setting the Authorization property will cause the class to ignore the values set in the OAuth property.

For Example: Oauth oauth = new Oauth(); oauth.ClientId = "CLIENT_ID"; oauth.ClientSecret = "CLIENT_SECRET"; oauth.AuthorizationScope = "https://www.googleapis.com/auth/gmail.readonly"; oauth.ServerAuthURL = "https://accounts.google.com/o/oauth2/auth"; oauth.ServerTokenURL = "https://www.googleapis.com/auth/drive"; oauth.GrantType = OauthGrantTypes.ogtAuthorizationCode; googledrive.Authorization = oauth.GetAuthorization(); Consult the documentation for the service for more information about supported scope values and more details on OAuth authentication.

Listing Resources

The ListResources method is used to list resources within the scope specified by the ListResourcesScope property.

The ListChildren, ListParents, and GetResourceInfo methods are also available for finer-grained control. // ResourceList event handler. googledrive.OnResourceList += (s, e) => { Console.WriteLine(e.Name); }; // List all of the current user's resources. googledrive.ListResourcesScope = GoogledriveListResourcesScopes.lrsUser; do { googledrive.ListResources(); for (int i = 0; i < googledrive.Resources.Count; i++) { // Process resources here. } } while (!string.IsNullOrEmpty(googledrive.ResourceMarker)); // List all of the resources in the specified shared drive. googledrive.SharedDrive = "wfsr789vusijfv"; googledrive.ListResourcesScope = GoogledriveListResourcesScopes.lrsSharedDrive; do { googledrive.ListResources(); for (int i = 0; i < googledrive.Resources.Count; i++) { // Process resources here. } } while (!string.IsNullOrEmpty(googledrive.ResourceMarker));

Downloading Files

The DownloadFile method is used to download files.

Download Notes

To decrypt an encrypted file set EncryptionAlgorithm and EncryptionPassword before calling this method. googledrive.LocalFile = "../MyFile.zip"; googledrive.DownloadFile(googledrive.Resources[0].Id, "");

Resuming Downloads

The class also supports resuming failed downloads by using the StartByte property. If a download is interrupted, set StartByte to the appropriate offset before calling this method to resume the download. string downloadFile = "../MyFile.zip"; googledrive.LocalFile = downloadFile; googledrive.DownloadFile(googledrive.Resources[0].Id, ""); //The transfer is interrupted and DownloadFile() above fails. Later, resume the download: //Get the size of the partially downloaded file googledrive.StartByte = new FileInfo(downloadFile).Length; googledrive.DownloadFile(googledrive.Resources[0].Id, "");

Resuming Encrypted File Downloads

Resuming encrypted file downloads is only supported when LocalFile was set in the initial download attempt.

If LocalFile is set when beginning an encrypted download, the class creates a temporary file in TempPath to hold the encrypted data until the download is complete. If the download is interrupted, DownloadTempFile will be populated with the path of the temporary file that holds the partial data.

To resume, DownloadTempFile must be populated, along with StartByte, to allow the remainder of the encrypted data to be downloaded. Once the encrypted data is downloaded it will be decrypted and written to LocalFile. googledrive.LocalFile = "../MyFile.zip"; googledrive.EncryptionPassword = "password"; googledrive.DownloadFile(googledrive.Resource[0].Id, ""); //The transfer is interrupted and DownloadFile() above fails. Later, resume the download: //Get the size of the partially download temp file googledrive.StartByte = new FileInfo(googledrive.Config("DownloadTempFile")).Length; googledrive.DownloadFile(googledrive.Resource[0].Id, "");

Uploading Files

The UploadFile method is used to upload files.

Upload Notes

Google Drive offers two ways to upload a file. For smaller files a simple upload option is provided to upload data in one request. This is the default option. For larger files, uploads can be fragmented into multiple pieces, allowing resuming of uploads that may be interrupted.

Simple

By default the class uses the simple upload mechanism. googledrive.LocalFile = "../MyFile.zip"; googledrive.UploadFile("MyFile.zip", "");

Resumable

To enable resumable uploads set UseResumableUpload to true. This is recommended for large files. The class will automatically fragment the specified file into smaller pieces and upload each individually. FragmentSize may be set to specify the size of the fragment if desired. The default fragment size is 10 MB.

When UseResumableUpload is set to true and UploadFile is called, a resumable upload session is started by the class. ResumeURL is populated with a URL identifying the session (this value may be needed for additional operations if the upload does not complete normally).

During a resumable upload, the FragmentComplete event fires after each fragment is uploaded to indicate overall progress. The class also updates StartByte as necessary to indicate the current offset in the file.

If the upload is interrupted for any reason, resuming it is easy. First, verify that ResumeURL and StartByte are populated (if the same instance of the class is used, they should already be populated, and no special action should be needed). If uploading from a stream, be sure to reset its position to where it was the first time the upload was started (typically the beginning). Then call UploadFile again to resume the upload at the specified StartByte offset.

Note that if the upload is not resumed after some time the upload session will expire. GetUploadStatus may be used to check the status of a resumable upload. googledrive.LocalFile = "../MyFile.zip"; googledrive.UploadFile("MyFile.zip", ""); //The transfer is interrupted and UploadFile() above fails. Later, resume the download. //Using the same instance StartByte and ResumeURL are already populated from the previous //upload attempt. googledrive.UploadFile("MyFile.zip", ""); MemoryStream uploadStream = new MemoryStream(File.ReadAllBytes("../MyFile.zip")); googledrive.SetUploadStream(uploadStream); googledrive.UploadFile("MyFile.zip", ""); //The transfer is interrupted and UploadFile() above fails. Later, resume the download. //Using the same instance StartByte and ResumeURL are already populated from the previous //upload attempt. //You MUST reset the stream's position to where it was when you first started the upload! uploadStream.Position = 0; googledrive.UploadFile("MyFile.zip", "");

Shared Drive Support

The GoogleDrive class has full support for Google Shared Drives. For the most common use-cases (such as those described above), there is very little difference when using a shared drive versus a personal Google Drive ("My Drive").

For more information about how to use the class with Google Shared Drives, refer to both the shared-drive-specific documentation sections for commonly-used methods like ListResources, MoveResource, UpdatePermissions, etc.; and browse through the documentation for shared-drive-specific methods and properties such as the AddSharedDriveMember and ListSharedDrives methods, the SharedDrive property, etc.

Additional Functionality

The GoogleDrive class offers advanced functionality beyond simple uploads and downloads. For instance:

• Encrypt and decrypt files using the EncryptionAlgorithm and EncryptionPassword properties.
• Basic file and folder manipulation and organization using methods such as CopyResource, CreateFolder, DeleteResource, MoveResource, and UpdateResource.
• Enumeration and manipulation of parent-child relationships using the AddParents, ListChildren, ListParents, and RemoveParents methods.
• Resourcing trashing and deletion: DeleteResource, TrashResource, RestoreResource.
• Control over permissions using ListPermissions and UpdatePermissions.
• Change tracking with ListChanges.
• And more!

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the class with short descriptions. Click on the links for further details.

AccountCanCreateSharedDrives Property (GoogleDrive Class)

Whether the account has permission to create shared drives.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetAccountCanCreateSharedDrives();

Unicode (Windows)
BOOL GetAccountCanCreateSharedDrives();

int cloudstorage_googledrive_getaccountcancreateshareddrives(void* lpObj);

bool GetAccountCanCreateSharedDrives();

Default Value

FALSE

Remarks

Whether the account has permission to create shared drives.

This property reflects whether the account has the permissions necessary to create shared drives.

This property is read-only and not available at design time.

Data Type

Boolean

AccountDriveUsage Property (GoogleDrive Class)

Amount of storage used in Google Drive.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetAccountDriveUsage();

Unicode (Windows)
LONG64 GetAccountDriveUsage();

int64 cloudstorage_googledrive_getaccountdriveusage(void* lpObj);

qint64 GetAccountDriveUsage();

Default Value

-1

Remarks

Amount of storage used in Google Drive.

This property reflects the storage usage, in bytes, for all items in the account's Google Drive (including trashed items).

This property is read-only and not available at design time.

Data Type

Long64

AccountEmail Property (GoogleDrive Class)

The email address of the account.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAccountEmail();

Unicode (Windows)
LPWSTR GetAccountEmail();

char* cloudstorage_googledrive_getaccountemail(void* lpObj);

QString GetAccountEmail();

Default Value

""

Remarks

The email address of the account.

This property reflects the email address associated with the account.

This property is read-only and not available at design time.

Data Type

String

AccountName Property (GoogleDrive Class)

The name of the account's user.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAccountName();

Unicode (Windows)
LPWSTR GetAccountName();

char* cloudstorage_googledrive_getaccountname(void* lpObj);

QString GetAccountName();

Default Value

""

Remarks

The name of the account's user.

This property reflects the name of the account's user.

This property is read-only and not available at design time.

Data Type

String

AccountPermissionId Property (GoogleDrive Class)

The permission Id associated with the account.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAccountPermissionId();

Unicode (Windows)
LPWSTR GetAccountPermissionId();

char* cloudstorage_googledrive_getaccountpermissionid(void* lpObj);

QString GetAccountPermissionId();

Default Value

""

Remarks

The permission Id associated with the account.

This property reflects the permission Id associated with the account. Any permissions (including shared drive memberships) created for this account will include this Id.

This property is read-only and not available at design time.

Data Type

String

AccountStorageQuota Property (GoogleDrive Class)

The account's storage quota.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetAccountStorageQuota();

Unicode (Windows)
LONG64 GetAccountStorageQuota();

int64 cloudstorage_googledrive_getaccountstoragequota(void* lpObj);

qint64 GetAccountStorageQuota();

Default Value

-1

Remarks

The account's storage quota.

This property reflects the account's storage quota, in bytes, across all Google services (Google Drive, Gmail, etc.).

A value of -1 indicates that the account does not have a storage quota (i.e., it has unlimited storage).

This property is read-only and not available at design time.

Data Type

Long64

AccountStorageUsage Property (GoogleDrive Class)

Amount of storage used across all Google services.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetAccountStorageUsage();

Unicode (Windows)
LONG64 GetAccountStorageUsage();

int64 cloudstorage_googledrive_getaccountstorageusage(void* lpObj);

qint64 GetAccountStorageUsage();

Default Value

-1

Remarks

Amount of storage used across all Google services.

This property reflects the account's total storage usage, in bytes, across all Google services (Google Drive, Gmail, etc.).

This property is read-only and not available at design time.

Data Type

Long64

AccountTrashUsage Property (GoogleDrive Class)

Amount of storage used by trashed items in Google Drive.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetAccountTrashUsage();

Unicode (Windows)
LONG64 GetAccountTrashUsage();

int64 cloudstorage_googledrive_getaccounttrashusage(void* lpObj);

qint64 GetAccountTrashUsage();

Default Value

-1

Remarks

Amount of storage used by trashed items in Google Drive.

This property reflects the storage usage, in bytes, for all trashed items in the account's Google Drive.

This property is read-only and not available at design time.

Data Type

Long64

Authorization Property (GoogleDrive Class)

OAuth 2.0 Authorization Token.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAuthorization();
int SetAuthorization(const char* lpszAuthorization);

Unicode (Windows)
LPWSTR GetAuthorization();
INT SetAuthorization(LPCWSTR lpszAuthorization);

char* cloudstorage_googledrive_getauthorization(void* lpObj);
int cloudstorage_googledrive_setauthorization(void* lpObj, const char* lpszAuthorization);

QString GetAuthorization();
int SetAuthorization(QString qsAuthorization);

Default Value

""

Remarks

This class supports authentication via OAuth 2.0. First, perform OAuth authentication using the OAuth* properties, using the OAuth class or a separate process. If using the OAuth* properties, then the Authorization property will not be used.

Bearer ACCESS_TOKEN

Data Type

String

ChangeMarker Property (GoogleDrive Class)

A marker indicating what page of changes to return next.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChangeMarker();
int SetChangeMarker(const char* lpszChangeMarker);

Unicode (Windows)
LPWSTR GetChangeMarker();
INT SetChangeMarker(LPCWSTR lpszChangeMarker);

char* cloudstorage_googledrive_getchangemarker(void* lpObj);
int cloudstorage_googledrive_setchangemarker(void* lpObj, const char* lpszChangeMarker);

QString GetChangeMarker();
int SetChangeMarker(QString qsChangeMarker);

Default Value

""

Remarks

This property will be populated when ListChanges is called if the results are paged and there are more pages. To list all changes, continue to call ListChanges until this property returns empty string.

Setting ChangeMarker will cause NextChangeMarker to be set to empty string.

Refer to ListChanges for more information.

This property is not available at design time.

Data Type

String

ChangeCount Property (GoogleDrive Class)

The number of records in the Change arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChangeCount();

Unicode (Windows)
INT GetChangeCount();

int cloudstorage_googledrive_getchangecount(void* lpObj);

int GetChangeCount();

Default Value

0

Remarks

This property controls the size of the following arrays:

• ChangeRemoved
• ChangeResourceId
• ChangeSharedDriveId
• ChangeTime
• ChangeType

The array indices start at 0 and end at ChangeCount - 1.

This property is read-only and not available at design time.

Data Type

Integer

ChangeRemoved Property (GoogleDrive Class)

Whether the file or shared drive has been removed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChangeRemoved(int iChangeIndex);

Unicode (Windows)
BOOL GetChangeRemoved(INT iChangeIndex);

int cloudstorage_googledrive_getchangeremoved(void* lpObj, int changeindex);

bool GetChangeRemoved(int iChangeIndex);

Default Value

FALSE

Remarks

Whether the file or shared drive has been removed.

This property indicates whether the file or shared drive to which the change applies has been removed.

The ChangeIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChangeCount property.

This property is read-only and not available at design time.

Data Type

Boolean

ChangeResourceId Property (GoogleDrive Class)

The Id of the file to which the change applies.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChangeResourceId(int iChangeIndex);

Unicode (Windows)
LPWSTR GetChangeResourceId(INT iChangeIndex);

char* cloudstorage_googledrive_getchangeresourceid(void* lpObj, int changeindex);

QString GetChangeResourceId(int iChangeIndex);

Default Value

""

Remarks

The Id of the file to which the change applies.

This property holds the Id of the file to which the change applies.

The ChangeIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChangeCount property.

This property is read-only and not available at design time.

Data Type

String

ChangeSharedDriveId Property (GoogleDrive Class)

The Id of the shared drive.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChangeSharedDriveId(int iChangeIndex);

Unicode (Windows)
LPWSTR GetChangeSharedDriveId(INT iChangeIndex);

char* cloudstorage_googledrive_getchangeshareddriveid(void* lpObj, int changeindex);

QString GetChangeSharedDriveId(int iChangeIndex);

Default Value

""

Remarks

The Id of the shared drive.

This property holds the Id of the shared drive to which the change applies (if ChangeType is ctSharedDrive (1)), or which owns the file to which the change applies (if ChangeType is ctFile (0)).

The ChangeIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChangeCount property.

This property is read-only and not available at design time.

Data Type

String

ChangeTime Property (GoogleDrive Class)

The time of the change.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChangeTime(int iChangeIndex);

Unicode (Windows)
LPWSTR GetChangeTime(INT iChangeIndex);

char* cloudstorage_googledrive_getchangetime(void* lpObj, int changeindex);

QString GetChangeTime(int iChangeIndex);

Default Value

""

Remarks

The time of the change.

This property holds the time of the change. This is a combined date-time value (formatted according to RFC 3339).

The ChangeIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChangeCount property.

This property is read-only and not available at design time.

Data Type

String

ChangeType Property (GoogleDrive Class)

Whether the change is for a file or a shared drive.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChangeType(int iChangeIndex);

Unicode (Windows)
INT GetChangeType(INT iChangeIndex);

CT_FILE(0), 
CT_SHARED_DRIVE(1)

int cloudstorage_googledrive_getchangetype(void* lpObj, int changeindex);

int GetChangeType(int iChangeIndex);

Default Value

0

Remarks

Whether the change is for a file or a shared drive.

This property indicates whether the change applies to a file or a shared drive. Possible values are:

• ctFile (0)
• ctSharedDrive (1)

The ChangeIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChangeCount property.

This property is read-only and not available at design time.

Data Type

Integer

ChildMarker Property (GoogleDrive Class)

A marker when child resources are paged.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildMarker();
int SetChildMarker(const char* lpszChildMarker);

Unicode (Windows)
LPWSTR GetChildMarker();
INT SetChildMarker(LPCWSTR lpszChildMarker);

char* cloudstorage_googledrive_getchildmarker(void* lpObj);
int cloudstorage_googledrive_setchildmarker(void* lpObj, const char* lpszChildMarker);

QString GetChildMarker();
int SetChildMarker(QString qsChildMarker);

Default Value

""

Remarks

This property returns a marker used to iterate over pages of child resources; it's populated when ListChildren is called if the results are paged.

Continue to call ListChildren until this property returns empty string in order to list all resources.

This property is not available at design time.

Data Type

String

ChildCount Property (GoogleDrive Class)

The number of records in the Child arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChildCount();

Unicode (Windows)
INT GetChildCount();

int cloudstorage_googledrive_getchildcount(void* lpObj);

int GetChildCount();

Default Value

0

Remarks

This property controls the size of the following arrays:

• ChildContentAccessible
• ChildCreatedTime
• ChildDescription
• ChildExtension
• ChildId
• ChildMD5Checksum
• ChildMIMEType
• ChildModifiedTime
• ChildName
• ChildOriginalName
• ChildOwner
• ChildOwnerEmail
• ChildParentIds
• ChildSharedDriveId
• ChildSize
• ChildStarred
• ChildTrashed
• ChildType
• ChildViewed
• ChildViewLink

The array indices start at 0 and end at ChildCount - 1.

This property is read-only and not available at design time.

Data Type

Integer

ChildContentAccessible Property (GoogleDrive Class)

Whether the resource's content is accessible to less-privileged users.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChildContentAccessible(int iChildIndex);

Unicode (Windows)
BOOL GetChildContentAccessible(INT iChildIndex);

int cloudstorage_googledrive_getchildcontentaccessible(void* lpObj, int childindex);

bool GetChildContentAccessible(int iChildIndex);

Default Value

FALSE

Remarks

Whether the resource's content is accessible to less-privileged users.

This property indicates whether the resource's content is accessible. If the resource is not accessible, it cannot be copied, downloaded, or printed by a users unless they have at least "writer" permissions.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

Boolean

ChildCreatedTime Property (GoogleDrive Class)

The creation date of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildCreatedTime(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildCreatedTime(INT iChildIndex);

char* cloudstorage_googledrive_getchildcreatedtime(void* lpObj, int childindex);

QString GetChildCreatedTime(int iChildIndex);

Default Value

""

Remarks

The creation date of the resource.

This property holds a DateTime string representing the creation date of the resource. This is a combined date-time value (formatted according to RFC 3339).

Note that while this property is writable, the class only uses it as input when UploadFile is called; it is ignored when calling UpdateResource.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildDescription Property (GoogleDrive Class)

A short description of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildDescription(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildDescription(INT iChildIndex);

char* cloudstorage_googledrive_getchilddescription(void* lpObj, int childindex);

QString GetChildDescription(int iChildIndex);

Default Value

""

Remarks

A short description of the resource.

This property specifies a short description of the resource.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildExtension Property (GoogleDrive Class)

The file extension of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildExtension(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildExtension(INT iChildIndex);

char* cloudstorage_googledrive_getchildextension(void* lpObj, int childindex);

QString GetChildExtension(int iChildIndex);

Default Value

""

Remarks

The file extension of the resource.

This property indicates the file extension of the resource. It cannot be set, and is empty for folder resources. To specify the extension when creating a new file resource include it when calling UploadFile.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildId Property (GoogleDrive Class)

The Id of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildId(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildId(INT iChildIndex);

char* cloudstorage_googledrive_getchildid(void* lpObj, int childindex);

QString GetChildId(int iChildIndex);

Default Value

""

Remarks

The Id of the resource.

This property holds the Id of the resource.

This property must be set before calling UpdateResource.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildMD5Checksum Property (GoogleDrive Class)

The MD5 checksum of the file resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildMD5Checksum(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildMD5Checksum(INT iChildIndex);

char* cloudstorage_googledrive_getchildmd5checksum(void* lpObj, int childindex);

QString GetChildMD5Checksum(int iChildIndex);

Default Value

""

Remarks

The MD5 checksum of the file resource.

This property holds the MD5 checksum of the resource, if it is a file resource.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildMIMEType Property (GoogleDrive Class)

The MIME type of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildMIMEType(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildMIMEType(INT iChildIndex);

char* cloudstorage_googledrive_getchildmimetype(void* lpObj, int childindex);

QString GetChildMIMEType(int iChildIndex);

Default Value

""

Remarks

The MIME type of the resource.

This property specifies the MIME type of the resource.

When calling UploadFile, this property is ignored in favor of the MimeType parameter of UploadFile.

When calling UpdateResource, this property is only submitted if new file data is being uploaded.

Some Google Drive MIME types:

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildModifiedTime Property (GoogleDrive Class)

The last modified date of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildModifiedTime(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildModifiedTime(INT iChildIndex);

char* cloudstorage_googledrive_getchildmodifiedtime(void* lpObj, int childindex);

QString GetChildModifiedTime(int iChildIndex);

Default Value

""

Remarks

The last modified date of the resource.

This property holds a DateTime string representing the last modified date of the resource. This is a combined date-time value (formatted according to RFC 3339).

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildName Property (GoogleDrive Class)

The name of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildName(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildName(INT iChildIndex);

char* cloudstorage_googledrive_getchildname(void* lpObj, int childindex);

QString GetChildName(int iChildIndex);

Default Value

""

Remarks

The name of the resource.

This property specifies the name of the resource.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildOriginalName Property (GoogleDrive Class)

The original name of the file resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildOriginalName(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildOriginalName(INT iChildIndex);

char* cloudstorage_googledrive_getchildoriginalname(void* lpObj, int childindex);

QString GetChildOriginalName(int iChildIndex);

Default Value

""

Remarks

The original name of the file resource.

This property specifies the original name of a file resource if the file was uploaded manually, or if the name was set programmatically through the API.

Updating ChildName will not change this value.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildOwner Property (GoogleDrive Class)

The name of the resource's owner.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildOwner(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildOwner(INT iChildIndex);

char* cloudstorage_googledrive_getchildowner(void* lpObj, int childindex);

QString GetChildOwner(int iChildIndex);

Default Value

""

Remarks

The name of the resource's owner.

This property holds the name of resource's owner.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildOwnerEmail Property (GoogleDrive Class)

The email address of the resource's owner.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildOwnerEmail(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildOwnerEmail(INT iChildIndex);

char* cloudstorage_googledrive_getchildowneremail(void* lpObj, int childindex);

QString GetChildOwnerEmail(int iChildIndex);

Default Value

""

Remarks

The email address of the resource's owner.

This property holds the email address of the resource's owner.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildParentIds Property (GoogleDrive Class)

The Ids of the resource's parent folders.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildParentIds(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildParentIds(INT iChildIndex);

char* cloudstorage_googledrive_getchildparentids(void* lpObj, int childindex);

QString GetChildParentIds(int iChildIndex);

Default Value

""

Remarks

The Ids of the resource's parent folders.

This property holds a comma-separated list of Ids for the resource's parent folders.

Note that while this property is writable, the class only uses it as input when UploadFile is called. To modify a resource's parents in any other case, use the AddParents, RemoveParents, and MoveResource methods.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildSharedDriveId Property (GoogleDrive Class)

The Id of the shared drive the resource is in.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildSharedDriveId(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildSharedDriveId(INT iChildIndex);

char* cloudstorage_googledrive_getchildshareddriveid(void* lpObj, int childindex);

QString GetChildSharedDriveId(int iChildIndex);

Default Value

""

Remarks

The Id of the shared drive the resource is in.

This property holds the Id of the shared drive that the resource is in, if applicable.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

ChildSize Property (GoogleDrive Class)

The size of the file resource in bytes.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetChildSize(int iChildIndex);

Unicode (Windows)
LONG64 GetChildSize(INT iChildIndex);

int64 cloudstorage_googledrive_getchildsize(void* lpObj, int childindex);

qint64 GetChildSize(int iChildIndex);

Default Value

0

Remarks

The size of the file resource in bytes.

This property holds the size of a file resource in bytes. This is only applicable to files.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

Long64

ChildStarred Property (GoogleDrive Class)

Whether the resource is starred.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChildStarred(int iChildIndex);

Unicode (Windows)
BOOL GetChildStarred(INT iChildIndex);

int cloudstorage_googledrive_getchildstarred(void* lpObj, int childindex);

bool GetChildStarred(int iChildIndex);

Default Value

FALSE

Remarks

Whether the resource is starred.

This property indicates whether the resource is starred by the current user.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

Boolean

ChildTrashed Property (GoogleDrive Class)

Whether the resource is in the trash.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChildTrashed(int iChildIndex);

Unicode (Windows)
BOOL GetChildTrashed(INT iChildIndex);

int cloudstorage_googledrive_getchildtrashed(void* lpObj, int childindex);

bool GetChildTrashed(int iChildIndex);

Default Value

FALSE

Remarks

Whether the resource is in the trash.

This property indicates whether the resource has been moved to trash.

Note that while this property is writable, the class only uses it as input when UpdateResource is called; it is ignored when calling UploadFile.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

Boolean

ChildType Property (GoogleDrive Class)

The resource's type.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChildType(int iChildIndex);

Unicode (Windows)
INT GetChildType(INT iChildIndex);

GDRT_FILE(0), 
GDRT_FOLDER(1)

int cloudstorage_googledrive_getchildtype(void* lpObj, int childindex);

int GetChildType(int iChildIndex);

Default Value

0

Remarks

The resource's type.

This property indicates whether the resource is a folder or a file. Possible values are:

Google treats files and folders in the same way, and folders are included when listing resources. The ResourceType property can be used to determine if a resource is a folder, a file, or a revision of a file.

To list, delete, and update folders use the ListResources, DeleteResource, and UpdateResource methods.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

Integer

ChildViewed Property (GoogleDrive Class)

Whether the resource has been viewed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChildViewed(int iChildIndex);

Unicode (Windows)
BOOL GetChildViewed(INT iChildIndex);

int cloudstorage_googledrive_getchildviewed(void* lpObj, int childindex);

bool GetChildViewed(int iChildIndex);

Default Value

FALSE

Remarks

Whether the resource has been viewed.

This property indicates whether the resource has been viewed by the current user.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

Boolean

ChildViewLink Property (GoogleDrive Class)

A link for opening the resource in a relevant Google editor or viewer in a browser.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetChildViewLink(int iChildIndex);

Unicode (Windows)
LPWSTR GetChildViewLink(INT iChildIndex);

char* cloudstorage_googledrive_getchildviewlink(void* lpObj, int childindex);

QString GetChildViewLink(int iChildIndex);

Default Value

""

Remarks

A link for opening the resource in a relevant Google editor or viewer in a browser.

This property holds the link to the resource. The link may be used to view the resource in a browser or relevant editor.

The ChildIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChildCount property.

This property is read-only and not available at design time.

Data Type

String

EncryptionAlgorithm Property (GoogleDrive Class)

The encryption algorithm.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetEncryptionAlgorithm();
int SetEncryptionAlgorithm(int iEncryptionAlgorithm);

Unicode (Windows)
INT GetEncryptionAlgorithm();
INT SetEncryptionAlgorithm(INT iEncryptionAlgorithm);

EA_AES(0), 
EA_BLOWFISH(1), 
EA_CAST(2), 
EA_DES(3), 
EA_IDEA(4), 
EA_RC2(5), 
EA_RC4(6), 
EA_TEA(7), 
EA_TRIPLE_DES(8), 
EA_TWOFISH(9), 
EA_RIJNDAEL(10), 
EA_CHA_CHA(11), 
EA_XSALSA_20(12)

int cloudstorage_googledrive_getencryptionalgorithm(void* lpObj);
int cloudstorage_googledrive_setencryptionalgorithm(void* lpObj, int iEncryptionAlgorithm);

int GetEncryptionAlgorithm();
int SetEncryptionAlgorithm(int iEncryptionAlgorithm);

Default Value

0

Remarks

This property specifies the encryption algorithm to be used. The maximum allowable key size is automatically used for the selected algorithm. Possible values are:

Data Type

Integer

EncryptionPassword Property (GoogleDrive Class)

The encryption password.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetEncryptionPassword();
int SetEncryptionPassword(const char* lpszEncryptionPassword);

Unicode (Windows)
LPWSTR GetEncryptionPassword();
INT SetEncryptionPassword(LPCWSTR lpszEncryptionPassword);

char* cloudstorage_googledrive_getencryptionpassword(void* lpObj);
int cloudstorage_googledrive_setencryptionpassword(void* lpObj, const char* lpszEncryptionPassword);

QString GetEncryptionPassword();
int SetEncryptionPassword(QString qsEncryptionPassword);

Default Value

""

Remarks

If this property is populated when UploadFile or DownloadFile is called, the class will attempt to encrypt or decrypt the data before uploading or after downloading it.

The class uses the value specified here to generate the necessary encryption Key and IV values using the PKCS5 password digest algorithm. This provides a simpler alternative to creating and managing Key and IV values directly.

However, it is also possible to explicitly specify the Key and IV values to use by setting the EncryptionKey and EncryptionIV configuration settings. This may be necessary if, e.g., the data needs to be encrypted/decrypted by another utility which generates Key and IV values differently.

This property is not available at design time.

Data Type

String

FirewallAutoDetect Property (GoogleDrive Class)

This property tells the class whether or not to automatically detect and use firewall system settings, if available.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetFirewallAutoDetect();
int SetFirewallAutoDetect(int bFirewallAutoDetect);

Unicode (Windows)
BOOL GetFirewallAutoDetect();
INT SetFirewallAutoDetect(BOOL bFirewallAutoDetect);

int cloudstorage_googledrive_getfirewallautodetect(void* lpObj);
int cloudstorage_googledrive_setfirewallautodetect(void* lpObj, int bFirewallAutoDetect);

bool GetFirewallAutoDetect();
int SetFirewallAutoDetect(bool bFirewallAutoDetect);

Default Value

FALSE

Remarks

This property tells the class whether or not to automatically detect and use firewall system settings, if available.

Data Type

Boolean

FirewallType Property (GoogleDrive Class)

This property determines the type of firewall to connect through.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetFirewallType();
int SetFirewallType(int iFirewallType);

Unicode (Windows)
INT GetFirewallType();
INT SetFirewallType(INT iFirewallType);

FW_NONE(0), 
FW_TUNNEL(1), 
FW_SOCKS4(2), 
FW_SOCKS5(3), 
FW_SOCKS4A(10)

int cloudstorage_googledrive_getfirewalltype(void* lpObj);
int cloudstorage_googledrive_setfirewalltype(void* lpObj, int iFirewallType);

int GetFirewallType();
int SetFirewallType(int iFirewallType);

Default Value

0

Remarks

This property determines the type of firewall to connect through. The applicable values are as follows:

Data Type

Integer

FirewallHost Property (GoogleDrive Class)

This property contains the name or IP address of firewall (optional).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetFirewallHost();
int SetFirewallHost(const char* lpszFirewallHost);

Unicode (Windows)
LPWSTR GetFirewallHost();
INT SetFirewallHost(LPCWSTR lpszFirewallHost);

char* cloudstorage_googledrive_getfirewallhost(void* lpObj);
int cloudstorage_googledrive_setfirewallhost(void* lpObj, const char* lpszFirewallHost);

QString GetFirewallHost();
int SetFirewallHost(QString qsFirewallHost);

Default Value

""

Remarks

This property contains the name or IP address of firewall (optional). If a FirewallHost is given, the requested connections will be authenticated through the specified firewall when connecting.

If this property is set to a Domain Name, a DNS request is initiated. Upon successful termination of the request, this property is set to the corresponding address. If the search is not successful, the class fails with an error.

Data Type

String

FirewallPassword Property (GoogleDrive Class)

This property contains a password if authentication is to be used when connecting through the firewall.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetFirewallPassword();
int SetFirewallPassword(const char* lpszFirewallPassword);

Unicode (Windows)
LPWSTR GetFirewallPassword();
INT SetFirewallPassword(LPCWSTR lpszFirewallPassword);

char* cloudstorage_googledrive_getfirewallpassword(void* lpObj);
int cloudstorage_googledrive_setfirewallpassword(void* lpObj, const char* lpszFirewallPassword);

QString GetFirewallPassword();
int SetFirewallPassword(QString qsFirewallPassword);

Default Value

""

Remarks

This property contains a password if authentication is to be used when connecting through the firewall. If FirewallHost is specified, the FirewallUser and FirewallPassword properties are used to connect and authenticate to the given firewall. If the authentication fails, the class fails with an error.

Data Type

String

FirewallPort Property (GoogleDrive Class)

This property contains the transmission control protocol (TCP) port for the firewall Host .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetFirewallPort();
int SetFirewallPort(int iFirewallPort);

Unicode (Windows)
INT GetFirewallPort();
INT SetFirewallPort(INT iFirewallPort);

int cloudstorage_googledrive_getfirewallport(void* lpObj);
int cloudstorage_googledrive_setfirewallport(void* lpObj, int iFirewallPort);

int GetFirewallPort();
int SetFirewallPort(int iFirewallPort);

Default Value

0

Remarks

This property contains the transmission control protocol (TCP) port for the firewall FirewallHost. See the description of the FirewallHost property for details.

Note: This property is set automatically when FirewallType is set to a valid value. See the description of the FirewallType property for details.

Data Type

Integer

FirewallUser Property (GoogleDrive Class)

This property contains a user name if authentication is to be used connecting through a firewall.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetFirewallUser();
int SetFirewallUser(const char* lpszFirewallUser);

Unicode (Windows)
LPWSTR GetFirewallUser();
INT SetFirewallUser(LPCWSTR lpszFirewallUser);

char* cloudstorage_googledrive_getfirewalluser(void* lpObj);
int cloudstorage_googledrive_setfirewalluser(void* lpObj, const char* lpszFirewallUser);

QString GetFirewallUser();
int SetFirewallUser(QString qsFirewallUser);

Default Value

""

Remarks

This property contains a user name if authentication is to be used connecting through a firewall. If the FirewallHost is specified, this property and FirewallPassword properties are used to connect and authenticate to the given Firewall. If the authentication fails, the class fails with an error.

Data Type

String

Idle Property (GoogleDrive Class)

The current status of the class.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetIdle();

Unicode (Windows)
BOOL GetIdle();

int cloudstorage_googledrive_getidle(void* lpObj);

bool GetIdle();

Default Value

TRUE

Remarks

Idle will be False if the component is currently busy (communicating and/or waiting for an answer), and True at all other times.

This property is read-only.

Data Type

Boolean

ListResourcesScope Property (GoogleDrive Class)

Controls the scope of the results when listing resources.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetListResourcesScope();
int SetListResourcesScope(int iListResourcesScope);

Unicode (Windows)
INT GetListResourcesScope();
INT SetListResourcesScope(INT iListResourcesScope);

LRS_USER(0), 
LRS_DOMAIN(1), 
LRS_SHARED_DRIVE(2), 
LRS_ALL_DRIVES(3)

int cloudstorage_googledrive_getlistresourcesscope(void* lpObj);
int cloudstorage_googledrive_setlistresourcesscope(void* lpObj, int iListResourcesScope);

int GetListResourcesScope();
int SetListResourcesScope(int iListResourcesScope);

Default Value

0

Remarks

This property controls the scope of the results when listing resources with ListResources or ListChildren. Valid values are:

Refer to ListResources for more information.

This property is not available at design time.

Data Type

Integer

LocalFile Property (GoogleDrive Class)

The location of the local file.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLocalFile();
wchar_t* GetLocalFile_W(); // Windows only
int SetLocalFile(const char* lpszLocalFile);
int SetLocalFile(const wchar_t* lpszLocalFile); // Windows only

Unicode (Windows)
LPWSTR GetLocalFile();
INT SetLocalFile(LPCWSTR lpszLocalFile);

char* cloudstorage_googledrive_getlocalfile(void* lpObj);
wchar_t* cloudstorage_googledrive_getlocalfile_W(void* lpObj); // Windows only
int cloudstorage_googledrive_setlocalfile(void* lpObj, const char* lpszLocalFile);
int cloudstorage_googledrive_setlocalfile(void* lpObj, const wchar_t* lpszLocalFile); // Windows only

QString GetLocalFile();
int SetLocalFile(QString qsLocalFile);

Default Value

""

Remarks

This property specifies the location of a file on disk. This is used as the source file when calling UploadFile or UpdateResource, and as the destination file when calling DownloadFile.

Note: Setting this property to a non-empty value will discard any streams set using SetDownloadStream and SetUploadStream. Similarly, passing a non-null value to either of the aforementioned methods will clear this property.

Data Type

String

LocalHost Property (GoogleDrive Class)

The name of the local host or user-assigned IP interface through which connections are initiated or accepted.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLocalHost();
int SetLocalHost(const char* lpszLocalHost);

Unicode (Windows)
LPWSTR GetLocalHost();
INT SetLocalHost(LPCWSTR lpszLocalHost);

char* cloudstorage_googledrive_getlocalhost(void* lpObj);
int cloudstorage_googledrive_setlocalhost(void* lpObj, const char* lpszLocalHost);

QString GetLocalHost();
int SetLocalHost(QString qsLocalHost);

Default Value

""

Remarks

The LocalHost property contains the name of the local host as obtained by the gethostname() system call, or if the user has assigned an IP address, the value of that address.

In multi-homed hosts (machines with more than one IP interface) setting LocalHost to the value of an interface will make the class initiate connections (or accept in the case of server classs) only through that interface.

If the class is connected, the LocalHost property shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multi-homed hosts (machines with more than one IP interface).

NOTE: LocalHost is not persistent. You must always set it in code, and never in the property window.

Data Type

String

NextChangeMarker Property (GoogleDrive Class)

A marker indicating what page of changes to return in the future.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetNextChangeMarker();
int SetNextChangeMarker(const char* lpszNextChangeMarker);

Unicode (Windows)
LPWSTR GetNextChangeMarker();
INT SetNextChangeMarker(LPCWSTR lpszNextChangeMarker);

char* cloudstorage_googledrive_getnextchangemarker(void* lpObj);
int cloudstorage_googledrive_setnextchangemarker(void* lpObj, const char* lpszNextChangeMarker);

QString GetNextChangeMarker();
int SetNextChangeMarker(QString qsNextChangeMarker);

Default Value

""

Remarks

This property will be populated when ListChanges is called if there are no more changes to list.

This property will be populated with the most current change marker if GetCurrentChangeMarker is called.

Setting NextChangeMarker will cause ChangeMarker to be set to empty string.

Refer to ListChanges for more information.

This property is not available at design time.

Data Type

String

OAuthAccessToken Property (GoogleDrive Class)

The access token returned by the authorization server.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthAccessToken();
int SetOAuthAccessToken(const char* lpszOAuthAccessToken);

Unicode (Windows)
LPWSTR GetOAuthAccessToken();
INT SetOAuthAccessToken(LPCWSTR lpszOAuthAccessToken);

char* cloudstorage_googledrive_getoauthaccesstoken(void* lpObj);
int cloudstorage_googledrive_setoauthaccesstoken(void* lpObj, const char* lpszOAuthAccessToken);

QString GetOAuthAccessToken();
int SetOAuthAccessToken(QString qsOAuthAccessToken);

Default Value

""

Remarks

The access token returned by the authorization server. This is set when the class makes a request to the token server.

This property is not available at design time.

Data Type

String

OAuthAuthorizationCode Property (GoogleDrive Class)

The authorization code that is exchanged for an access token.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthAuthorizationCode();
int SetOAuthAuthorizationCode(const char* lpszOAuthAuthorizationCode);

Unicode (Windows)
LPWSTR GetOAuthAuthorizationCode();
INT SetOAuthAuthorizationCode(LPCWSTR lpszOAuthAuthorizationCode);

char* cloudstorage_googledrive_getoauthauthorizationcode(void* lpObj);
int cloudstorage_googledrive_setoauthauthorizationcode(void* lpObj, const char* lpszOAuthAuthorizationCode);

QString GetOAuthAuthorizationCode();
int SetOAuthAuthorizationCode(QString qsOAuthAuthorizationCode);

Default Value

""

Remarks

The authorization code that is exchanged for an access token. This is required to be set when the OAuthClientProfile property is set to the Web profile. Otherwise, this field is for information purposes only.

This property is not available at design time.

Data Type

String

OAuthAuthorizationScope Property (GoogleDrive Class)

The scope request or response parameter used during authorization.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthAuthorizationScope();
int SetOAuthAuthorizationScope(const char* lpszOAuthAuthorizationScope);

Unicode (Windows)
LPWSTR GetOAuthAuthorizationScope();
INT SetOAuthAuthorizationScope(LPCWSTR lpszOAuthAuthorizationScope);

char* cloudstorage_googledrive_getoauthauthorizationscope(void* lpObj);
int cloudstorage_googledrive_setoauthauthorizationscope(void* lpObj, const char* lpszOAuthAuthorizationScope);

QString GetOAuthAuthorizationScope();
int SetOAuthAuthorizationScope(QString qsOAuthAuthorizationScope);

Default Value

""

Remarks

The scope request or response parameter used during authorization.

This property is not available at design time.

Data Type

String

OAuthClientId Property (GoogleDrive Class)

The id of the client assigned when registering the application.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthClientId();
int SetOAuthClientId(const char* lpszOAuthClientId);

Unicode (Windows)
LPWSTR GetOAuthClientId();
INT SetOAuthClientId(LPCWSTR lpszOAuthClientId);

char* cloudstorage_googledrive_getoauthclientid(void* lpObj);
int cloudstorage_googledrive_setoauthclientid(void* lpObj, const char* lpszOAuthClientId);

QString GetOAuthClientId();
int SetOAuthClientId(QString qsOAuthClientId);

Default Value

""

Remarks

The id of the client assigned when registering the application.

This property is not available at design time.

Data Type

String

OAuthClientProfile Property (GoogleDrive Class)

The type of client that is requesting authorization.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOAuthClientProfile();
int SetOAuthClientProfile(int iOAuthClientProfile);

Unicode (Windows)
INT GetOAuthClientProfile();
INT SetOAuthClientProfile(INT iOAuthClientProfile);

COCP_APPLICATION(0), 
COCP_WEB(1)

int cloudstorage_googledrive_getoauthclientprofile(void* lpObj);
int cloudstorage_googledrive_setoauthclientprofile(void* lpObj, int iOAuthClientProfile);

int GetOAuthClientProfile();
int SetOAuthClientProfile(int iOAuthClientProfile);

Default Value

0

Remarks

The type of client that is requesting authorization. See the introduction section for more information. Possible values are:

This property is not available at design time.

Data Type

Integer

OAuthClientSecret Property (GoogleDrive Class)

The secret value for the client assigned when registering the application.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthClientSecret();
int SetOAuthClientSecret(const char* lpszOAuthClientSecret);

Unicode (Windows)
LPWSTR GetOAuthClientSecret();
INT SetOAuthClientSecret(LPCWSTR lpszOAuthClientSecret);

char* cloudstorage_googledrive_getoauthclientsecret(void* lpObj);
int cloudstorage_googledrive_setoauthclientsecret(void* lpObj, const char* lpszOAuthClientSecret);

QString GetOAuthClientSecret();
int SetOAuthClientSecret(QString qsOAuthClientSecret);

Default Value

""

Remarks

The secret value for the client assigned when registering the application.

This property is not available at design time.

Data Type

String

OAuthGrantType Property (GoogleDrive Class)

The OAuth grant type used to acquire an OAuth access token.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOAuthGrantType();
int SetOAuthGrantType(int iOAuthGrantType);

Unicode (Windows)
INT GetOAuthGrantType();
INT SetOAuthGrantType(INT iOAuthGrantType);

COGT_AUTHORIZATION_CODE(0), 
COGT_IMPLICIT(1), 
COGT_PASSWORD(2), 
COGT_CLIENT_CREDENTIALS(3)

int cloudstorage_googledrive_getoauthgranttype(void* lpObj);
int cloudstorage_googledrive_setoauthgranttype(void* lpObj, int iOAuthGrantType);

int GetOAuthGrantType();
int SetOAuthGrantType(int iOAuthGrantType);

Default Value

0

Remarks

The OAuth grant type used to acquire an OAuth access token. See the introduction section for more information. Possible values are:

This property is not available at design time.

Data Type

Integer

OAuthRefreshToken Property (GoogleDrive Class)

Specifies the refresh token received from or sent to the authorization server.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthRefreshToken();
int SetOAuthRefreshToken(const char* lpszOAuthRefreshToken);

Unicode (Windows)
LPWSTR GetOAuthRefreshToken();
INT SetOAuthRefreshToken(LPCWSTR lpszOAuthRefreshToken);

char* cloudstorage_googledrive_getoauthrefreshtoken(void* lpObj);
int cloudstorage_googledrive_setoauthrefreshtoken(void* lpObj, const char* lpszOAuthRefreshToken);

QString GetOAuthRefreshToken();
int SetOAuthRefreshToken(QString qsOAuthRefreshToken);

Default Value

""

Remarks

Specifies the refresh token received from or sent to the authorization server. This property is set automatically if a refresh token is retrieved from the token server. If the OAuthAutomaticRefresh configuration setting is set to true, and the OAuthGrantType property is set to a grant that can use refresh tokens.

This property is not available at design time.

Data Type

String

OAuthReturnURL Property (GoogleDrive Class)

The URL where the user (browser) returns after authenticating.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthReturnURL();
int SetOAuthReturnURL(const char* lpszOAuthReturnURL);

Unicode (Windows)
LPWSTR GetOAuthReturnURL();
INT SetOAuthReturnURL(LPCWSTR lpszOAuthReturnURL);

char* cloudstorage_googledrive_getoauthreturnurl(void* lpObj);
int cloudstorage_googledrive_setoauthreturnurl(void* lpObj, const char* lpszOAuthReturnURL);

QString GetOAuthReturnURL();
int SetOAuthReturnURL(QString qsOAuthReturnURL);

Default Value

""

Remarks

The URL where the user (browser) returns after authenticating. This property is mapped to the redirect_uri parameter when making a request to the authorization server. Typically, this is automatically set by the class when using the embedded web server. If the OAuthWebServerPort or OAuthWebServerHost configuration settings is set, then this property should be set to match. If using the Web client profile, this should be set to the place where the authorization code will be parsed out of the response after the user finishes authorizing.

This property is not available at design time.

Data Type

String

OAuthServerAuthURL Property (GoogleDrive Class)

The URL of the authorization server.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthServerAuthURL();
int SetOAuthServerAuthURL(const char* lpszOAuthServerAuthURL);

Unicode (Windows)
LPWSTR GetOAuthServerAuthURL();
INT SetOAuthServerAuthURL(LPCWSTR lpszOAuthServerAuthURL);

char* cloudstorage_googledrive_getoauthserverauthurl(void* lpObj);
int cloudstorage_googledrive_setoauthserverauthurl(void* lpObj, const char* lpszOAuthServerAuthURL);

QString GetOAuthServerAuthURL();
int SetOAuthServerAuthURL(QString qsOAuthServerAuthURL);

Default Value

""

Remarks

The URL of the authorization server.

This property is not available at design time.

Data Type

String

OAuthServerTokenURL Property (GoogleDrive Class)

The URL of the token server used to obtain the access token.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthServerTokenURL();
int SetOAuthServerTokenURL(const char* lpszOAuthServerTokenURL);

Unicode (Windows)
LPWSTR GetOAuthServerTokenURL();
INT SetOAuthServerTokenURL(LPCWSTR lpszOAuthServerTokenURL);

char* cloudstorage_googledrive_getoauthservertokenurl(void* lpObj);
int cloudstorage_googledrive_setoauthservertokenurl(void* lpObj, const char* lpszOAuthServerTokenURL);

QString GetOAuthServerTokenURL();
int SetOAuthServerTokenURL(QString qsOAuthServerTokenURL);

Default Value

""

Remarks

The URL of the token server used to obtain the access token.

This property is not available at design time.

Data Type

String

OAuthWebAuthURL Property (GoogleDrive Class)

The URL to which the user should be re-directed for authorization.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOAuthWebAuthURL();

Unicode (Windows)
LPWSTR GetOAuthWebAuthURL();

char* cloudstorage_googledrive_getoauthwebauthurl(void* lpObj);

QString GetOAuthWebAuthURL();

Default Value

""

Remarks

The URL to which the user should be re-directed for authorization. This field is used to get the URL that the user should be redirected to when using the Web client profile. See introduction section for more information.

This property is read-only and not available at design time.

Data Type

String

OtherHeaders Property (GoogleDrive Class)

This property includes other headers as determined by the user (optional).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOtherHeaders();
int SetOtherHeaders(const char* lpszOtherHeaders);

Unicode (Windows)
LPWSTR GetOtherHeaders();
INT SetOtherHeaders(LPCWSTR lpszOtherHeaders);

char* cloudstorage_googledrive_getotherheaders(void* lpObj);
int cloudstorage_googledrive_setotherheaders(void* lpObj, const char* lpszOtherHeaders);

QString GetOtherHeaders();
int SetOtherHeaders(QString qsOtherHeaders);

Default Value

""

Remarks

This property can be set to a string of headers to be appended to the HTTP request headers created from other properties like ContentType and From.

The headers must follow the format Header: Value as described in the HTTP specifications. Header lines should be separated by CRLF ("\r\n") .

Use this property with caution. If this property contains invalid headers, HTTP requests may fail.

This property is useful for extending the functionality of the class beyond what is provided.

This property is not available at design time.

Data Type

String

Overwrite Property (GoogleDrive Class)

Determines if local files are overwritten.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOverwrite();
int SetOverwrite(int bOverwrite);

Unicode (Windows)
BOOL GetOverwrite();
INT SetOverwrite(BOOL bOverwrite);

int cloudstorage_googledrive_getoverwrite(void* lpObj);
int cloudstorage_googledrive_setoverwrite(void* lpObj, int bOverwrite);

bool GetOverwrite();
int SetOverwrite(bool bOverwrite);

Default Value

FALSE

Remarks

This property controls whether local files are overwritten when calling DownloadFile. It is only applicable to local files. The default value is false.

Data Type

Boolean

ParsedHeaderCount Property (GoogleDrive Class)

The number of records in the ParsedHeader arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetParsedHeaderCount();

Unicode (Windows)
INT GetParsedHeaderCount();

int cloudstorage_googledrive_getparsedheadercount(void* lpObj);

int GetParsedHeaderCount();

Default Value

0

Remarks

This property controls the size of the following arrays:

• ParsedHeaderField
• ParsedHeaderValue

The array indices start at 0 and end at ParsedHeaderCount - 1.

This property is read-only and not available at design time.

Data Type

Integer

ParsedHeaderField Property (GoogleDrive Class)

This property contains the name of the HTTP header (this is the same case as it is delivered).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetParsedHeaderField(int iParsedHeaderIndex);

Unicode (Windows)
LPWSTR GetParsedHeaderField(INT iParsedHeaderIndex);

char* cloudstorage_googledrive_getparsedheaderfield(void* lpObj, int parsedheaderindex);

QString GetParsedHeaderField(int iParsedHeaderIndex);

Default Value

""

Remarks

This property contains the name of the HTTP Header (this is the same case as it is delivered).

The ParsedHeaderIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ParsedHeaderCount property.

This property is read-only and not available at design time.

Data Type

String

ParsedHeaderValue Property (GoogleDrive Class)

This property contains the header contents.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetParsedHeaderValue(int iParsedHeaderIndex);

Unicode (Windows)
LPWSTR GetParsedHeaderValue(INT iParsedHeaderIndex);

char* cloudstorage_googledrive_getparsedheadervalue(void* lpObj, int parsedheaderindex);

QString GetParsedHeaderValue(int iParsedHeaderIndex);

Default Value

""

Remarks

This property contains the Header contents.

The ParsedHeaderIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ParsedHeaderCount property.

This property is read-only and not available at design time.

Data Type

String

PermissionMarker Property (GoogleDrive Class)

A marker when permissions are paged.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPermissionMarker();
int SetPermissionMarker(const char* lpszPermissionMarker);

Unicode (Windows)
LPWSTR GetPermissionMarker();
INT SetPermissionMarker(LPCWSTR lpszPermissionMarker);

char* cloudstorage_googledrive_getpermissionmarker(void* lpObj);
int cloudstorage_googledrive_setpermissionmarker(void* lpObj, const char* lpszPermissionMarker);

QString GetPermissionMarker();
int SetPermissionMarker(QString qsPermissionMarker);

Default Value

""

Remarks

This property returns a marker used to iterate over pages of permissions; it's populated when ListPermissions is called if the results are paged.

Continue to call ListPermissions until this property returns empty string in order to list all permissions.

This property is not available at design time.

Data Type

String

PermissionCount Property (GoogleDrive Class)

The number of records in the Permission arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPermissionCount();
int SetPermissionCount(int iPermissionCount);

Unicode (Windows)
INT GetPermissionCount();
INT SetPermissionCount(INT iPermissionCount);

int cloudstorage_googledrive_getpermissioncount(void* lpObj);
int cloudstorage_googledrive_setpermissioncount(void* lpObj, int iPermissionCount);

int GetPermissionCount();
int SetPermissionCount(int iPermissionCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• PermissionAllowFileDiscovery
• PermissionDomain
• PermissionEmail
• PermissionId
• PermissionModOp
• PermissionRole
• PermissionType

The array indices start at 0 and end at PermissionCount - 1.

This property is not available at design time.

Data Type

Integer

PermissionAllowFileDiscovery Property (GoogleDrive Class)

Whether the permission allows the file or folder to be discovered through search.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPermissionAllowFileDiscovery(int iPermissionIndex);
int SetPermissionAllowFileDiscovery(int iPermissionIndex, int bPermissionAllowFileDiscovery);

Unicode (Windows)
BOOL GetPermissionAllowFileDiscovery(INT iPermissionIndex);
INT SetPermissionAllowFileDiscovery(INT iPermissionIndex, BOOL bPermissionAllowFileDiscovery);

int cloudstorage_googledrive_getpermissionallowfilediscovery(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissionallowfilediscovery(void* lpObj, int permissionindex, int bPermissionAllowFileDiscovery);

bool GetPermissionAllowFileDiscovery(int iPermissionIndex);
int SetPermissionAllowFileDiscovery(int iPermissionIndex, bool bPermissionAllowFileDiscovery);

Default Value

FALSE

Remarks

Whether the permission allows the file or folder to be discovered through search.

This property indicates whether the permission allows the file or folder to which it applies to be discovered through search.

This property is only applicable if the permission's PermissionType is set to 2 (ptDomain) or 3 (ptAnyone).

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

Boolean

PermissionDomain Property (GoogleDrive Class)

The domain to which the permission applies.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPermissionDomain(int iPermissionIndex);
int SetPermissionDomain(int iPermissionIndex, const char* lpszPermissionDomain);

Unicode (Windows)
LPWSTR GetPermissionDomain(INT iPermissionIndex);
INT SetPermissionDomain(INT iPermissionIndex, LPCWSTR lpszPermissionDomain);

char* cloudstorage_googledrive_getpermissiondomain(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissiondomain(void* lpObj, int permissionindex, const char* lpszPermissionDomain);

QString GetPermissionDomain(int iPermissionIndex);
int SetPermissionDomain(int iPermissionIndex, QString qsPermissionDomain);

Default Value

""

Remarks

The domain to which the permission applies.

This property is used to define the domain to which the permission applies when PermissionType is set to 2 (ptDomain).

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

String

PermissionEmail Property (GoogleDrive Class)

The user or group to which the permission applies.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPermissionEmail(int iPermissionIndex);
int SetPermissionEmail(int iPermissionIndex, const char* lpszPermissionEmail);

Unicode (Windows)
LPWSTR GetPermissionEmail(INT iPermissionIndex);
INT SetPermissionEmail(INT iPermissionIndex, LPCWSTR lpszPermissionEmail);

char* cloudstorage_googledrive_getpermissionemail(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissionemail(void* lpObj, int permissionindex, const char* lpszPermissionEmail);

QString GetPermissionEmail(int iPermissionIndex);
int SetPermissionEmail(int iPermissionIndex, QString qsPermissionEmail);

Default Value

""

Remarks

The user or group to which the permission applies.

This property is used to define the user or group to which the permission applies when PermissionType is set to 0 (ptUser) or 1 (ptGroup).

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

String

PermissionId Property (GoogleDrive Class)

The Id of the permission.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPermissionId(int iPermissionIndex);
int SetPermissionId(int iPermissionIndex, const char* lpszPermissionId);

Unicode (Windows)
LPWSTR GetPermissionId(INT iPermissionIndex);
INT SetPermissionId(INT iPermissionIndex, LPCWSTR lpszPermissionId);

char* cloudstorage_googledrive_getpermissionid(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissionid(void* lpObj, int permissionindex, const char* lpszPermissionId);

QString GetPermissionId(int iPermissionIndex);
int SetPermissionId(int iPermissionIndex, QString qsPermissionId);

Default Value

""

Remarks

The Id of the permission.

This property holds the Id of the permission.

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

String

PermissionModOp Property (GoogleDrive Class)

The operation to perform on the permission.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPermissionModOp(int iPermissionIndex);
int SetPermissionModOp(int iPermissionIndex, int iPermissionModOp);

Unicode (Windows)
INT GetPermissionModOp(INT iPermissionIndex);
INT SetPermissionModOp(INT iPermissionIndex, INT iPermissionModOp);

MO_NONE(0), 
MO_CREATE(1), 
MO_UPDATE(2), 
MO_DELETE(3)

int cloudstorage_googledrive_getpermissionmodop(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissionmodop(void* lpObj, int permissionindex, int iPermissionModOp);

int GetPermissionModOp(int iPermissionIndex);
int SetPermissionModOp(int iPermissionIndex, int iPermissionModOp);

Default Value

0

Remarks

The operation to perform on the permission.

This property is used to specify the operation that the class should perform on the permission when UpdatePermissions is called. Valid values are:

Refer to UpdatePermissions for more information.

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

Integer

PermissionRole Property (GoogleDrive Class)

The role specified by the permission.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPermissionRole(int iPermissionIndex);
int SetPermissionRole(int iPermissionIndex, int iPermissionRole);

Unicode (Windows)
INT GetPermissionRole(INT iPermissionIndex);
INT SetPermissionRole(INT iPermissionIndex, INT iPermissionRole);

PR_READER(0), 
PR_COMMENTER(1), 
PR_WRITER(2), 
PR_OWNER(3), 
PR_FILE_ORGANIZER(4), 
PR_ORGANIZER(5)

int cloudstorage_googledrive_getpermissionrole(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissionrole(void* lpObj, int permissionindex, int iPermissionRole);

int GetPermissionRole(int iPermissionIndex);
int SetPermissionRole(int iPermissionIndex, int iPermissionRole);

Default Value

0

Remarks

The role specified by the permission.

This property defines the role specified by the permission. Possible values are:

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

Integer

PermissionType Property (GoogleDrive Class)

The set of users to which the permission applies.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPermissionType(int iPermissionIndex);
int SetPermissionType(int iPermissionIndex, int iPermissionType);

Unicode (Windows)
INT GetPermissionType(INT iPermissionIndex);
INT SetPermissionType(INT iPermissionIndex, INT iPermissionType);

PT_USER(0), 
PT_GROUP(1), 
PT_DOMAIN(2), 
PT_ANYONE(3)

int cloudstorage_googledrive_getpermissiontype(void* lpObj, int permissionindex);
int cloudstorage_googledrive_setpermissiontype(void* lpObj, int permissionindex, int iPermissionType);

int GetPermissionType(int iPermissionIndex);
int SetPermissionType(int iPermissionIndex, int iPermissionType);

Default Value

0

Remarks

The set of users to which the permission applies.

This property defines the set of users to which the permission role defined in PermissionRole applies.

The PermissionEmail and PermissionDomain properties are used to define the user, group, or domain to which the permission applies. The following table shows which property is associated with which permission type:

The PermissionIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PermissionCount property.

This property is not available at design time.

Data Type

Integer

ProxyAuthScheme Property (GoogleDrive Class)

This property is used to tell the class which type of authorization to perform when connecting to the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxyAuthScheme();
int SetProxyAuthScheme(int iProxyAuthScheme);

Unicode (Windows)
INT GetProxyAuthScheme();
INT SetProxyAuthScheme(INT iProxyAuthScheme);

AUTH_BASIC(0), 
AUTH_DIGEST(1), 
AUTH_PROPRIETARY(2), 
AUTH_NONE(3), 
AUTH_NTLM(4), 
AUTH_NEGOTIATE(5)

int cloudstorage_googledrive_getproxyauthscheme(void* lpObj);
int cloudstorage_googledrive_setproxyauthscheme(void* lpObj, int iProxyAuthScheme);

int GetProxyAuthScheme();
int SetProxyAuthScheme(int iProxyAuthScheme);

Default Value

0

Remarks

This property is used to tell the class which type of authorization to perform when connecting to the proxy. This is used only when the ProxyUser and ProxyPassword properties are set.

ProxyAuthScheme should be set to authNone (3) when no authentication is expected.

By default, ProxyAuthScheme is authBasic (0), and if the ProxyUser and ProxyPassword properties are set, the component will attempt basic authentication.

If ProxyAuthScheme is set to authDigest (1), digest authentication will be attempted instead.

If ProxyAuthScheme is set to authProprietary (2), then the authorization token will not be generated by the class. Look at the configuration file for the class being used to find more information about manually setting this token.

If ProxyAuthScheme is set to authNtlm (4), NTLM authentication will be used.

For security reasons, setting this property will clear the values of ProxyUser and ProxyPassword.

Data Type

Integer

ProxyAutoDetect Property (GoogleDrive Class)

This property tells the class whether or not to automatically detect and use proxy system settings, if available.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxyAutoDetect();
int SetProxyAutoDetect(int bProxyAutoDetect);

Unicode (Windows)
BOOL GetProxyAutoDetect();
INT SetProxyAutoDetect(BOOL bProxyAutoDetect);

int cloudstorage_googledrive_getproxyautodetect(void* lpObj);
int cloudstorage_googledrive_setproxyautodetect(void* lpObj, int bProxyAutoDetect);

bool GetProxyAutoDetect();
int SetProxyAutoDetect(bool bProxyAutoDetect);

Default Value

FALSE

Remarks

This property tells the class whether or not to automatically detect and use proxy system settings, if available. The default value is false.

Data Type

Boolean

ProxyPassword Property (GoogleDrive Class)

This property contains a password if authentication is to be used for the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProxyPassword();
int SetProxyPassword(const char* lpszProxyPassword);

Unicode (Windows)
LPWSTR GetProxyPassword();
INT SetProxyPassword(LPCWSTR lpszProxyPassword);

char* cloudstorage_googledrive_getproxypassword(void* lpObj);
int cloudstorage_googledrive_setproxypassword(void* lpObj, const char* lpszProxyPassword);

QString GetProxyPassword();
int SetProxyPassword(QString qsProxyPassword);

Default Value

""

Remarks

This property contains a password if authentication is to be used for the proxy.

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If ProxyAuthScheme is set to Digest Authentication, the ProxyUser and ProxyPassword properties are used to respond to the Digest Authentication challenge from the server.

If ProxyAuthScheme is set to NTLM Authentication, the ProxyUser and ProxyPassword properties are used to authenticate through NTLM negotiation.

Data Type

String

ProxyPort Property (GoogleDrive Class)

This property contains the Transmission Control Protocol (TCP) port for the proxy Server (default 80).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxyPort();
int SetProxyPort(int iProxyPort);

Unicode (Windows)
INT GetProxyPort();
INT SetProxyPort(INT iProxyPort);

int cloudstorage_googledrive_getproxyport(void* lpObj);
int cloudstorage_googledrive_setproxyport(void* lpObj, int iProxyPort);

int GetProxyPort();
int SetProxyPort(int iProxyPort);

Default Value

80

Remarks

This property contains the Transmission Control Protocol (TCP) port for the proxy ProxyServer (default 80). See the description of the ProxyServer property for details.

Data Type

Integer

ProxyServer Property (GoogleDrive Class)

If a proxy Server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProxyServer();
int SetProxyServer(const char* lpszProxyServer);

Unicode (Windows)
LPWSTR GetProxyServer();
INT SetProxyServer(LPCWSTR lpszProxyServer);

char* cloudstorage_googledrive_getproxyserver(void* lpObj);
int cloudstorage_googledrive_setproxyserver(void* lpObj, const char* lpszProxyServer);

QString GetProxyServer();
int SetProxyServer(QString qsProxyServer);

Default Value

""

Remarks

If a proxy ProxyServer is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

If the ProxyServer property is set to a domain name, a DNS request is initiated. Upon successful termination of the request, the ProxyServer property is set to the corresponding address. If the search is not successful, an error is returned.

Data Type

String

ProxySSL Property (GoogleDrive Class)

This property determines when to use a Secure Sockets Layer (SSL) for the connection to the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxySSL();
int SetProxySSL(int iProxySSL);

Unicode (Windows)
INT GetProxySSL();
INT SetProxySSL(INT iProxySSL);

PS_AUTOMATIC(0), 
PS_ALWAYS(1), 
PS_NEVER(2), 
PS_TUNNEL(3)

int cloudstorage_googledrive_getproxyssl(void* lpObj);
int cloudstorage_googledrive_setproxyssl(void* lpObj, int iProxySSL);

int GetProxySSL();
int SetProxySSL(int iProxySSL);

Default Value

0

Remarks

This property determines when to use a Secure Sockets Layer (SSL) for the connection to the proxy. The applicable values are as follows:

Data Type

Integer

ProxyUser Property (GoogleDrive Class)

This property contains a username if authentication is to be used for the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProxyUser();
int SetProxyUser(const char* lpszProxyUser);

Unicode (Windows)
LPWSTR GetProxyUser();
INT SetProxyUser(LPCWSTR lpszProxyUser);

char* cloudstorage_googledrive_getproxyuser(void* lpObj);
int cloudstorage_googledrive_setproxyuser(void* lpObj, const char* lpszProxyUser);

QString GetProxyUser();
int SetProxyUser(QString qsProxyUser);

Default Value

""

Remarks

This property contains a username if authentication is to be used for the proxy.

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword properties are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If ProxyAuthScheme is set to Digest Authentication, the ProxyUser and ProxyPassword properties are used to respond to the Digest Authentication challenge from the server.

If ProxyAuthScheme is set to NTLM Authentication, the ProxyUser and ProxyPassword properties are used to authenticate through NTLM negotiation.

Data Type

String

QueryParamCount Property (GoogleDrive Class)

The number of records in the QueryParam arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetQueryParamCount();
int SetQueryParamCount(int iQueryParamCount);

Unicode (Windows)
INT GetQueryParamCount();
INT SetQueryParamCount(INT iQueryParamCount);

int cloudstorage_googledrive_getqueryparamcount(void* lpObj);
int cloudstorage_googledrive_setqueryparamcount(void* lpObj, int iQueryParamCount);

int GetQueryParamCount();
int SetQueryParamCount(int iQueryParamCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• QueryParamName
• QueryParamValue

The array indices start at 0 and end at QueryParamCount - 1.

This property is not available at design time.

Data Type

Integer

QueryParamName Property (GoogleDrive Class)

The name of the query parameter.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetQueryParamName(int iQueryParamIndex);
int SetQueryParamName(int iQueryParamIndex, const char* lpszQueryParamName);

Unicode (Windows)
LPWSTR GetQueryParamName(INT iQueryParamIndex);
INT SetQueryParamName(INT iQueryParamIndex, LPCWSTR lpszQueryParamName);

char* cloudstorage_googledrive_getqueryparamname(void* lpObj, int queryparamindex);
int cloudstorage_googledrive_setqueryparamname(void* lpObj, int queryparamindex, const char* lpszQueryParamName);

QString GetQueryParamName(int iQueryParamIndex);
int SetQueryParamName(int iQueryParamIndex, QString qsQueryParamName);

Default Value

""

Remarks

The name of the query parameter.

This property specifies the name of the query parameter.

The QueryParamIndex parameter specifies the index of the item in the array. The size of the array is controlled by the QueryParamCount property.

This property is not available at design time.

Data Type

String

QueryParamValue Property (GoogleDrive Class)

The value of the query parameter.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetQueryParamValue(int iQueryParamIndex);
int SetQueryParamValue(int iQueryParamIndex, const char* lpszQueryParamValue);

Unicode (Windows)
LPWSTR GetQueryParamValue(INT iQueryParamIndex);
INT SetQueryParamValue(INT iQueryParamIndex, LPCWSTR lpszQueryParamValue);

char* cloudstorage_googledrive_getqueryparamvalue(void* lpObj, int queryparamindex);
int cloudstorage_googledrive_setqueryparamvalue(void* lpObj, int queryparamindex, const char* lpszQueryParamValue);

QString GetQueryParamValue(int iQueryParamIndex);
int SetQueryParamValue(int iQueryParamIndex, QString qsQueryParamValue);

Default Value

""

Remarks

The value of the query parameter.

This property specifies the value of the query parameter. The class will automatically URL-encode this value when sending the request.

The QueryParamIndex parameter specifies the index of the item in the array. The size of the array is controlled by the QueryParamCount property.

This property is not available at design time.

Data Type

String

ResourceData Property (GoogleDrive Class)

The data that was downloaded, or that should be uploaded.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResourceData(char* &lpResourceData, int &lenResourceData);
int SetResourceData(const char* lpResourceData, int lenResourceData);

Unicode (Windows)
INT GetResourceData(LPSTR &lpResourceData, INT &lenResourceData);
INT SetResourceData(LPCSTR lpResourceData, INT lenResourceData);

int cloudstorage_googledrive_getresourcedata(void* lpObj, char** lpResourceData, int* lenResourceData);
int cloudstorage_googledrive_setresourcedata(void* lpObj, const char* lpResourceData, int lenResourceData);

QByteArray GetResourceData();
int SetResourceData(QByteArray qbaResourceData);

Default Value

""

Remarks

This property is populated with file data after calling DownloadFile if SetDownloadStream and LocalFile are not set.

This property can also be set before calling UploadFile; its data will be uploaded if SetUploadStream and LocalFile are not set.

This property is not available at design time.

Data Type

Binary String

ResourceMarker Property (GoogleDrive Class)

A marker indicating what page of resources to return next.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceMarker();
int SetResourceMarker(const char* lpszResourceMarker);

Unicode (Windows)
LPWSTR GetResourceMarker();
INT SetResourceMarker(LPCWSTR lpszResourceMarker);

char* cloudstorage_googledrive_getresourcemarker(void* lpObj);
int cloudstorage_googledrive_setresourcemarker(void* lpObj, const char* lpszResourceMarker);

QString GetResourceMarker();
int SetResourceMarker(QString qsResourceMarker);

Default Value

""

Remarks

This property will be populated when ListResources is called if the results are paged and there are more pages. To list all resources, continue to call ListResources until this property returns empty string.

Refer to ListResources for more information.

Note that resources are never paged when calling ListParents or GetResourceInfo.

This property is not available at design time.

Data Type

String

ResourceCount Property (GoogleDrive Class)

The number of records in the Resource arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResourceCount();
int SetResourceCount(int iResourceCount);

Unicode (Windows)
INT GetResourceCount();
INT SetResourceCount(INT iResourceCount);

int cloudstorage_googledrive_getresourcecount(void* lpObj);
int cloudstorage_googledrive_setresourcecount(void* lpObj, int iResourceCount);

int GetResourceCount();
int SetResourceCount(int iResourceCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• ResourceContentAccessible
• ResourceCreatedTime
• ResourceDescription
• ResourceExtension
• ResourceId
• ResourceMD5Checksum
• ResourceMIMEType
• ResourceModifiedTime
• ResourceName
• ResourceOriginalName
• ResourceOwner
• ResourceOwnerEmail
• ResourceParentIds
• ResourceSharedDriveId
• ResourceSize
• ResourceStarred
• ResourceTrashed
• ResourceType
• ResourceViewed
• ResourceViewLink

The array indices start at 0 and end at ResourceCount - 1.

This property is not available at design time.

Data Type

Integer

ResourceContentAccessible Property (GoogleDrive Class)

Whether the resource's content is accessible to less-privileged users.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResourceContentAccessible(int iResourceIndex);
int SetResourceContentAccessible(int iResourceIndex, int bResourceContentAccessible);

Unicode (Windows)
BOOL GetResourceContentAccessible(INT iResourceIndex);
INT SetResourceContentAccessible(INT iResourceIndex, BOOL bResourceContentAccessible);

int cloudstorage_googledrive_getresourcecontentaccessible(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcecontentaccessible(void* lpObj, int resourceindex, int bResourceContentAccessible);

bool GetResourceContentAccessible(int iResourceIndex);
int SetResourceContentAccessible(int iResourceIndex, bool bResourceContentAccessible);

Default Value

FALSE

Remarks

Whether the resource's content is accessible to less-privileged users.

This property indicates whether the resource's content is accessible. If the resource is not accessible, it cannot be copied, downloaded, or printed by a users unless they have at least "writer" permissions.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

Boolean

ResourceCreatedTime Property (GoogleDrive Class)

The creation date of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceCreatedTime(int iResourceIndex);
int SetResourceCreatedTime(int iResourceIndex, const char* lpszResourceCreatedTime);

Unicode (Windows)
LPWSTR GetResourceCreatedTime(INT iResourceIndex);
INT SetResourceCreatedTime(INT iResourceIndex, LPCWSTR lpszResourceCreatedTime);

char* cloudstorage_googledrive_getresourcecreatedtime(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcecreatedtime(void* lpObj, int resourceindex, const char* lpszResourceCreatedTime);

QString GetResourceCreatedTime(int iResourceIndex);
int SetResourceCreatedTime(int iResourceIndex, QString qsResourceCreatedTime);

Default Value

""

Remarks

The creation date of the resource.

This property holds a DateTime string representing the creation date of the resource. This is a combined date-time value (formatted according to RFC 3339).

Note that while this property is writable, the class only uses it as input when UploadFile is called; it is ignored when calling UpdateResource.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceDescription Property (GoogleDrive Class)

A short description of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceDescription(int iResourceIndex);
int SetResourceDescription(int iResourceIndex, const char* lpszResourceDescription);

Unicode (Windows)
LPWSTR GetResourceDescription(INT iResourceIndex);
INT SetResourceDescription(INT iResourceIndex, LPCWSTR lpszResourceDescription);

char* cloudstorage_googledrive_getresourcedescription(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcedescription(void* lpObj, int resourceindex, const char* lpszResourceDescription);

QString GetResourceDescription(int iResourceIndex);
int SetResourceDescription(int iResourceIndex, QString qsResourceDescription);

Default Value

""

Remarks

A short description of the resource.

This property specifies a short description of the resource.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceExtension Property (GoogleDrive Class)

The file extension of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceExtension(int iResourceIndex);

Unicode (Windows)
LPWSTR GetResourceExtension(INT iResourceIndex);

char* cloudstorage_googledrive_getresourceextension(void* lpObj, int resourceindex);

QString GetResourceExtension(int iResourceIndex);

Default Value

""

Remarks

The file extension of the resource.

This property indicates the file extension of the resource. It cannot be set, and is empty for folder resources. To specify the extension when creating a new file resource include it when calling UploadFile.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

String

ResourceId Property (GoogleDrive Class)

The Id of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceId(int iResourceIndex);
int SetResourceId(int iResourceIndex, const char* lpszResourceId);

Unicode (Windows)
LPWSTR GetResourceId(INT iResourceIndex);
INT SetResourceId(INT iResourceIndex, LPCWSTR lpszResourceId);

char* cloudstorage_googledrive_getresourceid(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourceid(void* lpObj, int resourceindex, const char* lpszResourceId);

QString GetResourceId(int iResourceIndex);
int SetResourceId(int iResourceIndex, QString qsResourceId);

Default Value

""

Remarks

The Id of the resource.

This property holds the Id of the resource.

This property must be set before calling UpdateResource.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceMD5Checksum Property (GoogleDrive Class)

The MD5 checksum of the file resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceMD5Checksum(int iResourceIndex);

Unicode (Windows)
LPWSTR GetResourceMD5Checksum(INT iResourceIndex);

char* cloudstorage_googledrive_getresourcemd5checksum(void* lpObj, int resourceindex);

QString GetResourceMD5Checksum(int iResourceIndex);

Default Value

""

Remarks

The MD5 checksum of the file resource.

This property holds the MD5 checksum of the resource, if it is a file resource.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

String

ResourceMIMEType Property (GoogleDrive Class)

The MIME type of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceMIMEType(int iResourceIndex);
int SetResourceMIMEType(int iResourceIndex, const char* lpszResourceMIMEType);

Unicode (Windows)
LPWSTR GetResourceMIMEType(INT iResourceIndex);
INT SetResourceMIMEType(INT iResourceIndex, LPCWSTR lpszResourceMIMEType);

char* cloudstorage_googledrive_getresourcemimetype(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcemimetype(void* lpObj, int resourceindex, const char* lpszResourceMIMEType);

QString GetResourceMIMEType(int iResourceIndex);
int SetResourceMIMEType(int iResourceIndex, QString qsResourceMIMEType);

Default Value

""

Remarks

The MIME type of the resource.

This property specifies the MIME type of the resource.

When calling UploadFile, this property is ignored in favor of the MimeType parameter of UploadFile.

When calling UpdateResource, this property is only submitted if new file data is being uploaded.

Some Google Drive MIME types:

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceModifiedTime Property (GoogleDrive Class)

The last modified date of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceModifiedTime(int iResourceIndex);
int SetResourceModifiedTime(int iResourceIndex, const char* lpszResourceModifiedTime);

Unicode (Windows)
LPWSTR GetResourceModifiedTime(INT iResourceIndex);
INT SetResourceModifiedTime(INT iResourceIndex, LPCWSTR lpszResourceModifiedTime);

char* cloudstorage_googledrive_getresourcemodifiedtime(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcemodifiedtime(void* lpObj, int resourceindex, const char* lpszResourceModifiedTime);

QString GetResourceModifiedTime(int iResourceIndex);
int SetResourceModifiedTime(int iResourceIndex, QString qsResourceModifiedTime);

Default Value

""

Remarks

The last modified date of the resource.

This property holds a DateTime string representing the last modified date of the resource. This is a combined date-time value (formatted according to RFC 3339).

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceName Property (GoogleDrive Class)

The name of the resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceName(int iResourceIndex);
int SetResourceName(int iResourceIndex, const char* lpszResourceName);

Unicode (Windows)
LPWSTR GetResourceName(INT iResourceIndex);
INT SetResourceName(INT iResourceIndex, LPCWSTR lpszResourceName);

char* cloudstorage_googledrive_getresourcename(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcename(void* lpObj, int resourceindex, const char* lpszResourceName);

QString GetResourceName(int iResourceIndex);
int SetResourceName(int iResourceIndex, QString qsResourceName);

Default Value

""

Remarks

The name of the resource.

This property specifies the name of the resource.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceOriginalName Property (GoogleDrive Class)

The original name of the file resource.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceOriginalName(int iResourceIndex);

Unicode (Windows)
LPWSTR GetResourceOriginalName(INT iResourceIndex);

char* cloudstorage_googledrive_getresourceoriginalname(void* lpObj, int resourceindex);

QString GetResourceOriginalName(int iResourceIndex);

Default Value

""

Remarks

The original name of the file resource.

This property specifies the original name of a file resource if the file was uploaded manually, or if the name was set programmatically through the API.

Updating ResourceName will not change this value.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

String

ResourceOwner Property (GoogleDrive Class)

The name of the resource's owner.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceOwner(int iResourceIndex);

Unicode (Windows)
LPWSTR GetResourceOwner(INT iResourceIndex);

char* cloudstorage_googledrive_getresourceowner(void* lpObj, int resourceindex);

QString GetResourceOwner(int iResourceIndex);

Default Value

""

Remarks

The name of the resource's owner.

This property holds the name of resource's owner.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

String

ResourceOwnerEmail Property (GoogleDrive Class)

The email address of the resource's owner.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceOwnerEmail(int iResourceIndex);

Unicode (Windows)
LPWSTR GetResourceOwnerEmail(INT iResourceIndex);

char* cloudstorage_googledrive_getresourceowneremail(void* lpObj, int resourceindex);

QString GetResourceOwnerEmail(int iResourceIndex);

Default Value

""

Remarks

The email address of the resource's owner.

This property holds the email address of the resource's owner.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

String

ResourceParentIds Property (GoogleDrive Class)

The Ids of the resource's parent folders.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceParentIds(int iResourceIndex);
int SetResourceParentIds(int iResourceIndex, const char* lpszResourceParentIds);

Unicode (Windows)
LPWSTR GetResourceParentIds(INT iResourceIndex);
INT SetResourceParentIds(INT iResourceIndex, LPCWSTR lpszResourceParentIds);

char* cloudstorage_googledrive_getresourceparentids(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourceparentids(void* lpObj, int resourceindex, const char* lpszResourceParentIds);

QString GetResourceParentIds(int iResourceIndex);
int SetResourceParentIds(int iResourceIndex, QString qsResourceParentIds);

Default Value

""

Remarks

The Ids of the resource's parent folders.

This property holds a comma-separated list of Ids for the resource's parent folders.

Note that while this property is writable, the class only uses it as input when UploadFile is called. To modify a resource's parents in any other case, use the AddParents, RemoveParents, and MoveResource methods.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

String

ResourceSharedDriveId Property (GoogleDrive Class)

The Id of the shared drive the resource is in.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResourceSharedDriveId(int iResourceIndex);

Unicode (Windows)
LPWSTR GetResourceSharedDriveId(INT iResourceIndex);

char* cloudstorage_googledrive_getresourceshareddriveid(void* lpObj, int resourceindex);

QString GetResourceSharedDriveId(int iResourceIndex);

Default Value

""

Remarks

The Id of the shared drive the resource is in.

This property holds the Id of the shared drive that the resource is in, if applicable.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

String

ResourceSize Property (GoogleDrive Class)

The size of the file resource in bytes.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetResourceSize(int iResourceIndex);

Unicode (Windows)
LONG64 GetResourceSize(INT iResourceIndex);

int64 cloudstorage_googledrive_getresourcesize(void* lpObj, int resourceindex);

qint64 GetResourceSize(int iResourceIndex);

Default Value

0

Remarks

The size of the file resource in bytes.

This property holds the size of a file resource in bytes. This is only applicable to files.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is read-only and not available at design time.

Data Type

Long64

ResourceStarred Property (GoogleDrive Class)

Whether the resource is starred.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResourceStarred(int iResourceIndex);
int SetResourceStarred(int iResourceIndex, int bResourceStarred);

Unicode (Windows)
BOOL GetResourceStarred(INT iResourceIndex);
INT SetResourceStarred(INT iResourceIndex, BOOL bResourceStarred);

int cloudstorage_googledrive_getresourcestarred(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcestarred(void* lpObj, int resourceindex, int bResourceStarred);

bool GetResourceStarred(int iResourceIndex);
int SetResourceStarred(int iResourceIndex, bool bResourceStarred);

Default Value

FALSE

Remarks

Whether the resource is starred.

This property indicates whether the resource is starred by the current user.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

Boolean

ResourceTrashed Property (GoogleDrive Class)

Whether the resource is in the trash.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResourceTrashed(int iResourceIndex);
int SetResourceTrashed(int iResourceIndex, int bResourceTrashed);

Unicode (Windows)
BOOL GetResourceTrashed(INT iResourceIndex);
INT SetResourceTrashed(INT iResourceIndex, BOOL bResourceTrashed);

int cloudstorage_googledrive_getresourcetrashed(void* lpObj, int resourceindex);
int cloudstorage_googledrive_setresourcetrashed(void* lpObj, int resourceindex, int bResourceTrashed);

bool GetResourceTrashed(int iResourceIndex);
int SetResourceTrashed(int iResourceIndex, bool bResourceTrashed);

Default Value

FALSE

Remarks

Whether the resource is in the trash.

This property indicates whether the resource has been moved to trash.

Note that while this property is writable, the class only uses it as input when UpdateResource is called; it is ignored when calling UploadFile.

The ResourceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ResourceCount property.

This property is not available at design time.

Data Type

Boolean

ResourceType Property (GoogleDrive Class)

The resource's type.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResourceType(int iResourceIndex);

Unicode (Windows)
INT GetResourceType(INT iResourceIndex);

GDRT_FILE(0), 
GDRT_FOLDER(1)

int cloudstorage_googledrive_getresourcetype(void* lpObj, int resourceindex);

int GetResourceType(int iResourceIndex);

Default Value

0

Remarks

The resource's type.

This property indicates whether the resource is a folder or a file. Possible values are: