Method: users.availability.get

Google Chat のユーザーの空き情報を返します。たとえば、ユーザーがオンラインか離席中かを確認したり、カスタム ステータス メッセージを取得したりするために使用できます。

このメソッドは、認証されたユーザーの空き状況のみを取得します。

次のいずれかの認可スコープを使用したユーザー認証が必要です。

  • https://www.googleapis.com/auth/chat.users.availability.readonly
  • https://www.googleapis.com/auth/chat.users.availability

HTTP リクエスト

GET https://chat.googleapis.com/v1/{name=users/*/availability}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。取得する可用性のリソース名。

形式: users/{user}/availability

{user} は、People API または Admin SDK Directory API の Person の ID です。例: users/123456789

ユーザーのメールアドレスまたは me を、発信者を指すエイリアスとして使用することもできます。たとえば、users/user@example.com や users/me です。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には Availability のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.users.availability
  • https://www.googleapis.com/auth/chat.users.availability.readonly

詳しくは、承認ガイドをご覧ください。