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 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 가져올 대화 가능 여부의 리소스 이름입니다.

형식: users/{user}/availability

{user}는 People API 또는 Admin SDK 디렉터리 API의 사용자 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

자세한 내용은 승인 가이드를 참고하세요.