Gibt die Regeln in der Access Control List für den Kalender zurück. Probieren Sie es aus oder sehen Sie sich ein Beispiel an.
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/acl
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
calendarId |
string |
Kalender-ID. Rufen Sie die Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Schlüsselwort „primary “.
|
Optionale Abfrageparameter | ||
maxResults |
integer |
Maximale Anzahl der auf einer Ergebnisseite zurückgegebenen Einträge. Der Wert ist standardmäßig 100 Einträge. Die Seitengröße darf nicht größer als 250 Einträge sein. Optional. |
pageToken |
string |
Token, das angibt, welche Ergebnisseite zurückgegeben werden soll. Optional. |
showDeleted |
boolean |
Gibt an, ob gelöschte ACLs in das Ergebnis aufgenommen werden sollen. Gelöschte ACLs werden durch role dargestellt, die gleich "none " sind. Gelöschte ACLs sind immer eingeschlossen, wenn syncToken angegeben ist. Optional. Die Standardeinstellung ist "False".
|
syncToken |
string |
Token aus dem Feld nextSyncToken , das auf der letzten Ergebnisseite der vorherigen Listenanfrage zurückgegeben wurde. Das Ergebnis dieser Listenanfrage enthält dann nur Einträge, die sich seitdem geändert haben. Alle seit der vorherigen Listenanfrage gelöschten Einträge befinden sich immer in der Ergebnismenge und dürfen showDeleted nicht auf „False“ gesetzt werden. Wenn die syncToken abläuft, antwortet der Server mit dem Antwortcode 410 GONE. Der Client sollte dann seinen Speicher leeren und eine vollständige Synchronisierung ohne syncToken durchführen. Weitere Informationen zur inkrementellen Synchronisierung. Optional. Standardmäßig werden alle Einträge zurückgegeben. |
Autorisierung
Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/calendar |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "calendar#acl", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ acl Resource ] }
Name der Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
kind |
string |
Typ der Sammlung („calendar#acl “) |
|
etag |
etag |
Das ETag der Sammlung. | |
nextPageToken |
string |
Token für den Zugriff auf die nächste Seite dieses Ergebnisses. Ausgelassen, wenn keine weiteren Ergebnisse verfügbar sind; in diesem Fall wird nextSyncToken angegeben. |
|
items[] |
list |
Liste der Regeln in der Access Control List. | |
nextSyncToken |
string |
Token, das zu einem späteren Zeitpunkt verwendet wird, um nur die Einträge abzurufen, die sich seit der Rückgabe dieses Ergebnisses geändert haben. Ausgelassen, wenn weitere Ergebnisse verfügbar sind. In diesem Fall wird nextPageToken angegeben. |
Beispiele
Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.
Java
Verwendet die Java-Clientbibliothek.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Acl; 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(); // Iterate over a list of access rules Acl acl = service.acl().list('primary').execute(); for (AclRule rule : acl.getItems()) { System.out.println(rule.getId() + ": " + rule.getRole()); }
Python
Verwendet die Python-Clientbibliothek.
acl = service.acl().list(calendarId='primary').execute() for rule in acl['items']: print '%s: %s' % (rule['id'], rule['role'])
PHP
Verwendet die PHP-Clientbibliothek.
$acl = $service->acl->listAcl('primary'); foreach ($acl->getItems() as $rule) { echo $rule->getId() . ': ' . $rule->getRole(); }
Ruby
Verwendet die Ruby-Clientbibliothek.
result = client.list_acls('primary') result.items.each do |e| print e.id + ": " + e.role + "\n" end
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.