Xbase++

Google Sheets - Append Values to an Existing Spreadsheet

See more Google Sheets Examples

Appends values to an existing Google spreadsheet. Xbase++

LOCAL nSuccess
LOCAL oJsonToken
LOCAL oHttp
LOCAL oJson
LOCAL oResp

nSuccess := 0

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

//  This example uses a previously obtained access token having permission for the 
//  Google Sheets scope.

//  In this example, Get Google Sheets OAuth2 Access Token, the access
//  token was saved to a JSON file.  This example fetches the access token from the file..
oJsonToken := CreateObject("Chilkat.JsonObject")
nSuccess := oJsonToken:LoadFile("qa_data/tokens/googleSheets.json")
IF (oJsonToken:HasMember("access_token") == 0)
    ? "No access token found."
    oJsonToken:destroy()
    RETURN
ENDIF

oHttp := CreateObject("Chilkat.Http")
oHttp:AuthToken := oJsonToken:StringOf("access_token")

//  To append values to an existing spreadsheet, our HTTP request body will
//  contain JSON in the format of a "ValueRange".  For example, the spreadsheet we'll be
//  adding to in this example looks like this:

//  

//  The JSON ValueRange for the cells in the above spreadsheet is:
//  {
//    "range": "Sheet1!A1:B5",
//    "majorDimension": "ROWS",
//    "values": [
//      [
//        "Item",
//        "Cost"
//      ],
//      [
//        "Wheel",
//        "$20.50"
//      ],
//      [
//        "Door",
//        "$15"
//      ],
//      [
//        "Engine",
//        "$100"
//      ],
//      [
//        "Totals",
//        "$135.50"
//      ]
//    ]
//  }

//  This example will append 6 cells (3 rows / 2 columns).
//  We'll be appending the following:
//  
//  "Paint", "$100"
//  "Brakes", "$100"
//  "New Total", "$335.50"
//  

//  The range of cells we'll be appending is A1:B5
//  Therefore, the ValueRange JSON we'll be sending in our POST body is:

//  {
//    "range": "Sheet1!A1:B5",
//    "majorDimension": "ROWS",
//    "values": [
//      [
//        "Paint",
//        "$100"
//      ],
//      [
//        "Brakes",
//        "$100"
//      ],
//      [
//        "New Total",
//        "$335.50"
//      ]
//    ]
//  }

oJson := CreateObject("Chilkat.JsonObject")
oJson:UpdateString("range", "Sheet1!A1:B5")
oJson:UpdateString("majorDimension", "ROWS")

oJson:I := 0
oJson:J := 1
oJson:UpdateString("values[i][j]", "Paint")
oJson:J := 1
oJson:UpdateString("values[i][j]", "$100")

oJson:I := 1
oJson:J := 0
oJson:UpdateString("values[i][j]", "Brakes")
oJson:J := 1
oJson:UpdateString("values[i][j]", "$100")

oJson:I := 2
oJson:J := 0
oJson:UpdateString("values[i][j]", "Totals")
oJson:J := 1
oJson:UpdateString("values[i][j]", "$335.50")

oJson:EmitCompact := 0
? oJson:Emit()

//  Send the POST to:
//  https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append?valueInputOption=USER_ENTERED

oHttp:SetUrlVar("spreadsheetId", "1_SO2L-Y6nCayNpNppJLF0r9yHB2UnaCleGCKeE4O0SA")
oHttp:SetUrlVar("range", "Sheet1!A1:B5")
oResp := CreateObject("Chilkat.HttpResponse")
nSuccess := oHttp:HttpJson("POST", "https://sheets.googleapis.com/v4/spreadsheets/{$spreadsheetId}/values/{$range}:append?valueInputOption=USER_ENTERED", oJson, "application/json", oResp)
IF (nSuccess == 0)
    ? oHttp:LastErrorText
    oJsonToken:destroy()
    oHttp:destroy()
    oJson:destroy()
    oResp:destroy()
    RETURN
ENDIF

? "response status code = " + Str(oResp:StatusCode)
? "response JSON = " + oResp:BodyStr

//  Sample output:
//  
//  response status code = 200
//  response JSON = {
//    "spreadsheetId": "1_SO2L-Y6nCayNpNppJLF0r9yHB2UnaCleGCKeE4O0SA",
//    "tableRange": "Sheet1!A1:B5",
//    "updates": {
//      "spreadsheetId": "1_SO2L-Y6nCayNpNppJLF0r9yHB2UnaCleGCKeE4O0SA",
//      "updatedRange": "Sheet1!A6:B8",
//      "updatedRows": 3,
//      "updatedColumns": 2,
//      "updatedCells": 6
//    }
//  }
//  

//  Our Google Spreadsheet now looks like this:
//  

oJsonToken:destroy()
oHttp:destroy()
oJson:destroy()
oResp:destroy()