code: public Share updateShare(long objectId, Share share) throws SmartsheetException {
          Util.throwIfNull(share);
          return this.updateResource(getMasterResourceType() + "/" + objectId + "/shares/" + share.getId(), Share.class, share);
      }
docs: <p>Update a share.</p>
  
  <p>It mirrors to the following Smartsheet REST API method:</p>
  <p>PUT /workspaces/{workspaceId}/shares/{shareId}</p>
  <p>PUT /sheets/{sheetId}/shares/{shareId}</p>
  <p>PUT /sights/{sheetId}/shares/{shareId}</p>
  <p>PUT /reports/{reportId}/shares/{shareId}</p>
  
  @param objectId the ID of the object to share
  @param share the share
  @return the updated share (note that if there is no such resource, this method will throw
  ResourceNotFoundException rather than returning null).
  @throws IllegalArgumentException if any argument is null or empty string
  @throws InvalidRequestException if there is any problem with the REST API request
  @throws AuthorizationException if there is any problem with  the REST API authorization (access token)
  @throws ResourceNotFoundException if the resource cannot be found
  @throws ServiceUnavailableException if the REST API service is not available (possibly due to rate limiting)
  @throws SmartsheetException if there is any other error during the operation