Method: users.availability.markAsActive

Google Chat에서 사용자를 ACTIVE로 표시합니다.

사용자의 사용 가능 상태를 ACTIVE로 설정합니다. ACTIVE 상태는 지정된 만료 시점까지 지속되며, 이 시점에서 사용자의 상태는 AWAY가 됩니다. 사용자가 Chat을 활발하게 사용 중인 경우 ACTIVE 상태 기간이 제공된 만료 시점을 초과할 수 있습니다.

이 메서드는 인증된 사용자의 사용 가능 여부만 업데이트합니다.

승인 범위로 사용자 인증이 필요합니다.

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

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 활성으로 표시할 사용 가능 여부의 리소스 이름입니다. 형식: users/{user}/availability

{user}는 People API 또는 Admin SDK Directory API의 사용자 ID입니다. 예를 들어 users/123456789입니다.

사용자의 이메일 주소 또는 me를 별칭으로 사용하여 호출자를 참조할 수도 있습니다. 예를 들어 users/user@example.com 또는 users/me입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{

  "expireTime": string,
  "ttl": string
}
필드
통합 필드 expiration. 활성 사용 가능 상태의 만료입니다. 만료 후 사용자는 자리 비움으로 표시됩니다. 만료가 제공되지 않으면 활성 상태는 현재 시간으로부터 30분 후에 만료됩니다. expiration은 다음 중 하나여야 합니다.
expireTime

string (Timestamp format)

활성 상태가 만료되는 절대 타임스탬프입니다.
ttl

string (Duration format)

활성 상태가 만료될 때까지의 현재 시간부터의 기간입니다. 짧은 TTL을 사용하면 이 짧은 기간이 지난 후 사용자의 상태를 활동을 기반으로 효과적으로 재설정할 수 있습니다.

응답 본문

성공한 경우 응답 본문에 Availability의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

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