https://github.com/eDatos/istacGDSdatasets
Google Data Studio connector for accessing statistic tables distributed through the API of the Canary Islands Data Infrastructure and Statistical Metadata (eDatos)
https://github.com/eDatos/istacGDSdatasets
api api-client data data-connectors data-science google google-data-studio official-statistics open-data statistics
Last synced: about 6 hours ago
JSON representation
Google Data Studio connector for accessing statistic tables distributed through the API of the Canary Islands Data Infrastructure and Statistical Metadata (eDatos)
- Host: GitHub
- URL: https://github.com/eDatos/istacGDSdatasets
- Owner: eDatos
- License: agpl-3.0
- Created: 2020-03-05T08:52:35.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T12:35:38.000Z (over 3 years ago)
- Last Synced: 2024-07-30T19:42:23.137Z (almost 2 years ago)
- Topics: api, api-client, data, data-connectors, data-science, google, google-data-studio, official-statistics, open-data, statistics
- Language: JavaScript
- Homepage: https://datos.canarias.es/api/estadisticas/statistical-resources/v1.0/
- Size: 394 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-canarias - istacGDSdatasets - square&label=%E2%AD%90)](https://github.com/eDatos/istacGDSdatasets/stargazers) [](https://github.com/eDatos/istacGDSdatasets/commits/master) [](https://github.com/eDatos/istacGDSdatasets) [](https://github.com/eDatos/istacGDSdatasets/blob/master/LICENSE) [](https://www.gobiernodecanarias.org/istac/) - Conector Google Data Studio para tablas estadísticas de la API de la infraestructura eDatos de Canarias. (Datos Abiertos y Estadísticas)
README
# Google Data Studio Connector for Recursos Estadísticos ISTAC
This is the Google Data Studio Connector implemented to retrieve data from the ISTAC API (Recursos Estadisticos).
The connector is written in [Apps Script](https://developers.google.com/apps-script/ "Google documentation").
## Development environmet
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.
### How to work in this project
#### _Authenticate with Clasp_
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```
### How to try the connector
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)](https://datastudio.google.com/datasources/create?connectorId=AKfycbzFJfMdYLJeFpZ6rf5p-h2jHyB0EkjdZSP2t8BGFg "Latest Version").
When the development version is ready for release, the production deployment will be in the [Production deployment](https://datastudio.google.com/datasources/create?connectorId=AKfycbw4sga_3MyB8TOglBoHsI__IVDu0VYssfwKoxaOt2WUdAJJ3JuxdRegkFSWDmC89MI "Production deployment")
You could also get this url by editing the [project](https://script.google.com/home) in the G Suite Developer Hub. Then click in `Publish --> Publish from manifest`. You can check the [documentation](https://developers.google.com/datastudio/connector/use).
### Debugging
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](https://script.google.com/home/projects/17Q9fOWQv2bJMY3coJWIeoMLD2ItOJ04Wd3KswUiALS5C5M6Om5NidcPt/executions).
## Production environment
### How to deploy an versioned deployment
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](https://developers.google.com/apps-script/concepts/deployments).
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.
#### _With Clasp_
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](https://developers.google.com/apps-script/guides/clasp)
#### _With the Google Cloud_
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](https://developers.google.com/datastudio/connector/deploy).
## Testing
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```