Google Cloud Storage

Create a bucket on Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to create a bucket in GCS in a specific location and storage class. The location identifies the geographical position of the bucket around the world. For more information see:

pageGoogle Cloud Storage

The storage class defines how fast will be the file retrieval. For more information see:

pageGoogle Cloud Storage

Be aware that the bucket name must be unique at Google level and must contain only letters and - (no underscore symbols), so it would be a good practice to use composed names starting with the googleprojectname-applicationame-somethingelse.

Syntax

var descriptor = utils.createGoogleCloudStorageBucket(
   project, 
   bucketName, 
   bucketLocation,
   storageClass
);

Description

Argument	Description
project	String: Google project name
bucketName	String: Google level unique name; use only letters and - as separator
bucketLocation	String: identifies the geographical position where creating the bucket; allowed values are: US, EU, ASIA. Other locations are supported. See https://cloud.google.com/storage/docs/bucket-locations
storageClass	String (optional - storage class: STANDARD, NEARLINE and DURABLE_REDUCED_AVAILABILITY. See https://cloud.google.com/storage/docs/storage-classes
returned value	in case of errors, an exception fill be fired; the returned value is a javascript object having the following structure: { name: "...", // bucket name type: "...", // bucket type versioned: true|false }

Get the bucket descriptor from Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to get the description of an already existing bucket in GCS.

Syntax

var descriptor = utils.getGoogleCloudStorageBucket(bucketName);

Description

Argument	Description
bucketName	String: Google level unique name; use only letters and - as separator
returned value	in case of errors, an exception fill be fired; the returned value is a javascript object having the following structure: { name: "...", // bucket name type: "...", // bucket type versioned: true|false }

Get the file descriptor from Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to get the description of an already existing file stored inside a Google Cloud Storage bucket.

Syntax

var descriptor = utils.getGoogleCloudStorageObject(bucketName,objectName);

Description

Argument	Description
bucketName	String: bucket name where the file to analyze is located
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"
returned value	in case of errors, an exception fill be fired; the returned value is a javascript object having the following structure: { id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content }

Get a public (temporary) URL for accessing a Cloud Storage file

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to generate a public URL to access from anywhere an already existing file stored inside a Google Cloud Storage bucket.

Syntax

var urlString = utils.getGoogleCloudStorageSignedURL(
   verb, 
   expiration, 
   bucketName, 
   objectName, 
   mime
);

Description

Argument	Description
verb	String: HTTP method to use to get the file; set it to "GET"
expiration	long: URL expiration time, expressed in milliseconds; for example, to set an URL valid for the next 10 minutes, set it to: new Date().getTime() + (10*60*1000)
bucketName	String: bucket name where the already existing file is located
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"
mime	String (optional): mime type for the file to get; you can set it null
returned value	a String value representing the public URL to download or show the file

Download on the Platform server file system a file stored in Google Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to download an already existing file stored inside a Google Cloud Storage bucket and save it locally, on Platform server file system.

Syntax

utils.downloadGoogleCloudStorageObject(
   bucketName, 
   objectName, 
   destPath
);

Description

Argument	Description
bucketName	String: bucket name where the file to download is located
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"
destPath	String: the absolute path + file name representing the file to save on the Platform server file system; e.g. utils.getDirectoryParth(dirId)+"/myfile.txt"

It fires and exception in case of errors.

Get a paginated list of files stored in the specified bucket of Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to get a paginated list of files stored inside a Google Cloud Storage bucket. The list does NOT contain the files, but only file descriptors (helpful to fetch a specific file later).

Syntax

var response = utils.listGoogleCloudStorageObjects(
     bucketName, 
     maxPageResults, 
     pages, 
     nextPageToken, 
     prefix, 
     delimiter
  )

Description

Argument	Description
bucketName	String: bucket name where reading files
maxPageResults	long: total number of file descriptors to fetch; e.g. reqParams.limit
pages	int: represents the number of pages already read
nextPageToken	the token returned by the previous invocation of this method, used byCloud Storage API to fetch the next block of data (see the "response" object)
prefix	String (optional) - it allows to filter the list according to the file names prefix; for more details see: https://cloud.google.com/storage/docs/json_api/v1/objects/list
delimiter	String: returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.
returned value	this function returns a javascript object having the following structure: { nextPageToken: "...", // token to use for the next invocation of this function // (to get the next block of data) list: [{ id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content },{.... ] }

Get the whole list of files stored in the specified bucket of Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to get a the whole list of files stored inside a Google Cloud Storage bucket. The list does NOT contain the files, but only file descriptors (helpful to fetch a specific file later).

Syntax

var list = utils.listGoogleCloudStorageObjects(
     bucketName, 
     prefix, 
     delimiter
  )

Description

Argument	Description
bucketName	String: bucket name where reading files
prefix	String (optional) - it allows to filter the list according to the file names prefix; for more details see: https://cloud.google.com/storage/docs/json_api/v1/objects/list
delimiter	String: returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.
returned value	this function returns a list of javascript objects, having the following structure: [{ id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content },{.... ]

Upload a file saved on Platform server file system to the specified bucket of Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to upload an already existing file stored on Platform server file system and save it on a Google Cloud Storage bucket.

Syntax

var descriptor = utils.uploadGoogleCloudStorageObjectFromFS(
   fsPath, 
   bucketName, 
   objectName,
   deleteFsFile
);

Description

Argument	Description
fsPath	absolute path + file name in the Platform server file system, where the file to upload is located
bucketName	String: bucket name where saving the file to upload
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"; in the seconda case, the relative path is automatically "created" by Cloud Storage if not existing yet
deleteFsFile	boolean: true to auto delete the original file from Platform server file system, after the upload was completed successfully
returned value	this function returns a javascript object representing the file just uploaded: { id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content }

Important note: the file visibility is inherited by the bucket: if the bucket has been defined as "£public" the uploaded file will be as well.

Upload a file saved on Platform server file system to the specified bucket of Cloud Storage and make it public

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to upload an already existing file stored on Platform server file system and save it on a Google Cloud Storage bucket and make it public, i.e. accessible by any device, without any authentication.

Syntax

var descriptor = utils.uploadGoogleCloudStoragePublicObjectFromFS(
   fsPath, 
   bucketName, 
   objectName,
   deleteFsFile
);

Description

Argument	Description
fsPath	absolute path + file name in the Platform server file system, where the file to upload is located
bucketName	String: bucket name where saving the file to upload
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"; in the seconda case, the relative path is automatically "created" by Cloud Storage if not existing yet
deleteFsFile	boolean: true to auto delete the original file from Platform server file system, after the upload was completed successfully
returned value	this function returns a javascript object representing the file just uploaded: { id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content }

Important note: the file visibility is always public, independently on the bucket settings.

Create a text file on a specified bucket of Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to create on the fly a text file and upload it on a Google Cloud Storage bucket, without the need for a physical file stored on Platform server file system.

Important note: do NOT use this method to create on the fly very large text files, since this would consume a large amount of memory on Platform server; use it only for kbytes size files.

Syntax

var descriptor = utils.uploadGoogleCloudStorageObjectFromString(
  textContent, 
  bucketName, 
  objectName,
  contentType
);

Description

Argument	Description
textContent	the text to include in the file to create on Cloud Storage
bucketName	String: bucket name where saving the file to upload
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"; in the seconda case, the relative path is automatically "created" by Cloud Storage if not existing yet
contextType	String: mime type to use for the text file; e.g. "text/plain" or "text/csv" or "text/html"
returned value	this function returns a javascript object representing the file just uploaded: { id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content }

Important note: the file visibility is inherited by the bucket: if the bucket has been defined as "£public" the uploaded file will be as well.

Create a text file on a specified bucket of Cloud Storage and make it public

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to create on the fly a text file and upload it on a Google Cloud Storage bucket, without the need for a physical file stored on Platform server file system and make it public, i.e. accessible by any device, without any authentication.

Important note: do NOT use this method to create on the fly very large text files, since this would consume a large amount of memory on Platform server; use it only for kbytes size files.

Syntax

var descriptor = utils.uploadGoogleCloudStoragePublicObjectFromString(
  textContent, 
  bucketName, 
  objectName,
  contentType
);

Description

Argument	Description
textContent	the text to include in the file to create on Cloud Storage
bucketName	String: bucket name where saving the file to upload
objectName	String: file identifier; in the simplest case, it can be a filename like "a.txt" or the relative path within the bucket, like "subfolder1/subfolder2/a.txt"; in the seconda case, the relative path is automatically "created" by Cloud Storage if not existing yet
contextType	String: mime type to use for the text file; e.g. "text/plain" or "text/csv" or "text/html"
returned value	this function returns a javascript object representing the file just uploaded: { id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content }

Important note: the file visibility is always public, independently on the bucket settings.

Duplicate a file stored in the specified bucket of Cloud Storage

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to duplicate an already existing file stored on a a Google Cloud Storage bucket and save it on the specified bucket with the specified file name; a possibile use of this method is when creating a file from a template file.

Syntax

var descriptor = utils.copyGoogleCloudStorageObject(
  sourceBucketName, 
  sourceObjectName,
  sourceObjectVersion, 
  destinationBucketName, 
  destinationObjectName
);

Description

Argument	Description
sourceBucketName	String: bucket name where the already existing file to copy is located
sourceObjectName	String: file name (with relative path if needed) of the file to copy
sourceObjectVersion	String (optional); in case of a versioned file, the version to copy; set it to null if file versioning is not enabled
destinationBucketName	String: bucket name where saving the duplicated file
destinationObjectName	String: file name for the file to create as a duplication of the first one
returned value	this function returns a javascript object representing the file just uploaded: { id: "...", // file identifier title: "...", // file name mimeType: "...", // mime type for the file pathType: "GCS", size: ..., // file size md5hash: "...", // hash key representing the file content }

Change accessibility for a Cloud Storage file to public or private

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to change the access policy for an already existing file stored on a a Google Cloud Storage bucket and make it public or private.

Syntax

utils.setPublicLink(bucketName, objectName, publicLink)

Description

Argument	Description
bucketName	String: bucket name where the already existing file is located
objectName	String: file name (with relative path if needed) of the file
publicLink	boolean: true to set it as public, false to set it as private

This method will fire and exception in case of errors.

Delete a Google Cloud Storage file

Before using this function, the GCP project must be set up correctly, i.e. you have to specify at global parameters level:

• GOOGLE

  • Google: Service Account Email

  • Google: Service Account Key

• FILE UPLOAD

  • Google Cloud Storage Location (US, EU, ASIA)

  • Google Project Id

Once done that, you can start using the Google Cloud Storage (GCS) service.

The current javascript function allows to delete a file from a bucket.

Syntax

utils.deleteGoogleCloudStorageObject(String bucketName, String objectName)

Description

Argument	Description
bucketName	String: bucket name where the already existing file is located
objectName	String: file name (with relative path if needed) of the file to delete

This method will fire and exception in case of errors.