REST Resource: customers.quarantinedMessages

리소스: QuarantinedMessage

QuarantinedMessage 리소스는 관리 스팸 격리 저장소에 보관된 이메일 메시지를 나타냅니다.

JSON 표현 
{
  "name": string,
  "messageId": string,
  "messageOwner": string,
  "quarantines": [
    string
  ],
  "receiveTime": string,
  "direction": enum (Direction),
  "state": enum (State),
  "retentionExpireTime": string,
  "triggeredRules": [
    {
      object (TriggeredRule)
    }
  ],
  "content": {
    object (MessageContent)
  },
  "rawMessage": string
}
필드
name

string

식별자. 스팸으로 분류된 메일의 리소스 이름입니다. 형식: customers/{customer_id}/quarantinedMessages/{quarantined_message_id}
messageId

string

출력 전용입니다. 기본 Gmail 메일의 변경할 수 없는 ID입니다.
messageOwner

string

출력 전용입니다. 이 메일 소유자의 이메일 주소입니다.
quarantines[]

string

출력 전용입니다. 이 메일이 속한 스팸 격리 저장소의 리소스 이름입니다. 형식: customers/{customer_id}/quarantines/{quarantine_id}
receiveTime

string (Timestamp format)

출력 전용입니다. 메시지가 수신된 시점의 타임스탬프입니다.
direction

enum (Direction)

출력 전용입니다. 메시지 방향(예: INBOUND, OUTBOUND)
state

enum (State)

출력 전용입니다. 메시지의 현재 처리 상태입니다.
retentionExpireTime

string (Timestamp format)

출력 전용입니다. 이 메시지가 보관되는 타임스탬프입니다.
triggeredRules[]

object (TriggeredRule)

출력 전용입니다. 스팸 격리를 유발한 규칙에 관한 정보입니다.
content

object (MessageContent)

출력 전용입니다. 스팸으로 분류된 이메일의 세부 콘텐츠 및 메타데이터입니다.
rawMessage

string (bytes format)

출력 전용입니다. RFC 2822 형식 및 base64url로 인코딩된 문자열의 전체 이메일 메시지입니다. RAW 콘텐츠 유형이 선택된 경우 이를 반환합니다.

방향

메시지의 방향입니다.

열거형
DIRECTION_UNSPECIFIED 지정되지 않음.
INBOUND 사용자가 스팸으로 분류된 메일을 수신했습니다.
OUTBOUND 스팸 격리 저장소에 보관된 메일은 사용자가 보낸 메일입니다.

주

메시지의 현재 처리 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않음.
PENDING_TRIAGE 메일이 스팸 격리 저장소에 있습니다.
RELEASED 메일이 스팸 격리 저장소에서 해제되었습니다.
DENIED 스팸 격리 저장소에 있는 동안 메일이 거부되었습니다.

TriggeredRule

메일이 스팸으로 분류되도록 한 특정 규칙에 대한 정보입니다.

JSON 표현 
{
  "policyId": string,
  "ruleId": string,
  "displayName": string
}
필드
policyId

string

설정된 규칙과 관련된 정책 ID입니다.
ruleId

string

설정된 특정 규칙의 ID입니다.
displayName

string

설정된 규칙의 이름 또는 설명입니다.

MessageContent

스팸으로 분류된 이메일 메시지의 콘텐츠에 대한 세부정보입니다.

JSON 표현 
{
  "headers": [
    {
      object (Header)
    }
  ],
  "attachments": [
    {
      object (Attachment)
    }
  ],
  "body": string,
  "subject": string,
  "labels": [
    string
  ],
  "classificationLabelValues": [
    {
      object (ClassificationLabelValue)
    }
  ]
}
필드
headers[]

object (Header)

이메일 메시지의 헤더입니다.
attachments[]

object (Attachment)

이메일 메시지 내에서 발견된 첨부파일입니다.
body

string

이메일 메시지의 일반 텍스트 본문 또는 스니펫입니다.
subject

string

이메일 메시지의 제목입니다.
labels[]

string

메일에 적용된 표준 라벨입니다(예: 'QUARANTINE').
classificationLabelValues[]

object (ClassificationLabelValue)

메일에 적용된 분류 라벨 값입니다. Google Workspace 계정에만 표시됩니다.

첨부파일

이메일 메시지 내 첨부파일

JSON 표현 
{
  "filename": string,
  "mimeType": string,
  "sizeBytes": string,
  "attachmentId": string
}
필드
filename

string

첨부파일의 파일 이름입니다.
mimeType

string

첨부파일의 MIME 유형입니다(예: 'application/pdf').
sizeBytes

string (int64 format)

첨부파일의 크기(바이트)입니다.
attachmentId

string

첨부파일의 콘텐츠를 가져오는 데 사용되는 고유 식별자입니다.

ClassificationLabelValue

이메일에 적용된 분류 라벨

JSON 표현 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
필드
labelId

string

표준 또는 원시 영숫자 분류 라벨 ID입니다.
fields[]

object (ClassificationLabelFieldValue)

지정된 분류 라벨 ID의 필드 값입니다.

ClassificationLabelFieldValue

분류 라벨의 필드 값입니다.

JSON 표현 
{
  "fieldId": string,
  "selection": string
}
필드
fieldId

string

분류 라벨 값의 필드 ID입니다.
selection

string

선택 옵션의 선택 항목 ID입니다.

메서드

batchDeny

 메시지 목록을 비동기식으로 거부합니다.

batchRelease

 메시지 목록을 비동기식으로 해제합니다.

deny

 스팸 격리 저장소에서 메일을 거부합니다.

get

 스팸으로 분류된 메일의 메타데이터와 콘텐츠를 가져옵니다.

list

 특정 필터 조건을 사용하여 스팸으로 분류된 메일을 쿼리합니다.

release

 수신자에게 전송할 메일을 스팸 격리 저장소에서 해제합니다.
특정 검색어를 사용하여 스팸으로 분류된 메일을 검색합니다.