SAP Open Connectors

Tips and FAQ

Google Drive - Folder Permissions

When looking for an API call that deals with the Google Drive folder permissions, the API call files/{id}/permissions can be used also for folders as follows:

1. Retrieve the id of the folder through the call GET/folders/content.

2. Copy/paste the id in the POST/files/{id}/permissions API call and use the below payload: 

{
 "role": "reader",
 "type": "anyone"
}

The above payload adds the reader permission with anyone with the link.

Google Drive - What ID Can Be Used To Get The Root Folder of Documents Hub Connectors?

We are in the process of normalizing the documents hub even further, but there are always a few unique API provider differences and the 'ID' used to make a GET by the root folder ID is one such difference.

Currently the following values can be used in these connectors to make GET calls directly against the root folder by ID (for example, GET /folders/{id}/contents or GET /folders/{id}/metadata).

  • Box: 0. For example GET /folders/0/contents.
  • Dropbox: Double URL-encoded path: %252F. For example, GET /folders/%252F/contents.
  • Google Drive: root.  For example, GET /folders/root/contents.
  • OneDrive: root. For example, GET /folders/root/contents.
  • ShareFile: Whatever value was input at instance provision as the Sharefile root folder, such as top. For example, GET /folders/top/contents.

Google Drive - Only Native Google Files Can Be Stored In Binary Format

Native google files can be downloaded directly with the help of the web content URL provided for them. However, for non native files, the URL provided by Google does not work.

Therefore, only native google files can be stored in binary format. Given below is the link provided by Google to download them:

https://developers.google.com/resources/api-libraries/documentation/drive/v3/java/latest/

Google Drive - How to upload a file to a shared folder

If you would like to upload a file to a folder that has been shared with you, this can be done using the POST /files endpoint, provided that you have edit permissions on the folder. You will need to provide the folderId you would like to upload to, as well as the path. The path will be used relative to the folderId and will be used as the name of the file upload. For example, a path of "/myNewFile" in the folder with id 1234 would result in a file named "myNewFile" in the folder with id 1234. In order to make use of the folderId you will also need to set calculateFolderPath to false.

Google Drive - Tag and Path Names are Saved in our Database

If you enable the Document Hub Tagging (document.tagging) configuration parameter with certain connectors from the Documents hub, the paths and tags for any documents accessed will be stored in the SAP Open Connectors database in clear text. Affected connectors include a mention of this in their respective descriptions of the parameter.

Documents connectors affected include:

  • Dropbox
  • Dropbox Business
  • Egnyte
  • Google Drive
  • Sharepoint
  • Syncplicity

See our Data Protection & Privacy documentation for specifics about our data storage and security policies.

Documents Connectors - Tag and Path Names are Saved in our Database

If you enable the Document Hub Tagging (document.tagging) configuration parameter with certain connectors from the Documents hub, the paths and tags for any documents accessed will be stored in the SAP Open Connectors database in clear text. Affected connectors include a mention of this in their respective descriptions of the parameter.

Documents connectors affected include:

  • Dropbox
  • Dropbox Business
  • Egnyte
  • Google Drive
  • Sharepoint
  • Syncplicity

See our Data Protection & Privacy documentation for specifics about our data storage and security policies.