Method: users.history.list

string

사용자의 이메일 주소 특수 값 me는 인증된 사용자를 나타내는 데 사용할 수 있습니다.

integer (uint32 format)

반환할 기록 레코드의 최대 개수입니다. 이 필드의 기본값은 100입니다. 이 필드에 허용되는 최댓값은 500입니다.

string

목록에서 특정 결과 페이지를 검색하는 페이지 토큰입니다.

string

필수 항목입니다. 지정된 startHistoryId 이후의 기록 레코드를 반환합니다. 제공된 startHistoryId는 메시지, 스레드 또는 이전 list 응답의 historyId에서 가져와야 합니다. 기록 ID는 시간순으로 증가하지만 유효한 ID 사이에 임의의 공백이 인접하지 않습니다. 유효하지 않거나 오래된 startHistoryId를 제공하면 일반적으로 HTTP 404 오류 코드가 반환됩니다. historyId는 일반적으로 일주일 이상 유효하지만 드물게 몇 시간 동안만 유효한 경우도 있습니다. HTTP 404 오류 응답이 발생하면 애플리케이션에서 전체 동기화를 수행해야 합니다. 응답에 nextPageToken가 수신되지 않으면 가져올 업데이트가 없으며 향후 요청을 위해 반환된 historyId을 저장할 수 있습니다.

string

ID와 일치하는 라벨이 있는 메일만 반환합니다.

enum (HistoryType)

함수에서 반환할 기록 유형

{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "messagesAdded": [
    {
      object (MessageAdded)
    }
  ],
  "messagesDeleted": [
    {
      object (MessageDeleted)
    }
  ],
  "labelsAdded": [
    {
      object (LabelAdded)
    }
  ],
  "labelsRemoved": [
    {
      object (LabelRemoved)
    }
  ]
}

string

편지함 순서 ID입니다.

object (Message)

이 기록에서 변경된 메시지 목록입니다. messagesAdded와 같은 특정 변경 유형의 입력란은 이 입력란에 중복된 메시지가 있을 수 있습니다. 이 필드 대신 구체적인 변경 유형 필드를 사용하는 것이 좋습니다.

object (MessageAdded)

이 기록 레코드의 편지함에 추가된 메일입니다.

object (MessageDeleted)

기록 레코드의 편지함에서 삭제된 메일 (휴지통이 아님)입니다.

object (LabelAdded)

이 기록 레코드의 메시지에 추가된 라벨입니다.

object (LabelRemoved)

이 기록의 메시지에서 라벨이 삭제되었습니다.

{
  "message": {
    object (Message)
  }
}

object (Message)

{
  "message": {
    object (Message)
  }
}

object (Message)

{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}

object (Message)

string

메시지에 추가된 라벨 ID입니다.

{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}

object (Message)

string

메일에서 라벨 ID를 삭제했습니다.