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/aliasesDer 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/aliasIdMit 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.