Method: spaces.members.get

멤버십에 대한 세부정보를 반환합니다. 예를 보려면 사용자 또는 Google Chat 앱의 멤버십에 관한 세부정보 가져오기를 참고하세요.

다음 유형의 인증을 지원합니다.

  • 승인 범위가 있는 앱 인증:

    • https://www.googleapis.com/auth/chat.bot

  • 다음 승인 범위 중 하나를 사용하여 사용자 인증:

    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships
    • 관리자 계정이 인증되고, useAdminAccess가 true이고, 다음 승인 범위 중 하나가 사용될 때 사용자 인증으로 관리자 권한이 부여됩니다.
      • https://www.googleapis.com/auth/chat.admin.memberships.readonly
      • https://www.googleapis.com/auth/chat.admin.memberships

HTTP 요청

GET https://chat.googleapis.com/v1/{name=spaces/*/members/*}

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 검색할 멤버십의 리소스 이름입니다.

사용자 인증을 사용하여 앱 자체 멤버십을 가져오려면 원하는 경우 spaces/{space}/members/app를 사용하면 됩니다.

형식: spaces/{space}/members/{member} 또는 spaces/{space}/members/app

사용자의 이메일을 {member}의 별칭으로 사용할 수 있습니다. 예를 들어 spaces/{space}/members/example@gmail.com에서 example@gmail.com은 Google Chat 사용자의 이메일입니다.

쿼리 매개변수

매개변수
useAdminAccess

boolean

선택사항입니다. true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.memberships 또는 chat.admin.memberships.readonly OAuth 2.0 범위가 필요합니다.

관리 액세스를 사용하는 경우 스페이스에서 앱 멤버십을 가져오는 기능은 지원되지 않습니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

승인 범위

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

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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