Acl: insert

Erstellt eine Zugriffssteuerungsregel. Jetzt testen oder Beispiel ansehen

Anfrage

HTTP-Anfrage

POST 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 primären Kalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary“.
Optionale Suchparameter
sendNotifications boolean Ob Benachrichtigungen über die Änderung der Kalenderfreigabe gesendet werden sollen. Optional. Der Standardwert ist „True“.

Autorisierung

Diese Anfrage erfordert eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

Umfang
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext eine ACL-Ressource mit den folgenden Eigenschaften an:

Property-Name Wert Beschreibung Hinweise
Erforderliche Properties
role string Die Rolle, die dem Umfang zugewiesen ist. Mögliche Werte sind:
  • „none“: Bietet keinen Zugriff.
  • „freeBusyReader“: Bietet Lesezugriff auf Informationen zur Verfügbarkeit.
  • „reader“: Bietet Lesezugriff auf den Kalender. Private Termine werden Nutzern mit Lesezugriff angezeigt, Termindetails werden jedoch ausgeblendet.
  • „writer“: Gewährt Lese- und Schreibzugriff auf den Kalender. Private Termine werden Nutzern mit Schreibzugriff angezeigt und die Termindetails sind sichtbar.
  • „owner“: Gibt die Inhaberschaft des Kalenders an. Diese Rolle hat alle Berechtigungen der Rolle „Bearbeiter“ und zusätzlich die Möglichkeit, ACLs aufzurufen und zu bearbeiten.
 Bearbeitbar
scope object Der Umfang, in dem Kalenderzugriff durch diese ACL-Regel gewährt wird.
scope.type string Der Typ des Gültigkeitsbereichs. Mögliche Werte sind:
  • „default“ – öffentlicher Bereich. „Immer“ ist der Standardwert.
  • „user“: Der Umfang wird auf einen einzelnen Nutzer beschränkt.
  • „group“: Der Umfang wird auf eine Gruppe beschränkt.
  • „domain“: Der Umfang wird auf eine Domain beschränkt.
Hinweis: Die Berechtigungen, die dem Bereich „default“ (öffentlich) gewährt wurden, gelten für alle Nutzer, unabhängig davon, ob sie authentifiziert sind oder nicht.
Optionale Eigenschaften
scope.value string Die E-Mail-Adresse eines Nutzers oder einer Gruppe oder der Name einer Domain, je nach Umfang. Für den Typ „default“ wird dieser Wert nicht berücksichtigt. Bearbeitbar

Antwort

Bei Erfolg gibt diese Methode eine Acl-Ressource im Antworttext zurück.

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.AclRule;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Create access rule with associated scope
AclRule rule = new AclRule();
Scope scope = new Scope();
scope.setType("scopeType").setValue("scopeValue");
rule.setScope(scope).setRole("role");

// Insert new access rule
AclRule createdRule = service.acl().insert('primary', rule).execute();
System.out.println(createdRule.getId());

Python

Verwendet die Python-Clientbibliothek.

rule = {
    'scope': {
        'type': 'scopeType',
        'value': 'scopeEmail',
    },
    'role': 'role'
}

created_rule = service.acl().insert(calendarId='primary', body=rule).execute()

print created_rule['id']

PHP

Verwendet die PHP-Clientbibliothek.

$rule = new Google_Service_Calendar_AclRule();
$scope = new Google_Service_Calendar_AclRuleScope();

$scope->setType("scopeType");
$scope->setValue("scopeValue");
$rule->setScope($scope);
$rule->setRole("role");

$createdRule = $service->acl->insert('primary', $rule);
echo $createdRule->getId();

Ruby

Verwendet die Ruby-Clientbibliothek.

rule = Google::Apis::CalendarV3::AclRule.new(
  scope: {
    type: 'scopeType',
    value: 'scopeEmail',
  },
  role: 'role'
)
result = client.insert_acl('primary', rule)
print result.id

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.