![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/ESP32-Publish-Google-sheets.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nTo successfully follow this tutorial, make sure you follow all the next steps in the following order:<\/p>\n\n\n\n
- \n
- Prerequisites<\/a><\/li>\n\n\n\n
- Google Service Account<\/a>\n
- \n
- Create a Service Account<\/a><\/li>\n\n\n\n
- Creating a New Key<\/a><\/li>\n\n\n\n
- Enable Google Sheet API<\/a><\/li>\n\n\n\n
- Enable Google Drive API<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Installing the Arduino Google Sheet Client Library<\/a><\/li>\n\n\n\n
- Creating a Google Spreadsheet<\/a><\/li>\n\n\n\n
- Sharing the Spreadsheet with the Service Account<\/a><\/li>\n\n\n\n
- ESP32 with BME280 Circuit<\/a><\/li>\n\n\n\n
- ESP32 Datalogging to Google Sheets – Arduino Sketch<\/a><\/li>\n<\/ol>\n\n\n\n
Note<\/strong>: we have another tutorial showing how to send data to Google Sheets, but using IFTTT: ESP32 Publish Sensor Readings to Google Sheets (ESP8266 Compatible)<\/a>.<\/p>\n\n\n\n
1. Prerequisites<\/h2>\n\n\n\n
Before following this tutorial, make sure you check the following prerequisites:<\/p>\n\n\n\n
Google Account<\/h3>\n\n\n\n
You need a Google Account to follow this project. If you don’t have a Google account, you can create one <\/a>here.<\/p>\n\n\n\n
ESP32 with Arduino IDE<\/h3>\n\n\n\n
We\u2019ll program the ESP32 board using Arduino IDE. So, make sure you have the ESP32 add-on installed. Follow the next tutorial if you haven\u2019t already:<\/p>\n\n\n\n
- \n
- Install the ESP32 Board in Arduino IDE<\/a><\/li>\n<\/ul>\n\n\n\n
Additionally, make sure you\u2019re running the latest version of the ESP32 add-on. Go to Tools <\/strong>> Board <\/strong>> Boards Manager,<\/strong> search for ESP32, <\/strong>and check that you\u2019re running the latest version.<\/p>\n\n\n\n
2. Google Service Account<\/h2>\n\n\n\n
To log data securely to Google Sheets, we’ll use a Google Service Account. A service account, identified by its unique email address, is a special kind of account. It is typically used by an application or compute workload, like a Compute Engine instance, rather than being associated with a person. You can learn more about a service account<\/a>.<\/p>\n\n\n\n
Create a Google Project<\/h3>\n\n\n\n
You need to create a Google project and associate a Google service account to that specific project. You can do that on your main Google account or you can choose to do that on another secondary account. As always, we recommend that you use another account just for your IoT and ESP32 projects, and not your main account.<\/p>\n\n\n\n
Create a Service Account<\/h4>\n\n\n\n
1. Go to Google Cloud Console<\/a>.<\/p>\n\n\n\n
2. Create a new project or choose an existing project. We’ll show you how to create a new project.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/1-Create-Project.png?resize=992%2C407&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n3. Give a name to your project. Then, click Create.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/2-Google-Cloud-Create-New-Project.png?resize=799%2C591&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYour project will be created successfully.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/3-Google-Cloud-Project-Created.png?resize=799%2C591&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n4. Now, you need to create a service account for that project. At the left sidebar, click on Service accounts<\/strong> and then, click on + Create Service Account<\/strong>.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/4-Create-Service-Account.png?resize=1024%2C555&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n5. Insert a name for your Service account, then click Create and Continue<\/strong>.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/5-Service-Account-Details.png?resize=984%2C584&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n6. Select the service account role. Select Owner<\/strong>. Then, click Continue<\/strong>.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/6-Service-Account-Role.png?resize=984%2C539&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n7. Finally, click Done<\/strong>.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/7-Service-Account-Done.png?resize=800%2C720&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou successfully create a Service Account. Now, you need to create a Key.<\/p>\n\n\n\n
Creating a New Key <\/h4>\n\n\n\n
Select the project, click on the three dots icon, and then click on Manage Keys<\/strong>.<\/p>\n\n\n
\n![\"manage](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/8-Service-Account-Actions.png?resize=1024%2C539&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, create a new key.<\/p>\n\n\n
\n![\"create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/9-Create-new-key.png?resize=847%2C600&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, select JSON <\/strong>and click Create<\/strong>.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/10-Create-new-key-json.png?resize=554%2C349&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThis will download a JSON file to your computer with the key.<\/p>\n\n\n\n
Open the file, and you’ll get something similar, but with your own details:<\/p>\n\n\n\n
{\n \"type\": \"service_account\",\n \"project_id\": \"...\",\n \"private_key_id\": \"...\",\n \"private_key\": \"-----BEGIN PRIVATE KEY----- ...................\\n-----END PRIVATE KEY-----\\n\",\n \"client_email\": \".....\",\n \"client_id\": \"....\",\n \"auth_uri\": \"https:\/\/accounts.google.com\/o\/oauth2\/auth\",\n \"token_uri\": \"https:\/\/oauth2.googleapis.com\/token\",\n \"auth_provider_x509_cert_url\": \"https:\/\/www.googleapis.com\/oauth2\/v1\/certs\",\n \"client_x509_cert_url\": \"https:\/\/www.googleapis.com\/...\",\n \"universe_domain\": \"googleapis.com\"\n}<\/code><\/pre>\n\n\n\nCopy the project_id<\/strong>, client_email<\/strong>, private_key_id<\/strong> and private_key<\/strong> from the .json<\/em> file because you’ll need them later.<\/p>\n\n\n\n
Enable Google Sheet API<\/h3>\n\n\n\n
Now that you have a project, you need to enable the Google Sheet API for that project. Click on the following link: https:\/\/console.cloud.google.com\/apis\/library\/sheets.googleapis.com<\/a> and enable Google Sheets API (you need to be on the same account where you created the project).<\/p>\n\n\n
\n![\"enable](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/14-enable-google-sheets-api.png?resize=818%2C441&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nEnable Google Drive API<\/h3>\n\n\n\n
You also need to enable Google Drive API for your project. Open the following link https:\/\/console.cloud.google.com\/apis\/library\/drive.googleapis.com<\/a> and enable the Google Drive API.<\/p>\n\n\n
\n![\"enable](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/15-Enable-Google-Drive-API.png?resize=818%2C441&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n3. Installing the Arduino Google Sheet Client Library for Arduino devices<\/h2>\n\n\n\n
To publish readings to Google Sheets using the Google Service Account, we’ll use the ESP-Google-Sheet-Client library by Mobitz<\/a>. This library comes with methods to create, read, and delete spreadsheets and write, update, and append data to the spreadsheet file. You can find all the library examples<\/a>.<\/p>\n\n\n\n
In the Arduino IDE, go to Sketch <\/strong>> Library <\/strong>> Manage Libraries<\/strong>. Search for ESP-Google-Sheet-Client<\/strong> and click Install<\/strong>.<\/p>\n\n\n
\n![\"install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/01\/google-sheet-client-library-install-arduino-ide.png?resize=848%2C586&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n4. Creating a Google Spreadsheet<\/h2>\n\n\n\n
Go to Google Sheets and create a new spreadsheet<\/a>. Give a title to your spreadsheet. For example ESP32 Datalogging<\/em>.<\/p>\n\n\n
\n![\"spreadsheetid\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/spreadsheet_id.png?resize=942%2C557&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nSave the spreadsheet ID. It’s highlighted in the picture above. The Spreadsheet ID is the last string of characters in the URL for your spreadsheet. For example, in the URL https:\/\/docs.google.com\/spreadsheets\/d\/1aISQE8K79LS5c3vF18qFRcmfDRFn_9nE4nKveWBCtoQ\/edit#gid=0, the spreadsheet ID is 1aISQE8K79LS5c3vF18qFRcmfDRFn_9nE4nKveWBCtoQ<\/span>.<\/p>\n\n\n\n
5. Share the Spreadsheet with the Service Account<\/h2>\n\n\n\n
For you to be able to log data to that spreadsheet using the Google Service Account, as we’ll do in this tutorial, you need to share the spreadsheet with the service account email. You should get the service account email in the JSON file you downloaded previously<\/a> saved on the client_email<\/span> variable.<\/p>\n\n\n\n
At the top right corner click on Share<\/strong>. Paste the service account email and click Send<\/strong>.<\/p>\n\n\n
\n![\"Share](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/share-with-service-account-f.png?resize=942%2C557&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n6. ESP32 with BME280 Circuit<\/h2>\n\n\n\n
For this particular example, we’ll log data from a BME280 sensor. So, you need to wire a BME280 sensor to your ESP32. You can also use any other sensor you’re familiar with or adjust the code to publish random values if you don’t have a sensor at hand.<\/p>\n\n\n\n
Not familiar with the BME280 sensor? Read our getting started guide: ESP32 with BME280 Sensor using Arduino IDE (Pressure, Temperature, Humidity)<\/a>.<\/p>\n\n\n\n
Schematic Diagram<\/h3>\n\n\n\n
We\u2019re going to use I2C communication with the BME280 sensor module. For that, wire the sensor to the default ESP32 SCL (GPIO 22<\/span>) and SDA (GPIO 21<\/span>) pins, as shown in the following schematic diagram.<\/p>\n\n\n
\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/10\/ESP32-BME280-Sensor-Temperature-Humidity-Pressure-Wiring-Diagram-Circuit_f.png?resize=675%2C670&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nRecommended reading: ESP32 Pinout Reference: Which GPIO pins should you use?<\/a><\/p>\n\n\n\n
7. ESP32 Datalogging to Google Sheets – Arduino Sketch<\/h2>\n\n\n\n
Copy the following code to the Arduino IDE. Don’t upload it yet. You need to fill in some details before uploading it to the board.<\/p>\n\n\n
\/*\n Rui Santos\n Complete project details at https:\/\/RandomNerdTutorials.com\/esp32-datalogging-google-sheets\/\n \n Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.\n The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n Adapted from the examples of the Library Google Sheet Client Library for Arduino devices: https:\/\/github.com\/mobizt\/ESP-Google-Sheet-Client\n*\/\n\n#include <Arduino.h>\n#include <WiFi.h>\n#include <Adafruit_Sensor.h>\n#include <Adafruit_BME280.h>\n#include "time.h"\n#include <ESP_Google_Sheet_Client.h>\n\n\/\/ For SD\/SD_MMC mounting helper\n#include <GS_SDHelper.h>\n\n#define WIFI_SSID "REPLACE_WITH_YOUR_SSID"\n#define WIFI_PASSWORD "REPLACE_WITH_YOUR_PASSWORD"\n\n\/\/ Google Project ID\n#define PROJECT_ID "REPLACE_WITH_YOUR_PROJECT_ID"\n\n\/\/ Service Account's client email\n#define CLIENT_EMAIL "REPLACE_WITH_YOUR_CLIENT_EMAIL"\n\n\/\/ Service Account's private key\nconst char PRIVATE_KEY[] PROGMEM = "-----BEGIN PRIVATE KEY-----\\ REPLACE_WITH_YOUR_PRIVATE_KEY\\n-----END PRIVATE KEY-----\\n";\n\n\/\/ The ID of the spreadsheet where you'll publish the data\nconst char spreadsheetId[] = "YOUR_SPREADSHEET_ID";\n\n\/\/ Timer variables\nunsigned long lastTime = 0; \nunsigned long timerDelay = 30000;\n\n\/\/ Token Callback function\nvoid tokenStatusCallback(TokenInfo info);\n\n\/\/ BME280 I2C\nAdafruit_BME280 bme;\n\/\/ Variables to hold sensor readings\nfloat temp;\nfloat hum;\nfloat pres;\n\n\/\/ NTP server to request epoch time\nconst char* ntpServer = "pool.ntp.org";\n\n\/\/ Variable to save current epoch time\nunsigned long epochTime; \n\n\/\/ Function that gets current epoch time\nunsigned long getTime() {\n time_t now;\n struct tm timeinfo;\n if (!getLocalTime(&timeinfo)) {\n \/\/Serial.println("Failed to obtain time");\n return(0);\n }\n time(&now);\n return now;\n}\n\nvoid setup(){\n\n Serial.begin(115200);\n Serial.println();\n Serial.println();\n\n \/\/Configure time\n configTime(0, 0, ntpServer);\n\n \/\/ Initialize BME280 sensor \n if (!bme.begin(0x76)) {\n Serial.println("Could not find a valid BME280 sensor, check wiring!");\n while (1);\n }\n\n GSheet.printf("ESP Google Sheet Client v%s\\n\\n", ESP_GOOGLE_SHEET_CLIENT_VERSION);\n\n \/\/ Connect to Wi-Fi\n WiFi.setAutoReconnect(true);\n WiFi.begin(WIFI_SSID, WIFI_PASSWORD);\n \n Serial.print("Connecting to Wi-Fi");\n while (WiFi.status() != WL_CONNECTED) {\n Serial.print(".");\n delay(1000);\n }\n Serial.println();\n Serial.print("Connected with IP: ");\n Serial.println(WiFi.localIP());\n Serial.println();\n\n \/\/ Set the callback for Google API access token generation status (for debug only)\n GSheet.setTokenCallback(tokenStatusCallback);\n\n \/\/ Set the seconds to refresh the auth token before expire (60 to 3540, default is 300 seconds)\n GSheet.setPrerefreshSeconds(10 * 60);\n\n \/\/ Begin the access token generation for Google API authentication\n GSheet.begin(CLIENT_EMAIL, PROJECT_ID, PRIVATE_KEY);\n}\n\nvoid loop(){\n \/\/ Call ready() repeatedly in loop for authentication checking and processing\n bool ready = GSheet.ready();\n\n if (ready && millis() - lastTime > timerDelay){\n lastTime = millis();\n\n FirebaseJson response;\n\n Serial.println("\\nAppend spreadsheet values...");\n Serial.println("----------------------------");\n\n FirebaseJson valueRange;\n\n \/\/ New BME280 sensor readings\n temp = bme.readTemperature();\n \/\/temp = 1.8*bme.readTemperature() + 32;\n hum = bme.readHumidity();\n pres = bme.readPressure()\/100.0F;\n \/\/ Get timestamp\n epochTime = getTime();\n\n valueRange.add("majorDimension", "COLUMNS");\n valueRange.set("values\/[0]\/[0]", epochTime);\n valueRange.set("values\/[1]\/[0]", temp);\n valueRange.set("values\/[2]\/[0]", hum);\n valueRange.set("values\/[3]\/[0]", pres);\n\n \/\/ For Google Sheet API ref doc, go to https:\/\/developers.google.com\/sheets\/api\/reference\/rest\/v4\/spreadsheets.values\/append\n \/\/ Append values to the spreadsheet\n bool success = GSheet.values.append(&response \/* returned response *\/, spreadsheetId \/* spreadsheet Id to append *\/, "Sheet1!A1" \/* range to append *\/, &valueRange \/* data range to append *\/);\n if (success){\n response.toString(Serial, true);\n valueRange.clear();\n }\n else{\n Serial.println(GSheet.errorReason());\n }\n Serial.println();\n Serial.println(ESP.getFreeHeap());\n }\n}\n\nvoid tokenStatusCallback(TokenInfo info){\n if (info.status == token_status_error){\n GSheet.printf("Token info: type = %s, status = %s\\n", GSheet.getTokenType(info).c_str(), GSheet.getTokenStatus(info).c_str());\n GSheet.printf("Token error: %s\\n", GSheet.getTokenError(info).c_str());\n }\n else{\n GSheet.printf("Token info: type = %s, status = %s\\n", GSheet.getTokenType(info).c_str(), GSheet.getTokenStatus(info).c_str());\n }\n}\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
Insert your network credentials on the following variables.<\/p>\n\n\n\n
#define WIFI_SSID \"REPLACE_WITH_YOUR_SSID\"\n#define WIFI_PASSWORD \"REPLACE_WITH_YOUR_PASSWORD\"<\/code><\/pre>\n\n\n\nInsert your project ID, your client email, and your private key (you can find these details on the JSON file you downloaded in the previous steps).<\/p>\n\n\n\n
\/\/ Google Project ID\n#define PROJECT_ID \"REPLACE_WITH_YOUR_PROJECT_ID\"\n\n\/\/ Service Account's client email\n#define CLIENT_EMAIL \"REPLACE_WITH_YOUR_CLIENT_EMAIL\"\n\n\/\/ Service Account's private key\nconst char PRIVATE_KEY[] PROGMEM = \"-----BEGIN PRIVATE KEY-----\\ REPLACE_WITH_YOUR_PRIVATE_KEY\\n-----END PRIVATE KEY-----\\n\";<\/code><\/pre>\n\n\n\nFinally, insert the ID of the spreadsheet you want to publish your data.<\/p>\n\n\n\n
\/\/ The ID of the spreadsheet where you'll publish the data\nconst char spreadsheetId[] = \"YOUR_SPREADSHEET_ID\";<\/code><\/pre>\n\n\n\nNote: if your Google Sheets is not in English language, you might need to change Sheet1<\/span> with the corresponding in your language<\/strong> on the following line.<\/strong><\/p>\n\n\n\n
bool success = GSheet.values.append(&response \/* returned response *\/, spreadsheetId \/* spreadsheet Id to append *\/, \"Sheet1<\/strong>!A1\" \/* range to append *\/, &valueRange \/* data range to append *\/);<\/code><\/pre>\n\n\n\nYou can now upload the code to your ESP32 board.<\/p>\n\n\n\n
How the Code Works<\/h3>\n\n\n\n
Continue reading to learn how the code works, or skip to the Demonstration <\/a>section.<\/p>\n\n\n\n
Including Libraries<\/h4>\n\n\n\n
First, include the required libraries. We need the WiFi<\/span> library to connect our board to the internet, the Adafruit_sensor<\/span> and Adafruit_BME280<\/span> to interface with the BME280, the time.h<\/span> library to get the timestamp and finally, the ESP_Google_Sheet_Client<\/span> to interface the ESP32 with Google Sheets.<\/p>\n\n\n\n
Network Credentials<\/h4>\n\n\n\n
Insert your network credentials on the following variables.<\/p>\n\n\n\n
#define WIFI_SSID \"REPLACE_WITH_YOUR_SSID\"\n#define WIFI_PASSWORD \"REPLACE_WITH_YOUR_PASSWORD\"<\/code><\/pre>\n\n\n\nProject Details<\/h4>\n\n\n\n
Insert your project ID, service account email, and account private key. All these details can be found on the JSON file you downloaded previously.<\/p>\n\n\n\n
\/\/Google Project ID\n#define PROJECT_ID \"REPLACE_WITH_YOUR_PROJECT_ID\"\n\n\/\/ Service Account's client email\n#define CLIENT_EMAIL \"REPLACE_WITH_YOUR_CLIENT_EMAIL\"\n\n\/\/ Service Account's private key\nconst char PRIVATE_KEY[] PROGMEM = \"-----BEGIN PRIVATE KEY-----\\ REPLACE_WITH_YOUR_PRIVATE_KEY\\n-----END PRIVATE KEY-----\\n\";<\/code><\/pre>\n\n\n\nInsert the google spreadsheet id on the following variable.<\/p>\n\n\n\n
const char spreadsheetId[] = \"YOUR_SPREADSHEET_ID\";<\/code><\/pre>\n\n\n\nBME280 Variables<\/h4>\n\n\n\n
Create an instance for the BME280 called bme<\/span> and create variables to save temperature, humidity, and pressure.<\/p>\n\n\n\n
\/\/ BME280 I2C\nAdafruit_BME280 bme;\n\/\/ Variables to hold sensor readings\nfloat temp;\nfloat hum;\nfloat pres;<\/code><\/pre>\n\n\n\nTimestamp Variables<\/h4>\n\n\n\n
We create a variable with the ntp server we’ll request time from and a variable to save the current epoch time.<\/p>\n\n\n\n
\/\/ NTP server to request epoch time\nconst char* ntpServer = \"pool.ntp.org\";\n\n\/\/ Variable to save current epoch time\nunsigned long epochTime; <\/code><\/pre>\n\n\n\nWe also create a function to return the current epoch time called getTime()<\/span>.<\/p>\n\n\n\n
\/\/ Function that gets current epoch time\nunsigned long getTime() {\n time_t now;\n struct tm timeinfo;\n if (!getLocalTime(&timeinfo)) {\n \/\/Serial.println(\"Failed to obtain time\");\n return(0);\n }\n time(&now);\n return now;\n}<\/code><\/pre>\n\n\n\nLearn more about epoch time with the ESP32: Get Epoch\/Unix Time with the ESP32 (Arduino)<\/a>.<\/p>\n\n\n\n
setup()<\/h4>\n\n\n\n
In the setup()<\/span>, initialize the Serial Monitor for debugging purposes.<\/p>\n\n\n\n
Serial.begin(115200);\nSerial.println();\nSerial.println();<\/code><\/pre>\n\n\n\nConfigure the time.<\/p>\n\n\n\n
\/\/Configure time\nconfigTime(0, 0, ntpServer);<\/code><\/pre>\n\n\n\nInitialize the BME280 sensor.<\/p>\n\n\n\n
\/\/ Initialize BME280 sensor \nif (!bme.begin(0x76)) {\n Serial.println(\"Could not find a valid BME280 sensor, check wiring!\");\n while (1);\n}<\/code><\/pre>\n\n\n\nConnect the ESP32 to your local network.<\/p>\n\n\n\n
\/\/ Connect to Wi-Fi\nWiFi.setAutoReconnect(true);\nWiFi.begin(WIFI_SSID, WIFI_PASSWORD);\n \nSerial.print(\"Connecting to Wi-Fi\");\nwhile (WiFi.status() != WL_CONNECTED) {\n Serial.print(\".\");\n delay(1000);\n}\nSerial.println();\nSerial.print(\"Connected with IP: \");\nSerial.println(WiFi.localIP());\nSerial.println();<\/code><\/pre>\n\n\n\nThen, the following lines configure and initiate the authentication process for accessing Google APIs, including setting up a callback for token generation status, specifying a token refresh interval, and starting the generation of an access token with the relevant authentication credentials (CLIENT_EMAIL<\/span>, PROJECT_ID<\/span>, and PRIVATE_KEY<\/span> that you’ve defined previously).<\/p>\n\n\n\n
\/\/ Set the callback for Google API access token generation status (for debug only)\nGSheet.setTokenCallback(tokenStatusCallback);\n\n\/\/ Set the seconds to refresh the auth token before expire (60 to 3540, default is 300 seconds)\nGSheet.setPrerefreshSeconds(10 * 60);\n\n\/\/ Begin the access token generation for Google API authentication\nGSheet.begin(CLIENT_EMAIL, PROJECT_ID, PRIVATE_KEY);<\/code><\/pre>\n\n\n\nloop()<\/h4>\n\n\n\n
In the loop()<\/span>, you need to call the following line so that it constantly checks the authentication.<\/p>\n\n\n\n
bool ready = GSheet.ready();<\/code><\/pre>\n\n\n\nThen, we’ll periodically publish sensor readings to Google Sheets. You can adjust the interval on the timerDelay<\/span> variable defined at the start of the code.<\/p>\n\n\n\n
if (ready && millis() - lastTime > timerDelay){<\/code><\/pre>\n\n\n\nWe create a JSON object called valueRange<\/span> where we’ll add our data. The Google Sheets Client library we’re using with the ESP32 uses the FirebaseJson<\/span> library to handle JSON objects. To keep compatibility with other examples in the library, we’re also using that library.<\/p>\n\n\n\n
FirebaseJson valueRange;<\/code><\/pre>\n\n\n\nWe then get new BME280 readings and a corresponding timestamp.<\/p>\n\n\n\n
\/\/ New BME280 sensor readings\ntemp = bme.readTemperature();\n\/\/temp = 1.8*bme.readTemperature() + 32;\nhum = bme.readHumidity();\npres = bme.readPressure()\/100.0F;\n\/\/ Get timestamp\nepochTime = getTime();<\/code><\/pre>\n\n\n\nThese values are added to a FirebaseJson<\/span> object (valueRange<\/span>).<\/p>\n\n\n\n
valueRange.add(\"majorDimension\", \"COLUMNS\");\nvalueRange.set(\"values\/[0]\/[0]\", epochTime);\nvalueRange.set(\"values\/[1]\/[0]\", temp);\nvalueRange.set(\"values\/[2]\/[0]\", hum);\nvalueRange.set(\"values\/[3]\/[0]\", pres);<\/code><\/pre>\n\n\n\nThe valueRange<\/span> object is configured to have a “COLUMNS”<\/span> major dimension, indicating that the data will be organized column-wise. The timestamp will be located at the first column, first row; the temperature in the second column, first row, etc. If you want to organize in rows, you can pass “ROWS”<\/span> as an argument instead.<\/p>\n\n\n\n
Then, append this data to a specific sheet (Sheet1) starting at cell A1 in a Google Spreadsheet identified by its spreadsheetId<\/span>. The values in valueRange<\/span> are mapped to specific cells in the sheet, such as the timestamp in column A and the sensor readings in subsequent columns.<\/p>\n\n\n\n
\/\/ Append values to the spreadsheet\nbool success = GSheet.values.append(&response \/* returned response *\/, spreadsheetId \/* spreadsheet Id to append *\/, \"Sheet1!A1\" \/* range to append *\/, &valueRange \/* data range to append *\/);\nif (success){\n response.toString(Serial, true);\n valueRange.clear();\n}\nelse{\n Serial.println(GSheet.errorReason());\n}<\/code><\/pre>\n\n\n\nNote: if your Google Sheets is not in English language, you might need to change Sheet1<\/span> with the corresponding in your language<\/strong> on the following line.<\/strong><\/p>\n\n\n\n
bool success = GSheet.values.append(&response \/* returned response *\/, spreadsheetId \/* spreadsheet Id to append *\/, \"Sheet1<\/strong>!A1\" \/* range to append *\/, &valueRange \/* data range to append *\/);<\/code><\/pre>\n\n\n\nDemonstration<\/h2>\n\n\n\n
After uploading the code to the ESP32, open the Serial Monitor to check the process.<\/p>\n\n\n\n
The ESP32 should successfully connect to your Wi-Fi network and after 30 seconds, it should publish its first reading.<\/p>\n\n\n
\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/01\/ESP32-publish-to-google-sheets.png?resize=747%2C664&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOpen the spreadsheet where you’re publishing the values. You should see new values being published in real-time. The first column contains the epoch time, then the temperature in Celsius degrees, the humidity, and finally the pressure in hPa.<\/p>\n\n\n
\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/12\/ESP32-datalogging-google-sheets.png?resize=998%2C695&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWe’re using the timestamp in epoch time. To convert it to a readable format, you can simply use the EPOCHTODATE() function<\/a>.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
We hope you’ve found this project useful. As an example, we’ve shown you how to log data from a BME280 sensor, but you easily modify this project to use any other sensor. We have tutorials for more than 25 sensors with the ESP32<\/a>.<\/p>\n\n\n\n
The Arduino Google Sheets Client library<\/a> has many other features and useful methods that might be handy for your project. For example, instead of you having to create the spreadsheet manually, the library comes with a method to automatically create the spreadsheet<\/a>. It can also read, update, and append data to the spreadsheet. We recommend taking a look at the library examples<\/a> to have an idea of what this powerful library can do.<\/p>\n\n\n\n
We also have a similar project, but using a different approach. Instead of using a Google Service Account, we use IFTTT services: ESP32 Publish Sensor Readings to Google Sheets using IFTTT<\/a>. This method is more limited, but might also be a good option depending on your project requirements.<\/p>\n\n\n\n
Looking for other data logging methods? Read: ESP32: How to Log Data (9 Different Ways)<\/a><\/p>\n\n\n\n
Learn more about the ESP32 with our resources:<\/p>\n\n\n\n
- \n
- Learn ESP32 with Arduino IDE (eBook)<\/a><\/li>\n\n\n\n
- Build Web Servers with ESP32 and ESP8266 (eBook)<\/a><\/li>\n\n\n\n
- Firebase Web App with ESP32 and ESP8266 (eBook)<\/a><\/li>\n\n\n\n
- SMART HOME with Raspberry Pi, ESP32, and ESP8266<\/a><\/li>\n\n\n\n
- Free ESP32 Projects and Tutorials\u2026<\/a><\/li>\n<\/ul>\n\n\n\n
Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":"
In this project, you’ll learn how to log data to Google Sheets with the ESP32 securely and reliably using a Google Service Account and Google Sheets API. We’ll use the … <\/p>\n
- Build Web Servers with ESP32 and ESP8266 (eBook)<\/a><\/li>\n\n\n\n
- Learn ESP32 with Arduino IDE (eBook)<\/a><\/li>\n\n\n\n
- Creating a New Key<\/a><\/li>\n\n\n\n
- Google Service Account<\/a>\n