From 8a58002829dcfe9a6a88b82e443fd07a3491c0fd Mon Sep 17 00:00:00 2001
From: dday76 <jason@dday76.net>
Date: Sun, 22 Mar 2020 17:13:00 -0400
Subject: [PATCH 1/2] creating college API update

see comments in file for notes; related to your Automation course / college scorecard API section
---
 collegeAPIv2 | 100 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 collegeAPIv2

diff --git a/collegeAPIv2 b/collegeAPIv2
new file mode 100644
index 0000000..1fde843
--- /dev/null
+++ b/collegeAPIv2
@@ -0,0 +1,100 @@
+// Also at this location, but I wasn't sure how to push to this repository...
+// https://github.com/dday76/gsWork/blob/master/collegeAPIv2
+
+/**
+ * Adapted from/for Ben L Collins, https://www.benlcollins.com/
+ * Single function (not an improvement, but see below)
+ * avoids separating page1 from later page calls
+ * clears sheet prior to re-posting dsata
+ * handles 0-row and 1-row instances
+ * skips full API call/creation for errors
+ * returns error codes to sheet if applicable
+ * DOES NOT handle errors specifcially; just returns the code
+ * DOES NOT handle pulling attributes outside of the example case (url/data elements are hardcoded)
+ */
+function doAPI() {
+
+
+
+var API_KEY = '4fdcWyaPRMcsqyAlktRGYNRVRC3CwWk9FcOxDRB5';
+
+/**
+ * function to call the Open Data Maker API
+ */
+function doAPI() {
+
+/**
+ * function to call the Open Data Maker API
+ */
+  
+  // setup the api query
+  var root = 'https://api.data.gov/';
+  var endpoint = 'ed/collegescorecard/v1/schools.json';
+  var query = '?school.city=new%20york&_fields=id,school.name,latest.student.size,latest.cost.tuition.in_state,latest.cost.tuition.out_of_state';
+    
+  var url = root + endpoint + query;
+  
+  // advanced parameters for url fetch app
+  // only one of many params
+  var params = {
+    muteHttpExceptions: true
+  };
+  
+  // call and parse data
+  var textAPI = UrlFetchApp.fetch(url + '&api_key=' + API_KEY, params);
+  var jsonAPI = JSON.parse(textAPI.getContentText());
+  
+
+  // create empty array to hold college data
+  var sheetsAPI = [];
+  
+  switch(textAPI.getResponseCode()) {
+
+    case 200:
+
+    // process the data if valid = response 200
+      
+    // get number of loops
+    // metadata{total,per_page,page}
+    var loops = Math.ceil(jsonAPI.metadata.total / jsonAPI.metadata.per_page);
+
+    for (var i=1;i<=loops;i++) {
+
+    // loop over the results array
+      for (var row in jsonAPI.results) {
+
+        // get the data elements
+        var id = jsonAPI.results[row]['id'];
+        var name = jsonAPI.results[row]['school.name']; // cannot use dot notation, so use square bracket notation instead
+        var size = jsonAPI.results[row]['latest.student.size'];
+        var inStateTuition = jsonAPI.results[row]['latest.cost.tuition.in_state'];
+        var outOfStateTuition = jsonAPI.results[row]['latest.cost.tuition.out_of_state'];
+      
+        // put the data elements into double array for Sheets
+        sheetsAPI.push([id, name, size, inStateTuition, outOfStateTuition]);
+        // continues to add to previous array in later loops
+        // allCollegeData = allCollegeData.concat(nextBatch);
+        
+      } // for results
+      
+    } // for loops
+    
+      break;
+    default: 
+      // process the error message
+      sheetsAPI.push(['Error code: ',textAPI.getResponseCode()]);
+      sheetsAPI.push(['***','***']);
+  }
+      
+  // paste the data into our Sheet
+  var ss = SpreadsheetApp.getActiveSpreadsheet();
+  var sh = ss.getActiveSheet();
+  
+  // handle no data returned or only one row returned
+  sheetsAPI.length == 0 ? sheetsAPI = [['***','no data returned'],['***','***']] : null;
+  sheetsAPI.length == 1 ? sheetsAPI.push(['end of data','***','***','***','***']) : null;
+
+  sh.getRange(2,1,sh.getLastRow(),sh.getLastColumn()).clearContent(); // start fresh
+  sh.getRange(2, 1, sheetsAPI.length, sheetsAPI[0].length).setValues(sheetsAPI); // add new
+  
+}

From f342c2668da3fed6da9a74c3990fcabcaab2f519 Mon Sep 17 00:00:00 2001
From: dday76 <jason@dday76.net>
Date: Sun, 22 Mar 2020 17:26:07 -0400
Subject: [PATCH 2/2] note about foreach/for

---
 collegeAPIv2 | 1 +
 1 file changed, 1 insertion(+)

diff --git a/collegeAPIv2 b/collegeAPIv2
index 1fde843..320d90a 100644
--- a/collegeAPIv2
+++ b/collegeAPIv2
@@ -3,6 +3,7 @@
 
 /**
  * Adapted from/for Ben L Collins, https://www.benlcollins.com/
+ * updates for each with for per new v8 standard (if it's even necessary...)
  * Single function (not an improvement, but see below)
  * avoids separating page1 from later page calls
  * clears sheet prior to re-posting dsata