Directory API: ユーザーエイリアス

ユーザーエイリアスを作成する

ユーザーのエイリアスは、ユーザーのメインのメールアドレスと同じメールボックスを使用する予備のメールアドレスです。ユーザーエイリアスは、ユーザーのメインのメールアドレスで使用されているドメインとは別のアカウントドメインに関連付けることが可能です。24 時間以内（多くの場合、それよりも早く）に、ユーザーはこのアドレスに送信されたメールを受信できるようになります。この API では、ドメインの所有権を証明する前に、ユーザーエイリアスを作成する必要があります。エイリアスはゲストユーザーでは対象外です。

ユーザーエイリアスを作成するには、次の POST リクエストを使用し、リクエストを承認するで説明されている承認を含めます。userKey には、ユーザーのメインのメールアドレス、ユーザー id、ユーザーのエイリアスメールアドレスのいずれかを使用できます。リクエストとレスポンスのプロパティについては、API リファレンスをご覧ください。

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

JSON リクエスト

次の JSON リクエストは、ユーザーのエイリアスを作成するサンプルリクエストを示しています。ユーザーは liz@example.com で、エイリアスは chica@example.com です。

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

リクエストの本文に新しいエイリアス情報があります。

{  
 "alias": "chica@example.com"
}

成功すると、レスポンスとして HTTP 201 のステータスコードが返されます。レスポンスでは、ステータスコードとともに新しいユーザーエイリアスのプロパティが返されます。

ユーザーのエイリアスをすべて取得する

すべてのドメインのユーザーエイリアスをすべて取得するには、次の GET リクエストを使用し、リクエストを承認するで説明されている承認を含めます。userKey には、ユーザーのメインのメールアドレス、ユーザー id、ユーザーのエイリアスメールアドレスのいずれかを使用できます。リクエストとレスポンスのプロパティについては、API リファレンスをご覧ください。

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

たとえば、このリクエスト URI は、userKey liz@example.com のすべてのエイリアスを返します。

GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

すべてのユーザーエイリアスがアルファベット順で返されます。「すべてのエイリアスを取得する」のレスポンスに使用される maxResults クエリ文字列やページ分けなどのページサイズはありません。

JSON レスポンス

成功すると、レスポンスとして HTTP 200 のステータスコードが返されます。レスポンスでは、ステータスコードとともにユーザーのエイリアスがアルファベット順で返されます。以下のエイリアスドメインは、アカウントのプライマリドメインと他の複数のドメインです。

{
"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"
 }
]
}

ユーザーのエイリアスを削除する

ユーザーエイリアスを削除するには、次の DELETE リクエストを使用し、リクエストを承認するで説明されている承認を含めます。エイリアスが削除されるまでに最大 24 時間かかることがあります。 userKey には、ユーザーのメインのメールアドレス、ユーザー id、ユーザーのエイリアスメールアドレスのいずれかを使用できます。aliasId は、削除するエイリアスのメールアドレスです。リクエストとレスポンスのプロパティについては、 API リファレンスをご覧ください。

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

たとえば、この DELETE リクエストは、userKey liz@example.com のエイリアス chica@example.com を削除します。

DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

成功すると、レスポンスとして HTTP 200 のステータスコードが返されます。