ThomasPohl / ioBroker.google-spreadsheet

Adapter for ioBroker to automatically interact with google spreadsheets
Apache License 2.0
4 stars 1 forks source link
google iobroker spreadsheet

Logo

ioBroker.google-spreadsheet

NPM version Downloads Number of Installations Current version in stable repository

NPM

Tests: Test and Release

google-spreadsheet adapter for ioBroker

This adapter can be used to automatically interact with google spreadsheets.

Features

Usage

Setup

Enable API Access

  1. Visit the Google Cloud Console.

  2. Create or select an existing project that you wish to use with the API.

  3. Enable the Google Spreadsheet API for your project.

Create a Service Account

For the project you selected in the previous step, create a new service account in Google Cloud IAM by following these steps:

  1. Navigate to the IAM & Admin page in the Google Cloud Console.

  2. Click on "Service accounts" and then "Create Service Account."

  3. Provide a name for the service account and select the role "Project" > "Editor."

  4. Click "Continue" to proceed to the next step.

  5. On the "Keys" tab, click "Create Key" and choose the format as "JSON." Then click "Continue."

  6. Your private key will be generated and automatically downloaded. Keep this file secure as you will need it later.

Grant Access to the Spreadsheet

Open the spreadsheet you want to interact with and share it with the email address of your newly created service account:

  1. Open the desired spreadsheet in Google Sheets.

  2. Click "Share" in the upper right corner.

  3. Enter the email address of the service account in the "Add people" field and grant it the necessary permissions (e.g., "Edit" or "View").

  4. Click "Send" to complete the sharing process.

Configure the Adapter Instance

Add the following information to the configuration of your adapter instance in ioBroker:

Settings

Find the Spreadsheet ID in the URL

To locate the "Spreadsheet ID" in the URL of your Google Sheets document, follow these steps:

  1. When you open your Google Sheets document in a web browser, the URL in the address bar will look something like this:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit
  1. The "SPREADSHEET_ID" is the long string of characters and numbers between the "/d/" and "/edit" parts of the URL.

Blockly

Use the available blocks to automatically interact with your spreadsheet.

Blockly

Troubleshooting

Error while sending data to Google Spreadsheet:Error: error:0909006C:PEM routines:get_name:no start line

When copying the private key into the configuration, make sure there are no \n. If there are \n in the key, please replace the with normal line breaks

Error while sending data to Google Spreadsheet:Error: The caller does not have permission

Make sure the Service Account has adequate permissions to write to the spreadsheet. Refer to the "Grant Access to the Spreadsheet" section above.

Changelog

0.4.0

0.1.0

License

Copyright (c) 2024 Thomas Pohl

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.