Directory API: Nutzeraliasse

Nutzer-Alias erstellen

Der Alias eines Nutzers ist eine alternative E-Mail-Adresse, die dasselbe Postfach wie das des Nutzers verwendet. primäre E-Mail-Adresse. Ein Nutzer-Alias kann auch mit einer anderen Kontodomain verknüpft sein. Domain, die von der primären E-Mail-Adresse des Nutzers verwendet wird. Innerhalb von 24 Stunden (häufig früher) beginnt der Nutzer an diese Adresse gesendete E-Mails. Für die API muss der Parameter Inhaberschaft der Domain bestätigt ist bevor Sie das Nutzer-Alias erstellen können.

Verwenden Sie zum Erstellen eines Nutzer-Alias die folgende POST-Anfrage und fügen Sie die unter Anfragen autorisieren beschriebene Autorisierung ein. Die userKey kann die primäre E-Mail-Adresse des Nutzers, der Nutzer id oder ein beliebiger der Nutzer-Aliasse sein. E-Mails. In der API-Referenz finden Sie Informationen zu den Anfrage- und Antwortattributen:

POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases

JSON-Anfrage

Die folgende JSON-Anfrage zeigt eine Beispielanfrage zum Erstellen eines Nutzeralias. Der Nutzer ist liz@beispiel.de und der Alias lautet schnee@beispiel.de:

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
Der Anfragetext enthält die neuen Aliasinformationen:
{  
 "alias": "chica@example.com"
}

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 201 zurückgegeben. Zusammen mit dem Statuscode werden in der Antwort die Eigenschaften für den neuen Nutzeralias zurückgegeben.

Alle Aliasse eines Nutzers abrufen

Um alle Aliasse eines Nutzers für alle Domains abzurufen, verwenden Sie die folgende GET-Anfrage und fügen Sie die unter Anfragen autorisieren beschriebene Autorisierung ein. Die userKey kann die primäre E-Mail-Adresse des Nutzers, der Nutzer id oder ein beliebiger der Nutzer-Aliasse sein. E-Mails. In der API-Referenz finden Sie Informationen zu den Anfrage- und Antwortattributen:

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
Diese Anforderungs-URI gibt beispielsweise alle Aliasnamen für den userKey, liz@beispiel.de, zurück:
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

Alle Nutzeraliasse werden in alphabetischer Reihenfolge zurückgegeben. Für „Alle Aliasse abrufen“ wird keine Seitengröße wie der Abfragestring maxResults oder eine Paginierung verwendet. Antwort.

JSON-Antwort

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. Zusammen mit dem Statuscode gibt die Antwort die Aliase des Nutzers in alphabetischer Reihenfolge zurück. Diese Alias-Domains sind die primäre Domain und weitere Domains im Konto:

{
"kind": "directory#user#aliases",
"aliases": [
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "chica@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "support@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "help@hr.example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "tickets@jumboinc.com"
 }
]
}

Alias eines Nutzers löschen

Um einen Nutzer-Alias zu löschen, verwenden Sie die folgende DELETE-Anfrage und fügen Sie den Autorisierung gemäß den Anfragen autorisieren. Es kann bis zu bis das Alias entfernt wird. Die userKey kann die primäre E-Mail-Adresse des Nutzers, der Nutzer id oder eine der folgenden Optionen sein: der Nutzeraliasse E-Mails. Und aliasId ist der Alias E-Mail-Adresse des Nutzers gelöscht. Informationen zu den Anfrage- und Antwortattributen finden Sie in der API-Referenz

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
Mit dieser DELETE-Anfrage wird beispielsweise das Alias schickea@beispiel.de für den userKey liz@beispiel.de gelöscht:
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben.