This is the Google Data Studio Connector implemented to retrieve data from the ISTAC API (Recursos Estructurales).
The connector is written in Apps Script.
To be able to work in this project you just need to pull the code from the repository and have [Clasp](https://developers.google.com/apps-script/Google Clouddes/clasp "Google documentation") installed on your system.
Once you have installed Clasp from the src
directory you have to run:
clasp login
Now you can push code with your changes to Google by running:
clasp push
Once you have develop something and you want to try it you have to push it and the connector will be in the Latest Version(Head).
When the development version is ready for release, the production deployment will be in the Production deployment
You could also get this url by editing the project in the G Suite Developer Hub. Then click in Publish --> Publish from manifest
. You can check the documentation.
To debug the connector you can put console.logs in the code, then you can see the logs in https://script.google.com/home/projects/ID_OF_THE_SCRIPT/executions (that's all I got for the moment), for example, you can see the logs for this connector in here.
In Google Data Studio you can create version of your coda that consists in numbered shanpshots of your code. Which allows users to continue using the versioned connector while developers can keep coding. You can see more information in the documentation.
To create a version you have to go to File --> Manage versions
and create a new one with a descriptive name. You could also create a new version with clasp by running from src/
:
clasp version NAME_OF_THE_VERSION
You can list all the versions with:
clasp versions
Once you have the version you can make a versioned deployment. You can do it with clasp or with the Google Cloud.
You can deploy the new connector with:
clasp deploy [version] [description]
And list the deployments with:
clasp deployments
You can find out more information about this in the clasp documentation
To deploy a new version from the Google Cloud you have to go to edit the script. Then you go to Publish --> Publish from manifest
and Create a new one. You give it a name and a version and save it. Then you will have the new url.
You can find out more information in the documentation.
This project is configured with the Jest framework for testing. You can execute the test by running:
yarn test
The project is also configured to see the coverage of the testing. You can see it by running:
yarn coverage