The document provides an overview of the Google Spreadsheet API for Java, covering authorization, working with worksheets and cells, and list-based and cell-based feeds. It discusses how to create a spreadsheet service, get authorization credentials, retrieve spreadsheet and worksheet feeds, add and update worksheets and cells, and perform queries. The document also lists the required Java libraries and provides links for additional documentation.

1. Overview of Google
Spreadsheet API for Java
Nazarii Kostiv

2. Agenda
● Overview
● Authorization;
● Work with worksheet;
● List-based feeds;
● Cell-based feeds;
● Questions.

3. What we need to start
● jdk 1.5 or greater;
● gdata-java-client jars;
● java mail API 1.4 or greater;
● javaBeans Activation Framework.

4. Overview
Creating
spreadsheet Set spreadsheet
Authorizing
service URL and name
Get row or cell Get spreadsheet
Get worksheet
feed

5. Authorization
SpreadsheetService service =
new SpreadsheetService("service name"); - create spreadsheet
service
service.setUserCredentials("username", "password"); - send user
credentials

6. Getting spreadsheet feed
String SPREADSHEET_URL = "https://spreadsheets.google.
com/feeds/spreadsheets/private/full";
URL sheetListUrl =
new URL(SPREADSHEET_URL);- set spreadsheer URL;
SpreadsheetQuery query = new SpreadsheetQuery(sheetListUrl);
query.setTitleQuery("Spreadsheet name"); - set spreadsheet name;
SpreadsheetFeed feed =
service.getFeed(query, SpreadsheetFeed.class); - get spreadsheet
feed with entries.

7. Worksheet
List<SpreadsheetEntry> spreadsheetEntries = feed.getEntries();
SpreadsheetEntry spreadsheet = spreadsheetEntries.get(0); - get
spreadsheet
List<WorksheetEntry> worksheets =
spreadsheetEntry.getWorksheets();
WorksheetEntry worksheet = worksheets.get(0); - get worksheet;

8. Worksheet info
List<WorksheetEntry> worksheets = SpreadsheetDemoUtil.
getWorksheets();
for (WorksheetEntry worksheet : worksheets) {
System.out.println("Worksheet name: "
+ worksheet.getTitle().getPlainText() + ", Cols: "
+ worksheet.getColCount() + ", Rows: "
+ worksheet.getRowCount());
}
Worksheet name: Worksheet 1, Cols: 20, Rows: 93
Worksheet name: Worksheet 2, Cols: 20, Rows: 50
Worksheet name: New worksheet, Cols: 20, Rows: 100

9. Working with worksheet
WorksheetEntry worksheet = new WorksheetEntry();
URL worksheetFeedUrl =
spreadsheetEntry.getWorksheetFeedUrl();
insertedWorksheet = service.insert(
worksheetFeedUrl, worksheet); - add new worksheet;
worksheetETag = insertedWorksheet.getEtag();
worksheet.setColCount(30);
worksheet.update(); - update worksheet;

10. Working with worksheet
title = worksheet.getTitle().getPlainText();
eTag = worksheet.getEtag();
if (title.equals("New worksheet")
&& eTag.equals(worksheetETag)) {
try {
worksheet.delete();
} catch .... - delete worksheet;

11. List-based feeds
URL listFeedUrl = worksheetEntry.getListFeedUrl();
ListFeed feed =
service.getFeed(listFeedUrl, ListFeed.class); - get list-based feed
with list of rows
for (ListEntry entry : feed.getEntries()) {
System.out.println(entry.getTitle().getPlainText());
}

12. List based working
URL listFeedUrl = new URI(null, null,
worksheet.getListFeedUrl().toString(),
"sq=width>25 and height<175", null).toURL();
listFeed = service.getFeed(listFeedUrl, ListFeed.class);
for (ListEntry row : listFeed.getEntries()) {
System.out.println(row.get...);
}

13. Add row
ListFeed listFeed = service.getFeed(listFeedUrl, ListFeed.class);
ListEntry row = new ListEntry();
row.getCustomElements().setValueLocal("Component", "New
component");
row.getCustomElements().setValueLocal("width", "25");
row.getCustomElements().setValueLocal("height", "19");
row = service.insert(listFeedUrl, row); - insert new row

14. Delete row
ListFeed listFeed = service.getFeed(listFeedUrl, ListFeed.class);
for (ListEntry row : listFeed.getEntries()) {
if (...) {
row.delete();
}

15. Cell-based feeds
URL cellFeedUrl = worksheetEntry.getCellFeedUrl();
CellFeed feed =
service.getFeed(celFeedUrl, CellFeed.class); - get cell-based feed
with list of cells
for (CellEntry cell : feed.getEntries()) {
System.out.println(entry.getTitle().getPlainText());
}

16. Cell based working
URL cellFeedUrl = new URI(null, null,
worksheet.getCellFeedUrl().toString(),
"?min-row=2&min-col=4&max-col=4",
null).toURL();
CellFeed cellFeed = service.getFeed(cellFeedUrl, CellFeed.class);
for (CellEntry cell : cellFeed.getEntries()) {
System.out.println(cell.getTitle().getPlainText();
}

17. Cell based working
URL cellFeedUrl = mainWorksheet.getCellFeedUrl();
CellQuery cellQuery = new CellQuery(cellFeedUrl);
cellQuery.setMinimumCol(2);
cellQuery.setMaximumCol(4);
cellQuery.setMinimumRow(4);
cellQuery.setMaximumRow(4);
CellFeed cellFeed = null;
try {
cellFeed = service.query(cellQuery, CellFeed.class);
} catch(...)

18. Cell data manipulation
if (cell.getTitle().getPlainText().equals("A1")){
cell.changeInputValueLocal("123"); - set value to cell
cell.update();
}
.....
cell.changeInputValueLocal("=SUM(A1:B1)"); - set cell formula

19. Questions?

20. Links
● https://developers.google.com/google-apps/spreadsheets/
● https://developers.google.com/google-apps/documents-list/
● https://developers.google.com/apps-script/guide

21. Nazarii Kostiv
Email: nazar.kostiv@gmail.com