Von Hubspot zu Google Sheets mit JavaScript - Teil II

Wann ist eine Tabellenkalkulation mehr als eine Tabellenkalkulation? Wenn die Codierung mit Google Apps Script sie in ein dynamisches Dashboard verwandelt. In meinem letzten Blog-Beitrag habe ich darüber gesprochen, wie wir zu der Entscheidung gekommen sind, Google Sheets und Google Apps Scripts zu verwenden, um unseren neuen Sales Lead Tracker zu entwickeln. In diesem Beitrag gehe ich näher auf den Code ein, den wir verwendet haben, was ich geschrieben habe und wie Sie ihn verwenden können. Ich habe auch ein einfaches Skript zum Abrufen von Daten aus Hubspot bereitgestellt. Diese Informationen sollten ausreichen, um die Arbeit mit Google Sheets und Google Apps Script zu beginnen. Die größte Herausforderung bei all dem ist die Beschaffung der Daten, aber ich habe eine Dokumentation beigefügt, um den Prozess so selbsterklärend wie möglich zu machen.

Mehr über den Code

Der Großteil des Codes ist in einfachem JavaScript geschrieben, obwohl einige Abschnitte Google Apps Script-Klassen verwenden. Das Ziel des Codes ist es, Daten von Hubspot über einen API-Aufruf abzurufen. Ich fordere die Daten an, indem ich eine URL als String in unserem Skript konstruiere. Ich füge unseren API-Schlüssel sowie andere Optionen wie Eigenschaften zur URL hinzu. Wie Sie die URL formatieren, bestimmt, welche Daten Sie zurückbekommen. In unserem Fall wurde in der Hubspot-API-Dokumentation erklärt, wie die URL formatiert werden sollte. Anschließend bereinige ich unsere Daten dort, wo sie benötigt werden, und schreibe sie dann in unser Google Sheet.

Wie ich bereits erwähnt habe, ist das Beschaffen der Daten der schwierige Teil, zumindest wenn man zum ersten Mal mit Google Apps Script anfängt. Es gibt zwar eine Erklärung in der Google Apps Script-Dokumentation, aber sie ist sehr allgemein gehalten und überspringt bestimmte Schritte, z. B. wie man auf Daten zugreift oder das JSON parst. Der größte Teil der Codierung war ein Lernprozess, anfangs eine Menge Versuch und Irrtum, aber sobald man die Grundlagen verstanden hat (die in unserem GitHub erklärt werden), wird die Erstellung eines Dashboards zu einer einfachen Übung.

Der Code ruft Daten über eine URL ab, und die Daten werden in JSON zurückgegeben, wodurch ich die Daten leicht in JavaScript-Objekte umwandeln kann. Von dort aus kann ich auf die Eigenschaften der Objekte zugreifen. Ich habe zum Beispiel eine Reihe von Unternehmen von Hubspot zusammen mit ausgewählten Eigenschaften angefordert. Die Unternehmen wurden in JSON zurückgegeben, das ich dann in ein Array geparst habe. Sobald ich alle Daten in einem Array hatte, habe ich es in einer Schleife durchlaufen und unsere Daten in Google Sheets geschrieben, was so einfach ist, wie das aktive Arbeitsblatt zu holen und die Zeilen und Spalten auszuwählen, in die man schreiben möchte.

Was ich sehr hilfreich fand, war, den Typ dieser Eigenschaften zu ändern. Hubspot zum Beispiel gibt Daten als Millisekunden-Zeitstempel zurück. Ich möchte eine Schleife durch unsere Hubspot-Objekte ziehen und diese Zeitstempel in JavaScript-Datumsobjekte umwandeln. Das macht die Datenmanipulation viel einfacher.

Und jetzt das Beste

Unser mitgelieferter Code ist sehr umfangreich und kann leicht verstanden und angepasst werden. Es ist ganz einfach, unsere mitgelieferten Funktionen zu verwenden und Ihren eigenen API-Schlüssel einzufügen, um mit den Funktionen zu spielen und ein besseres Verständnis dafür zu erlangen, wie diese Skripte erstellt werden können. In unserem mitgelieferten Code befassen wir uns mit Unternehmensobjekten. Das Konzept lässt sich leicht auf andere Hubspot-Objekttypen wie Kontakte, Deals usw. übertragen. Gelegentlich werden Sie einige Datenbereinigungen in Hubspot (oder der von Ihnen verwendeten Datenquelle) vornehmen müssen, aber Sie sollten auf dem besten Weg sein, mit unserem Code als Grundlage ein robustes Dashboard zu erstellen.

Beginnen Sie mit unserem Google Sheets Dashboard-Code.