Package: gdoctableapppy
gdoctableapppyOverviewThis is a python library to manage the tables on Google Document using Google Docs API.DescriptionGoogle Docs API has been released. When I used this API, I found that it is very difficult for me to manage the tables on Google Document using Google Docs API. Although I checkedthe official document, unfortunately, I thought that it's very difficult for me. So in order to easily manage the tables on Google Document, I created this library.FeaturesAll values can be retrieved from the table on Google Document.Values can be put to the table.Delete table, rows and columns of the table.New table can be created by including values.Append rows to the table by including values.Replace texts with images.- The image data can be retrieved from URL.
	- The image data can be uploaded from the local PC.LanguagesI manages the tables on Google Document using several languages. So I created the libraries for 4 languages which are golang, node.js and python. Google Apps Script has Class DocumentApp. So I has never created the GAS library yet.go-gdoctableappnode-gdoctableappgdoctableapppygoogle-docs-table-factoryby gumatiasInstall$pipinstallgdoctableapppyYou can also see this library athttps://pypi.org/project/gdoctableapppy/.MethodMethodExplanationGetTables()Get all tables from Document.GetValues()Get values from a table from Document.SetValues()Set values to a table with 2 dimensional array.SetValues(Set values to a table with an object.DeleteTable()Delete a table.DeleteRowsAndColumns()Delete rows and columns of a table.CreateTable()Create new table including sell values.AppendRow()Append row to a table by including values.ReplaceTextsToImages()Replace texts with images from URL or file.This library usesgoogle-api-python-client.ResponseThis library returns the following value.{'tables':[],'values':[],'responseFromAPIs':[],'libraryVersion':version}WhenGetTables()is used, you can see the values withtables.WhenGetValues()is used, you can see the values withvalues.When other methods are used and the option ofshowAPIResponseistrue, you can see the responses from APIs which were used for the method. And also, you can know the number of APIs, which were used for the method, by the length of array ofresponseFromAPIs.UsageAbout the authorization, please check the section ofAuthorization. In order to use this library, it is required to confirm thatthe Quickstartworks fine.ScopeIn this library, using the scope ofhttps://www.googleapis.com/auth/documentsis recommended.1. GetTablesGet all tables from Document. All values, table index and table position are retrieved.Sample scriptThis sample script retrieves all tables from the Google Document of document ID.resource={"oauth2":creds,"documentId":documentId,# "showAPIResponse": True}res=gdoctableapp.GetTables(resource)# You can see the retrieved values like this.print(res)documentId: Document ID.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.showAPIResponse: WhenshowAPIResponse: trueis used toresource, the responses from Docs API can be seen. The default value isfalse.This option can be used for all methods.2. GetValuesGet values from the table. All values are retrieved.Sample scriptThis sample script retrieves the values from 1st table in Google Document. You can see the retrieved values as[][]string. Because when the values are retrieved by Docs API, all values are automatically converted to the string data.resource={"oauth2":creds,"documentId":"###","tableIndex":0,}res=gdoctableapp.GetValues(resource)print(res)# You can see the retrieved values like this.documentId: Document ID.tableIndex: Table index. If you want to use the 3rd table in Google Document. It's 2. The start number of index is 0.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.3. SetValues 1There are 2 patterns for putting values to the table. In this section, set values to the table with 2 dimensional array. When the rows and columns of values which are put are over those of the table, this method can automatically expand the rows and columns.Sample scriptThis sample script puts the values to the first table in Google Document.resource={"oauth2":creds,"documentId":"###","tableIndex":0,"values":[["a1","b1"],["a2","b2"],["a3","b3","c3"]]}res=gdoctableapp.SetValues(resource)# You can see the retrieved responses from Docs API.print(res)documentId: Document ID.tableIndex: Table index. If you want to use the 3rd table in Google Document. It's 2. The start number of index is 0.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.values:[][]stringResultWhen above script is run, the following result is obtained.From:To:4. SetValues 2There are 2 patterns for putting values to the table. In this section, set values to a table with an object. In this method, you can set the values using the range. When the rows and columns of values which are put are over those of the table, this method can automatically expand the rows and columns.Sample scriptThis script puts the values with the range to the first table in Google Document.resource={"oauth2":creds,"documentId":"###","tableIndex":0,"values":[{"values":[["A1"],["A2","B2","c2","d2"],["A3"]],"range":{"startRowIndex":0,"startColumnIndex":0}},{"values":[["B1","C1"]],"range":{"startRowIndex":0,"startColumnIndex":1}}]}res=gdoctableapp.SetValues(resource)# You can see the retrieved responses from Docs API.print(res)documentId: Document ID.tableIndex: Table index. If you want to use the 3rd table in Google Document. It's 2. The start number of index is 0.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.range.startRowIndexofvalues: Row index ofvalues[0][0].range.startColumnIndexofvalues: Column index ofvalues[0][0].values: Values you want to put.For example, when the row, column indexes and values are 1, 2 and "value", respectively, "value" is put to "C3".ResultWhen above script is run, the following result is obtained.From:To:5. DeleteTableSample scriptThis script deletes the first table in Google Document.resource={"oauth2":creds,"documentId":"###","tableIndex":0}res=gdoctableapp.DeleteTable(resource)print(res)# You can see the retrieved responses from Docs API.documentId: Document ID.tableIndex: Table index. If you want to use the 3rd table in Google Document. It's 2. The start number of index is 0.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.6. DeleteRowsAndColumnsSample scriptThis script deletes rows of indexes of 3, 1 and 2 of the first table in Google Document. And also this script deletes columns of indexes of 2, 1 and 3.resource={"oauth2":creds,"documentId":"###","tableIndex":0,"deleteRows":[3,1,2],# Start index is 0."deleteColumns":[2,1,3]# Start index is 0.}res=gdoctableapp.DeleteRowsAndColumns(resource)print(res)# You can see the retrieved responses from Docs API.documentId: Document ID.tableIndex: Table index. If you want to use the 3rd table in Google Document. It's 2. The start number of index is 0.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.deleteRows: Indexes of rows you want to delete.deleteColumns: Indexes of columns you want to delete.7. CreateTableSample scriptThis script creates new table to the top of Google Document, and the cells of the table have values.resource={"oauth2":creds,"documentId":"###","rows":3,"columns":5,"createIndex":1,# "append": True,  # When this is used instead of "Index", new table is created to the end of Document."values":[["a1","b1"],["a2","b2"],["a3","b3","c3"]]}res=gdoctableapp.CreateTable(resource)print(res)# You can see the retrieved responses from Docs API.documentId: Document ID.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.rows: Number of rows of new table.columns: Number of columns of new table.createIndex: Index of Document for putting new table. For example,1is the top of Document.append: Whenappendistrueinstead ofcreateIndex, the new table is created to the end of Google Document.values: If you want to put the values when new table is created, please use this.ResultWhen above script is run, the following result is obtained. In this case, the new table is created to the top of Google Document.8. AppendRowSample scriptThis sample script appends the values to the first table of Google Document.resource={"oauth2":creds,"documentId":"###","tableIndex":0,"values":[["a1","b1","c1",1,"",2],["a2","b2","c2",1,"",2]]}res=gdoctableapp.AppendRow(resource)print(res)# You can see the retrieved responses from Docs API.documentId: Document ID.tableIndex: Table index. If you want to use the 3rd table in Google Document. It's 2. The start number of index is 0.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.values: Values you want to append to the existing table.ResultWhen above script is run, the following result is obtained. In this case, the values are put to the last row. And you can see that 3 columns are automatically added when the script is run.From:From:9. ReplaceTextsToImagesSample scriptIn this sample, the texts{{sample}}in all tables are replaced with the image. In this case, you can use the image from an URL or a file on local PC.resource={"oauth2":creds,"documentId":"###","showAPIResponse":False,# default is false"tableOnly":True,# default is false"searchText":"{{sample}}","imageWidth":50,"imageHeight":50,"replaceImageURL":"https://###/sample.png"# "replaceImageFilePath": "./sample.png" # If you want to put the image in local PC, please use this.}res=gdoctableapp.ReplaceTextsToImages(resource)print(res)documentId: Document ID.oauth2: Credentials for using Docs API. Please check the section ofAuthorization.If you want to use Service Account, please useservice_accountinstead ofoauth2. About this, please checkthe sample script for Service account.searchText: Search text. This text is replaced with image.replaceImageURL: URL of the image. When this property is used, the image is retrieved from the URL, and the retrieved image is used.replaceImageFilePath: File path of the image. When this property is used, the image is retrieved from the file on local PC, and the retrieved image is used.imageWidth: Width of the put image.imageHeight: Height of the put image.tableOnly: When this isTrue, only texts in the table are replaced with image. When this isFalse, the texts in the body are replaced.showAPIResponse: When"showAPIResponse": Trueis used toresource, the responses from Docs API can be seen. The default value isFalse.NoteThe flow for replacing the text with the image on the local PC.Upload the image from local PC to Google Drive.Publicly share the image file. - The time for sharing is several seconds. The file is delete after the image is put.Put the image using the URL of the publicly shared file.Delete the image. - Even when the image is delete from Google Drive, the put image on Google Document is not deleted.AboutimageWidthandimageHeightobjectSize: The size that the image should appear as in the document. This property is optional and the final size of the image in the document is determined by the following rules: _ If neither width nor height is specified, then a default size of the image is calculated based on its resolution. _ If one dimension is specified then the other dimension is calculated to preserve the aspect ratio of the image. * If both width and height are specified, the image is scaled to fit within the provided dimensions while maintaining its aspect ratio.ResultWhen above script is run, the following result is obtained.From:To:The image ofhttps://cdn.sstatic.net/Sites/stackoverflow/company/img/logos/so/so-logo.pngwas used as the sample image.WhentableOnlyisFalse, the following result is retrieved.AuthorizationThere are 2 patterns for using this library.1. Use OAuth2Document of OAuth2 ishere.Sample scriptIn this sample script, the authorization process usesthe Quickstart for Node.js. You can see the detail information at there.from__future__importprint_functionimportpickleimportos.pathfromgoogle_auth_oauthlib.flowimportInstalledAppFlowfromgoogle.auth.transport.requestsimportRequestfromgdoctableapppyimportgdoctableapp# If modifying these scopes, delete the file token.pickle.SCOPES=['https://www.googleapis.com/auth/documents']defmain():"""Shows basic usage of the Docs API.Prints the title of a sample document."""creds=None# The file token.pickle stores the user's access and refresh tokens, and is# created automatically when the authorization flow completes for the first# time.ifos.path.exists('token.pickle'):withopen('token.pickle','rb')astoken:creds=pickle.load(token)# If there are no (valid) credentials available, let the user log in.ifnotcredsornotcreds.valid:ifcredsandcreds.expiredandcreds.refresh_token:creds.refresh(Request())else:flow=InstalledAppFlow.from_client_secrets_file('credentials.json',SCOPES)creds=flow.run_local_server()# Save the credentials for the next runwithopen('token.pickle','wb')astoken:pickle.dump(creds,token)resource={"oauth2":creds,"documentId":"###","tableIndex":0,}res=gdoctableapp.GetValues(resource)print(res)# You can see the retrieved values like this.if__name__=='__main__':main()2. Use Service accountDocument of Service account ishere. When you use Service account, please share Google Document with the email of Service account.Sample scriptfromgoogle.oauth2importservice_accountfromgdoctableapppyimportgdoctableappSCOPES=['https://www.googleapis.com/auth/documents']SERVICE_ACCOUNT_FILE='service-account-credentials.json'creds=service_account.Credentials.from_service_account_file(SERVICE_ACCOUNT_FILE,scopes=SCOPES)resource={"service_account":creds,"documentId":"###","tableIndex":0,}res=gdoctableapp.GetValues(resource)print(res)# You can see the retrieved values like this.LimitationsIn the current stage, unfortunately,tableCellStylecannot be modified by Google Docs API. By this, the formats of cells cannot be modified. About this, I have posted asFeature Request.References:Official document:Inserting or deleting table rowsIf you want to know the relationship between the index and startIndex of each cell, you can see it athere.LicenceMITAuthorTanaikeIf you have any questions and commissions for me, feel free to tell me.Update Historyv1.0.0 (July 18, 2019)Initial release.v1.0.5 (January 21, 2020)When the inline objects and tables are put in the table. An error occurred. This bug was removed by this update.v1.1.0 (January 22, 2020)New method was added.From this version, the texts can be replaced by images. The direct link and local file can be used as the image.TOP