Method: approvals.reassign

    Reassigns the reviewers on an Approval. Adds or replaces reviewers in the ReviewerResponse of the Approval.

    This can be called by any user with the writer permission on the file while the Approval Status is IN_PROGRESS and the Response for the reviewer being reassigned is NO_RESPONSE . A user with the reader permission can only reassign an approval that's assigned to themselves.

    Removing a reviewer isn't allowed.

    HTTP request

    POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals/{approvalId}:reassign

    The URL uses gRPC Transcoding syntax.

    Path parameters

    Parameters
    fileId

    string

    Required. The ID of the file the Approval is on.
    approvalId

    string

    Required. The ID of the Approval to reassign.

    Request body

    The request body contains data with the following structure:

    JSON representation 
     { 
 "addReviewers" 
 : 
 [ 
 { 
 object (  AddReviewer 
 
) 
 } 
 ] 
 , 
 "replaceReviewers" 
 : 
 [ 
 { 
 object (  ReplaceReviewer 
 
) 
 } 
 ] 
 , 
 "message" 
 : 
 string 
 }
    Fields
    addReviewers[]

    object ( AddReviewer )

    Optional. The list of reviewers to add.
    replaceReviewers[]

    object ( ReplaceReviewer )

    Optional. The list of reviewer replacements.
    message

    string

    Optional. A message to send to the new reviewers. This message will be included in notifications for the action and in the Approval activity log.

    Response body

    If successful, the response body contains an instance of Approval .

    Authorization scopes

    Requires one of the following OAuth scopes:

    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/drive.file
    • https://www.googleapis.com/auth/drive.metadata

    Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide .

    AddReviewer

    Representation of a reviewer addition.

    JSON representation 
     { 
 "addedReviewerEmail" 
 : 
 string 
 }
    Fields
    addedReviewerEmail

    string

    Required. The email of the reviewer to add.

    ReplaceReviewer

    Representation of a reviewer replacement.

    JSON representation 
     { 
 "addedReviewerEmail" 
 : 
 string 
 , 
 "removedReviewerEmail" 
 : 
 string 
 }
    Fields
    addedReviewerEmail

    string

    Required. The email of the reviewer to add.
    removedReviewerEmail

    string

    Required. The email of the reviewer to remove.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: