Aggiorna una regola di controllo dell'accesso. Prova subito o guarda un esempio.
Richiesta
Richiesta HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri percorso | ||
calendarId |
string |
Identificatore di calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Se vuoi accedere al calendario principale dell'utente che ha eseguito l'accesso, usa "primary " parola chiave.
|
ruleId |
string |
Identificatore regola ACL. |
Parametri di query facoltativi | ||
sendNotifications |
boolean |
Indica se inviare notifiche sulla modifica della condivisione del calendario. Tieni presente che non ci sono notifiche sulla rimozione dell'accesso. (Facoltativo) Il valore predefinito è True. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
Ambito |
---|
https://www.googleapis.com/auth/calendar |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Nel corpo della richiesta, fornisci una risorsa ACL con le seguenti proprietà:
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
Proprietà obbligatorie | |||
scope |
object |
La misura in cui l'accesso al calendario viene concesso da questa regola ACL. | |
scope.type |
string |
Il tipo di ambito. I valori possibili sono:
default ", ovvero pubblico, si applicano a qualsiasi utente, autenticato o meno. |
|
Proprietà facoltative | |||
role |
string |
Il ruolo assegnato all'ambito. I valori possibili sono:
|
accessibile in scrittura |
scope.value |
string |
L'indirizzo email di un utente o di un gruppo oppure il nome di un dominio, a seconda del tipo di ambito. Omesso per il tipo "default ". |
accessibile in scrittura |
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa ACL nel corpo della risposta.
Esempi
Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).
Java
Utilizza la libreria client Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.AclRule; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Retrieve the access rule from the API AclRule rule = service.acl().get('primary', "ruleId").execute(); // Make a change rule.setRole("newRole"); // Update the access rule AclRule updatedRule = service.acl().update('primary', rule.getId(), rule).execute(); System.out.println(updatedRule.getEtag());
Python
Utilizza la libreria client Python.
rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute() rule['role'] = 'newRole' updated_rule = service.acl().update(calendarId='primary', ruleId=rule['id'], body=rule).execute() print updated_rule['etag']
PHP
Utilizza la libreria client PHP.
$rule = $service->acl->get('primary', 'ruleId'); $rule->setRole('newRole'); $updatedRule = $service->acl->update('primary', $rule->getId(), $rule); echo $updatedRule->getEtag();
Ruby
Utilizza la libreria client Ruby.
rule = client.get_acl('primary', 'ruleId') rule.role = 'newRole' result = client.update_acl('primary', rule.id, rule) print result.etag
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.