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.

PreviousChips panelNextGoogle GSuite

Last updated