Google Docs DeleteContentRange API fails when content contains a suggestion

[jfreda]

There is currently a bug with the Google Docs DeleteContentRange API where deleting content that contains a suggestion fails with this error:

googleapi: Error 500: Internal error encountered.

This affects all Hermes actions that rewrite the document header, including indexing updated documents, changing document state (e.g., requesting a review), and approving documents.

We have reported this to Google and they confirmed the bug, but there is no estimated time for a resolution. Unfortunately, while this bug exists, Hermes functionality to rewrite document headers fails if a user puts a suggestion in the header, and there is no way to automatically remediate this (working with suggestions is also unsupported by Google Docs' public API). Until this bug is fixed, we should lock documents in this state and provide some visual feedback for users for how to remediate, which is to remove all suggestions in the document header. Once all suggestions are removed from the document header, the Hermes indexer will automatically re-index the document and unlock it for editing.