Acl: insert

Erstellt eine Zugriffssteuerungsregel. Probieren Sie es jetzt aus oder sehen Sie sich ein Beispiel an.

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID. Rufen Sie zum Abrufen von Kalender-IDs die Methode calendarList.list auf. Wenn Sie auf den Hauptkalender des derzeit angemeldeten Nutzers zugreifen möchten, verwenden Sie die „primary“ Keyword.
Optionale Abfrageparameter
sendNotifications boolean Gibt an, ob Benachrichtigungen über die Änderung der Kalenderfreigabe gesendet werden sollen. Optional. Der Standardwert ist „True“.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:

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

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

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

Property-Name Wert Beschreibung Hinweise
Erforderliche Attribute
role string Die dem Bereich zugewiesene Rolle. Mögliche Werte sind:
  • „none“ – Es gibt keinen Zugriff.
  • „freeBusyReader“ – Bietet Lesezugriff auf Verfügbarkeitsinformationen.
  • „reader“ – Bietet Lesezugriff auf den Kalender. Private Termine werden Nutzern mit Lesezugriff angezeigt, die Termindetails werden jedoch ausgeblendet.
  • „writer“ – Bietet Lese- und Schreibzugriff auf den Kalender. Private Termine werden Nutzern mit Schreibberechtigung angezeigt und Termindetails werden angezeigt.
  • „owner“ – Eigentümer des Kalenders Diese Rolle verfügt über alle Berechtigungen der Rolle „Writer“, bietet zusätzlich die Möglichkeit, ACLs aufzurufen und zu bearbeiten.
 Bearbeitbar
scope object Der Umfang, in dem durch diese ACL-Regel Kalenderzugriff gewährt wird.
scope.type string Der Typ des Bereichs. Mögliche Werte sind:
  • „default“ – Öffentlicher Geltungsbereich „Immer“ ist der Standardwert.
  • „user“ – Beschränkt den Bereich auf einen einzelnen Nutzer.
  • „group“ – Beschränkt den Bereich auf eine Gruppe.
  • „domain“ – Beschränkt den Bereich auf eine Domain.
Hinweis: Die Berechtigungen, die dem Bereich „default“ (öffentlich) gewährt wurden, gelten für jeden authentifizierten oder nicht authentifizierten Nutzer.
Optionale Attribute
scope.value string Die E-Mail-Adresse eines Nutzers oder einer Gruppe oder der Name einer Domain, je nach Bereichstyp. Ausgelassen für Typ "default". Bearbeitbar

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Acl-Ressource im Antworttext zurückgegeben.

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.