UpdateACL Method

Modifies the Access Control List (ACL).

Syntax

gdata.updateACL([callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method will update the Access Control List (ACL) of a data object, specified by EntryAclURL, with the entries contained within ACLs.

When this method is called, the class will perform the specified ACLOperation for each Access Control List (ACL) entry. Therefore you can perform multiple ACL operations (such as deleting, updating, and/or adding an entry) within a single call, by setting ACLOperation as needed.

To determine if each ACL entry operation was successful or not, you will need to check ACLSuccess after an update to the Access Control List was attempted. Additionally, ACLStatusCode and ACLStatusReason can be used to obtain further details about the status of the operation that was performed. Below is a list of possible ACLStatusCode values.