다음을 통해 공유


Gmail

Gmail은 Google의 웹 기반 전자 메일 서비스입니다. Gmail 커넥터를 사용하면 전자 메일 메시지 보내기 또는 받기와 같은 작업을 수행하고 새 전자 메일에서 흐름을 트리거할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://mail.google.com/mail/
개인 정보 보호 정책 https://policies.google.com/privacy

인증 및 사용자 고유의 애플리케이션 가져오기

이제 Gmail 커넥터는 여러 인증 유형을 지원합니다.

  • 기본 공유 애플리케이션 사용
  • 사용자 고유의 애플리케이션 가져오기

기본 공유 애플리케이션은 Microsoft에서 유지 관리하는 Google 클라이언트 애플리케이션을 사용합니다. 이 경우 Gmail 계정에 로그인하면 Microsoft Power Platform 애플리케이션에 동의하라는 메시지가 표시됩니다.

"사용자 고유의 애플리케이션 가져오기" 옵션을 사용하면 Microsoft에서 관리하는 애플리케이션 대신 사용자 고유의 Google OAuth 클라이언트 애플리케이션을 사용할 수 있습니다. 이렇게 하면 사용 권한을 제어하고 커넥터 사용에 대한 특정 제한을 사용하도록 설정할 수 있습니다.

Gmail 커넥터에서 고유한 Google OAuth 클라이언트 애플리케이션을 사용하려면 다음 단계를 수행해야 합니다.

  1. Google의 API 콘솔을 사용하여 OAuth 클라이언트 애플리케이션 만들기
  2. Gmail 커넥터에서 애플리케이션 사용

Google에서 OAuth 클라이언트 애플리케이션 만들기

고유한 Google OAuth 클라이언트 애플리케이션을 만들려면 먼저 로그인해야 합니다 https://developer.google.com. Google API에 대한 액세스를 관리할 수 있는 Google의 API 콘솔로 이동하여 OAuth 애플리케이션을 만듭니다. 이 프로세스는 Google의 Gmail API 개발자 가이드에 설명되어 있습니다. Google은 프로젝트를 만들고, 프로젝트에 Gmail API를 사용하도록 설정하고, OAuth 클라이언트 애플리케이션 및 자격 증명을 만드는 프로세스를 안내하는 설치 도구를 제공합니다. 도구를 사용할 때 유용하게 사용할 수 있는 몇 가지 정보는 다음과 같습니다.

  • 필요한 경우 서비스 약관을 읽고 동의합니다.
  • 기존 프로젝트를 선택하거나 도구에서 "내 프로젝트"라는 새 프로젝트를 만듭니다.
  • 이 도구는 프로젝트에서 Gmail API를 사용하도록 설정합니다.
  • 도구는 필요한 자격 증명 유형을 찾으려고 시도합니다. OAuth 클라이언트 애플리케이션을 가져와야 합니다.
    • 사용할 API에 대해 Gmail API 를 선택합니다(아직 선택하지 않은 경우).
    • API를 호출할 위치에 대한 웹 서버를 선택합니다.
    • 액세스할 데이터에 대한 사용자 데이터를 선택합니다.
  • 이 도구는 OAuth 동의 화면 설정을 안내합니다.
    • 사용자 유형(내부 또는 외부)을 선택합니다. Gmail 소비자 계정을 사용하는 경우 내부 계정을 선택할 수 없습니다.
    • 애플리케이션에 대한 이름 및 로고(선택 사항)를 제공합니다.
    • 범위 추가를 클릭하고 Gmail 범위(https://mail.google.com)를 추가합니다.

      비고

      사용량에 따라 여기에서 사용 권한 범위의 적절한 하위 집합을 선택할 수 있습니다.

    • azure-apim.net 권한 있는 도메인 중 하나로 추가합니다.

      비고

      여기에 정의된 대로 Gmail 커넥터가 호스트되는 도메인입니다.

    • 필요에 따라 다른 정보를 제공합니다.
  • 이 도구를 사용하면 OAuth 2.0 클라이언트 자격 증명을 정의하고 추가할 수 있습니다.
    • OAuth 클라이언트 애플리케이션의 이름을 제공합니다.
    • "https://global.consent.azure-apim.net/redirect"를 추가합니다. 리디렉션 URI의 경우

완료되면 자격 증명 페이지에서 만든 OAuth 클라이언트로 이동합니다. 앱의 클라이언트 ID클라이언트 비밀을 찾을 수 있습니다. 이제 Gmail 연결에서 해당 값을 사용할 수 있습니다.

Google OAuth 클라이언트

Gmail 커넥터에서 사용자 고유의 애플리케이션 사용

Google OAuth 클라이언트 애플리케이션을 만든 후에는 Gmail 연결을 만드는 동안 사용할 수 있습니다.

  • 사용자 고유의 애플리케이션 가져오기를 선택합니다.
  • 애플리케이션에서 클라이언트 ID 및 클라이언트 비밀 값을 지정합니다.

로그인을 클릭하여 Gmail 계정에 로그인합니다. 그러면 Gmail 계정에 로그인한 다음 위에서 만든 Google 앱에 대한 액세스 권한을 부여하라는 메시지가 표시됩니다.

알려진 문제 및 제한 사항

많은 수의 들어오는 전자 메일에 대한 트리거 제한 사항

새 전자 메일이 도착하는 경우 트리거는 30초 간격당 300개 이상의 전자 메일을 수신하는 경우 전자 메일을 건너뛸 수 있습니다. 메일 수를 줄이기 위해 추가 필터 매개 변수를 사용하여 흐름을 구성하는 것이 좋습니다.

새 전자 메일이 도착하면 Google Workspace(이전의 G Suite) 계정을 사용하는 경우 첨부 파일이 있는 전자 메일을 간헐적으로 건너뛸 수 있습니다. 경우에 따라 Gmail API 가 전자 메일을 처리하는 데 시간이 오래 걸리기 때문에(첨부 파일의 보안 검색으로 인해) 일정한 지연으로 전자 메일이 수신되기 때문입니다.

가능한 한 다음을 시도해 보세요.

  • 작은 전자 메일(첨부 파일 없음)을 사용하여 자주 보내지 않도록 합니다.

  • 다른 소비자 Gmail 계정을 사용하고 Google Workspace 계정에서 이 새 소비자 Gmail 계정으로 자동 전달을 구성합니다. 이 새 계정에 대해 트리거를 구성합니다. 이는 소비자 계정이므로 지연이 최소화되고 트리거가 이러한 이메일을 건너뛰지 않을 것이라고 생각합니다.

  • 매개 변수를 사용하여 ListMessage API사용자 지정 커넥터q 사용합니다.

    • 지난 5분 동안 메시지를 나열하는 작업을 만듭니다. 매개 변수를 사용하여 q 수행할 수 있습니다. 매개 변수 값의 q 예 - after:1649457986. 작업 입력으로 epoch 시간을 제공해야 current time - 5min 합니다.

      • 1649457986 "2022년 4월 8일 금요일 오후 3:46:26 GMT-07:00"을 나타내는 epoch 시간입니다.
    • 응답에서 비어 있는 값이 될 때까지 nextPageToken 값을 확인합니다. 비어 있지 않으면 응답에서 매개 변수 값이 nextPageToken으로 pageToken 설정된 동일한 API를 호출해야 합니다. 예를 들어 "Until" 루프 를 사용하여 이 작업을 수행할 수 있습니다.

    • 이전 실행에서 이미 처리된 메시지 ID를 필터링합니다(예: Azure Table Storage 커넥터를 사용하여 이미 처리된 ID를 저장할 수 있음).

    • 전자 메일 세부 정보 가져오기 작업을 사용하여 ID로 전자 메일 콘텐츠 가져오기

소비자 Gmail 계정으로 Gmail 커넥터 사용

Google의 보안 및 개인 정보 보호 정책에 따라 소비자 Gmail 계정을 사용하는 고객(계정이 종료 @gmail.com 되고 Power Automate 및 @googlemail.com) Logic Apps 내의 제한된 서비스 집합에만 연결할 수 있습니다.) Google Workspace(이전의 G Suite) 계정을 사용하는 고객은 이 변경의 영향을 받지 않습니다. 아래 목록에 지정되지 않은 서비스와 함께 Gmail 커넥터를 사용해야 하는 경우 Google에 사용자 고유의 애플리케이션 ID를 등록해야 합니다. 다음은 현재 승인된 서비스 목록입니다. 이 목록은 Google의 정책에 따라 향후 변경될 수 있습니다.

  • Google 서비스: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
  • 기본 제공 작업 및 트리거: 컨트롤, AI Builder, 데이터 작업, 날짜 시간, 숫자 함수, Power Virtual Agents, Power Apps, 요청, 일정, 텍스트 함수, 변수, 흐름 단추, 위치
  • 제한된 Microsoft 서비스 집합: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP 및 FTP

Power Automate에서 비준수 서비스를 사용하여 흐름을 만들면 흐름이 비활성화된 상태로 저장됩니다.

작업 단위 계산

커넥터에는 하루에 사용할 수 있는 작업 단위 수에 대한 제한 제한( 여기 참조)이 있습니다.

각 작업에 대해 이러한 작업 단위를 계산하는 방법에 대한 논리는 다음과 같습니다.

  • 새 전자 메일이 도착하는 경우 : 10 + (5 * attachmentsCount);
    • 트리거가 새 전자 메일을 반환하는 경우: 메시지를 나열하는 5개 단위 + 메시지를 가져오기 위한 5단원 + 5단원 * 첨부 파일 수입니다.
    • 트리거가 새 전자 메일을 반환하지 않는 경우: 메시지를 나열하는 5개 단위입니다.
  • 이메일 보내기(V2) 작업: 100단원.
  • 전자 메일에 회신(V2) 작업: 105 + (5 * attachmentsCount);
    • 원본 메시지를 가져올 5개 단위 + 회신 메시지를 보내는 데 100개 단위 + 5단원 * 원본 메시지의 인라인 첨부 파일 수입니다.
  • 다른 모든 작업의 경우: 10단원.

커넥터 심층 분석

커넥터에 대한 자세한 내용은 자세한 섹션을 참조하세요.

일반 제한

이름 가치
최대 메일 크기(MB) 35
최대 첨부 파일 크기(MB) 30

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

사용자 고유의 애플리케이션 가져오기 사용자 고유의 Google 앱을 사용하여 로그인합니다. 자세한 내용은 https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application참조하세요. 모든 지역 공유할 수 없음
기본 공유 애플리케이션 사용 표준 Google 앱을 사용하여 로그인합니다. 모든 지역 공유할 수 없음
기본값 [사용되지 않음] 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. 모든 지역 공유할 수 없음

사용자 고유의 애플리케이션 가져오기

인증 ID: byoa

적용 가능: 모든 지역

사용자 고유의 Google 앱을 사용하여 로그인합니다. 자세한 내용은 https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application참조하세요.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
클라이언트 ID 문자열 Google 애플리케이션의 클라이언트(또는 애플리케이션) ID 진실
클라이언트 암호 시큐어스트링 (보안 문자열) Google 애플리케이션의 클라이언트 비밀 진실

기본 공유 애플리케이션 사용

인증 ID: shared-application

적용 가능: 모든 지역

표준 Google 앱을 사용하여 로그인합니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

기본값 [사용되지 않음]

적용 가능: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 60 60초
일일 작업 단위 90000 86400초

동작

전자 메일 보내기(V2)

이 작업은 특정 받는 사람에게 전자 메일을 보내는 데 사용됩니다.

전자 메일 보내기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 이메일 보내기(V2) 를 사용하세요.

이 작업은 특정 받는 사람에게 전자 메일을 보내는 데 사용됩니다.

전자 메일 삭제

이 작업은 특정 전자 메일을 영구적으로 삭제하는 데 사용됩니다.

전자 메일 세부 정보 가져오기

이 작업은 특정 전자 메일의 세부 정보를 검색합니다.

전자 메일에 회신(V2)

이 작업은 특정 전자 메일에 회신하는 데 사용됩니다.

전자 메일에 회신[사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 전자 메일에 회신(V2) 을 사용하세요.

이 작업은 특정 전자 메일에 회신하는 데 사용됩니다.

전자 메일을 휴지통으로 이동

이 작업은 특정 전자 메일을 휴지통으로 이동하는 데 사용됩니다.

전자 메일 보내기(V2)

이 작업은 특정 받는 사람에게 전자 메일을 보내는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
에게
To True email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

CC(참조)
Cc email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

숨은 참조
Bcc email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

주제
Subject string

보내는 전자 메일의 제목입니다.

Body html

보내는 전자 메일의 본문입니다.

중요도
Importance string

전자 메일 메시지와 관련된 중요도입니다.

이름
Name True string

첨부 파일의 제목입니다.

Content
ContentBytes True byte

첨부 파일의 본문입니다.

콘텐츠 유형 (Content-Type)
ContentType string

첨부 파일의 콘텐츠 형식입니다.

전자 메일 보내기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 이메일 보내기(V2) 를 사용하세요.

이 작업은 특정 받는 사람에게 전자 메일을 보내는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
에게
To True email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

CC(참조)
Cc email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

숨은 참조
Bcc email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

주제
Subject string

보내는 전자 메일의 제목입니다.

Body string

보내는 전자 메일의 본문입니다.

HTML인가요?
IsHtml boolean

HTML로 전자 메일을 보내려면 True입니다. (기본값: True)

중요도
Importance string

전자 메일 메시지와 관련된 중요도입니다.

이름
Name True string

첨부 파일의 제목입니다.

Content
ContentBytes True byte

첨부 파일의 본문입니다.

콘텐츠 유형 (Content-Type)
ContentType string

첨부 파일의 콘텐츠 형식입니다.

전자 메일 삭제

이 작업은 특정 전자 메일을 영구적으로 삭제하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
메시지 ID
id True string

삭제할 전자 메일의 ID입니다.

전자 메일 세부 정보 가져오기

이 작업은 특정 전자 메일의 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
메시지 ID
id True string

전자 메일 메시지의 고유 ID입니다.

첨부 파일 포함
includeAttachments boolean

true로 설정하면 첨부 파일도 전자 메일과 함께 검색됩니다.

반환

특정 전자 메일 메시지와 관련된 세부 정보입니다.

전자 메일에 회신(V2)

이 작업은 특정 전자 메일에 회신하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
메시지 ID
id True string

회신할 전자 메일의 ID입니다.

에게
To email

예: recipient1@domain.com; recipient2@domain.com

CC(참조)
Cc email

예: recipient1@domain.com; recipient2@domain.com

숨은 참조
Bcc email

예: recipient1@domain.com; recipient2@domain.com

주제
Subject string

전자 메일 제목(비어 있는 경우 원래 제목이 사용됨).

Body html

이메일의 내용입니다.

모두 회신
ReplyAll boolean

모든 받는 사람에게 회신하려면 True입니다. (기본값: False)

중요도
Importance string

중요도를 선택합니다. (기본값: 기본값)

이름
Name True string

첨부 파일의 제목입니다.

Content
ContentBytes True byte

첨부 파일의 본문입니다.

콘텐츠 유형 (Content-Type)
ContentType string

첨부 파일의 콘텐츠 형식입니다.

전자 메일에 회신[사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 전자 메일에 회신(V2) 을 사용하세요.

이 작업은 특정 전자 메일에 회신하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
메시지 ID
id True string

회신할 전자 메일의 ID입니다.

에게
To email

예: recipient1@domain.com; recipient2@domain.com

CC(참조)
Cc email

예: recipient1@domain.com; recipient2@domain.com

숨은 참조
Bcc email

예: recipient1@domain.com; recipient2@domain.com

주제
Subject string

전자 메일 제목(비어 있는 경우 원래 제목이 사용됨).

Body string

이메일의 내용입니다.

모두 회신
ReplyAll boolean

모든 받는 사람에게 회신하려면 True입니다. (기본값: False)

HTML인가요?
IsHtml boolean

HTML로 회신을 보내려면 True입니다. (기본값: True)

중요도
Importance string

중요도를 선택합니다. (기본값: 기본값)

이름
Name True string

첨부 파일의 제목입니다.

Content
ContentBytes True byte

첨부 파일의 본문입니다.

콘텐츠 유형 (Content-Type)
ContentType string

첨부 파일의 콘텐츠 형식입니다.

전자 메일을 휴지통으로 이동

이 작업은 특정 전자 메일을 휴지통으로 이동하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
메시지 ID
id True string

휴지통으로 이동할 전자 메일의 ID입니다.

트리거

새 전자 메일이 도착하는 경우

이 작업은 지정된 조건과 일치하는 새 전자 메일이 도착하면 트리거됩니다.

새 전자 메일이 도착하는 경우

이 작업은 지정된 조건과 일치하는 새 전자 메일이 도착하면 트리거됩니다.

매개 변수

Name 필수 형식 Description
라벨
label string

레이블을 선택합니다(기본값: 받은 편지함).

에게
to email

세미콜론 또는 쉼표로 구분된 유효한 전자 메일 주소 목록입니다.

부터
from email

예: Sender1 | sender2@domain.com. .

주제
subject string

제목에서 찾을 문자열입니다.

중요도
importance string

전자 메일이 중요해야 하는 경우 True입니다. (기본값: 모두).

별표
starred string

전자 메일이 표시되어야 하는 경우 True입니다. (기본값: 모두).

첨부 파일 있음
fetchOnlyWithAttachments boolean

첨부 파일이 있는 전자 메일만 검색하려면 True입니다.

첨부 파일 포함
includeAttachments boolean

True이면 전자 메일과 함께 첨부 파일을 검색합니다.

반환

특정 전자 메일 메시지와 관련된 세부 정보입니다.

정의

DetailedReceiveMessage

특정 전자 메일 메시지와 관련된 세부 정보입니다.

Name 경로 형식 Description
부터
From email

메시지를 보낸 전자 메일 주소입니다.

보낸 사람의 이름
SenderName string

전자 메일 보낸 사람의 이름

에게
To email

메시지가 전송된 전자 메일 주소입니다.

CC(참조)
Cc email

CC 필드에 포함된 전자 메일 주소입니다.

숨은 참조
Bcc email

BCC 필드에 포함된 전자 메일 주소입니다.

주제
Subject string

전자 메일 메시지와 관련된 주제 또는 주제입니다.

Body string

전자 메일 메시지의 내용입니다.

단편
Snippet string

메시지 텍스트의 짧은 부분입니다.

레이블 ID
LabelIds array of string

전자 메일 메시지와 연결된 레이블 목록입니다.

받은 Date-Time
DateTimeReceived date-time

예:2017-05-03T20:08:57+00:00

예상 크기
EstimatedSize integer

예상 크기(바이트)입니다.

읽기인가요?
IsRead boolean

메시지가 읽혀지면 True이고, false이면 false입니다.

HTML인가요?
IsHtml boolean

메시지가 HTML 형식이면 True입니다.

첨부 파일 있음
HasAttachments boolean

메시지에 첨부 파일이 있으면 True입니다.

Attachments
Attachments array of Attachment

전자 메일 메시지에 대한 첨부 파일 목록입니다.

메시지 ID
Id string

메시지의 변경할 수 없는 ID입니다.

스레드 ID
ThreadId string

메시지가 속한 스레드의 ID입니다.

첨부 파일

전자 메일 첨부 파일의 속성입니다.

Name 경로 형식 Description
이름
Name string

첨부 파일의 제목입니다.

Content
ContentBytes byte

첨부 파일의 본문입니다.

콘텐츠 유형 (Content-Type)
ContentType string

첨부 파일의 콘텐츠 형식입니다.