(Delphi DLL) Google Sheets - Append Values to an Existing Spreadsheet

Appends values to an existing Google spreadsheet.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpResponse, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
jsonToken: HCkJsonObject;
success: Boolean;
http: HCkHttp;
json: HCkJsonObject;
resp: HCkHttpResponse;

begin
//  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..
jsonToken := CkJsonObject_Create();
success := CkJsonObject_LoadFile(jsonToken,'qa_data/tokens/googleSheets.json');
if (CkJsonObject_HasMember(jsonToken,'access_token') = False) then
  begin
    Memo1.Lines.Add('No access token found.');
    Exit;
  end;
http := CkHttp_Create();
CkHttp_putAuthToken(http,CkJsonObject__stringOf(jsonToken,'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"
//      ]
//    ]
//  }

json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'range','Sheet1!A1:B5');
CkJsonObject_UpdateString(json,'majorDimension','ROWS');

CkJsonObject_putI(json,0);
CkJsonObject_putJ(json,1);
CkJsonObject_UpdateString(json,'values[i][j]','Paint');
CkJsonObject_putJ(json,1);
CkJsonObject_UpdateString(json,'values[i][j]','$100');

CkJsonObject_putI(json,1);
CkJsonObject_putJ(json,0);
CkJsonObject_UpdateString(json,'values[i][j]','Brakes');
CkJsonObject_putJ(json,1);
CkJsonObject_UpdateString(json,'values[i][j]','$100');

CkJsonObject_putI(json,2);
CkJsonObject_putJ(json,0);
CkJsonObject_UpdateString(json,'values[i][j]','Totals');
CkJsonObject_putJ(json,1);
CkJsonObject_UpdateString(json,'values[i][j]','$335.50');

CkJsonObject_putEmitCompact(json,False);
Memo1.Lines.Add(CkJsonObject__emit(json));

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

CkHttp_SetUrlVar(http,'spreadsheetId','1_SO2L-Y6nCayNpNppJLF0r9yHB2UnaCleGCKeE4O0SA');
CkHttp_SetUrlVar(http,'range','Sheet1!A1:B5');
resp := CkHttp_PostJson(http,'https://sheets.googleapis.com/v4/spreadsheets/{$spreadsheetId}/values/{$range}:append?valueInputOption=USER_ENTERED',CkJsonObject__emit(json));
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

Memo1.Lines.Add('response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
Memo1.Lines.Add('response JSON = ' + CkHttpResponse__bodyStr(resp));

CkHttpResponse_Dispose(resp);

//  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:
//  

CkJsonObject_Dispose(jsonToken);
CkHttp_Dispose(http);
CkJsonObject_Dispose(json);

end;