Method: users.settings.cse.keypairs.list

인증된 사용자의 클라이언트 측 암호화 키 쌍을 나열합니다.

조직의 사용자에 대한 ID 및 키 쌍을 관리하는 관리자의 경우 요청에 https://www.googleapis.com/auth/gmail.settings.basic 범위로 사용자를 가장할 수 있는 도메인 전체 위임 권한이 있는 서비스 계정의 승인이 필요합니다.

자체 ID 및 키 쌍을 관리하는 사용자의 경우 요청에 하드웨어 키 암호화가 사용 설정되고 구성되어 있어야 합니다.

HTTP 요청

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs

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

경로 매개변수

매개변수
userId

string

요청자의 기본 이메일 주소입니다. 인증된 사용자를 나타내려면 특수 값 me를 사용할 수 있습니다.

쿼리 매개변수

매개변수
pageToken

string

반환할 키 쌍 페이지를 나타내는 페이징 토큰입니다. 토큰을 제공하지 않으면 API에서 결과의 첫 번째 페이지를 반환합니다.
pageSize

integer

반환할 키 쌍의 수입니다. 제공하지 않으면 페이지 크기는 기본적으로 20개의 항목으로 설정됩니다.

요청 본문

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

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "cseKeyPairs": [
    {
      object (CseKeyPair)
    }
  ],
  "nextPageToken": string
}
필드
cseKeyPairs[]

object (CseKeyPair)

사용자에게 설치된 CSE 키 쌍 목록의 한 페이지입니다.
nextPageToken

string

다음 키 쌍 페이지를 가져오기 위해 후속 keypairs.list 호출에 전달할 페이지 나누기 토큰입니다. 이 값이 반환되지 않으면 더 이상 페이지가 남아 있지 않은 것입니다.

승인 범위

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

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

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