Reviewing

The Review option allows you to review a document, change sentences, phrases and other page elements, correct spelling, etc. without actually editing it. All the changes will be recorded and shown to the user who created the document.

In order to enable the review option, the review parameter in the permissions section of the document initialization must be set to true. The document status bar will contain the Review menu option.

In case the edit parameter is set to true and the review parameter is also set to true, the user will be able to edit the document, accept or reject the changes and switch to the review mode him/herself.

Reviewing

In case the edit parameter is set to false and the review parameter is set to true, the document will be available for reviewing only.

var docEditor = new DocsAPI.DocEditor("placeholder", {
    "document": {
        "permissions": {
            "edit": false,
            "review": true
        },
        ...
    },
    ...
});
Please note that the document review will only be available for the document editor if the mode parameter is set to edit.
  1. Specify the group (or several groups separated with commas) the user belongs to by adding the field group to the user parameter in the editorConfig section.

    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "editorConfig": {
            "user": {
                "id": "78e1e841",
                "name": "John Smith",
                "group": "Group1"
            }
        },
        ...
    });
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "editorConfig": {
            "user": {
                "id": "F89d8069ba2b",
                "name": "Kate Cage",
                "group": "Group2"
            }
        },
        ...
    });
    
  2. Specify the group access rights using the reviewPermissions parameter in the customization section of the editor initialization.

    If the reviewPermissions parameter is specified in the editor config, the access rights to reviewing all changes are disabled. Otherwise, if the current user does not belong to any of the groups, he or she can review documents of all groups.
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "editorConfig": {
            "customization": {
                "reviewPermissions": {
                    "Group1": ["Group2"],
                    "Group2": ["Group1", "Group2", ""],
                },
                ...
            }
            ...
        },
        ...
    });
    

    "Group1": ["Group2"] means that users from Group1 can review changes made by users from Group2.

    "Group2": ["Group1", "Group2"] means that users from Group2 can review changes made by users from Group1 and Group2.

    The reviewPermissions parameter can take the value of an empty group. This means that the group of users can review changes made by users who do not belong to any of the groups (for example, the document that is reviewed in third-party editors).

    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "editorConfig": {
            "customization": {
                "reviewPermissions": {
                    "Group1": ["Group2", ""],
                },
                ...
            }
            ...
        },
        ...
    });
    

    "Group1": ["Group2", ""] means that users from Group1 can review changes made by users from Group2 and users who do not belong to any of the groups.