Gmail 動作

搶先體驗 — 工作流程代理

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》，以及《生成式 AI 預先發布版產品附加條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

動作：列出訊息

輸入欄位

屬性	說明	類型
搜尋篩選器	Gmail 搜尋篩選器字串。例如：SearchQuery = 'label:inbox is:unread'	string
頁面大小	要傳回的結果數上限。例如：25。	integer
頁面權杖	用於分頁擷取的權杖。在此插入下一個頁面符記，即可擷取後續批次。	string

輸出變數

屬性	說明	類型
訊息	擷取的訊息清單。	array

動作：傳送訊息

輸入欄位

屬性	說明	類型
收件者	收件者的主要電子郵件地址。例如：[e-mail]	string
Subject	電子郵件主旨行。	string
訊息內文	電子郵件的主要文字或 HTML 內文。	string
CC	副本收件者的電子郵件地址，以半形逗號分隔。	string
BCC	要密件副本傳送的電子郵件地址，以半形逗號分隔。	string

輸出變數

屬性	說明	類型
id	Gmail 伺服器指派的傳送郵件專屬 ID。	string

動作：回覆郵件

輸入欄位

屬性	說明	類型
郵件 ID	要回覆的 Gmail 郵件可供搜尋的專屬 ID。	string
電子郵件內文	回覆郵件內文。	string
CC	副本收件者的電子郵件地址，以半形逗號分隔。例如：[e-mail]	string
BCC	要密件副本傳送的電子郵件地址，以半形逗號分隔。例如：[e-mail]	string
傳送自	郵件的轉送地址。例如：[e-mail]	string
收件者 (收件者)	直接對應至「收件者」的電子郵件地址。例如：[e-mail], [e-mail]	string

輸出變數

屬性	說明	類型
id	傳送回覆訊息的專屬 ID。	string

動作：搜尋郵件

輸入欄位

屬性	說明	類型
搜尋查詢 (query)	使用 Gmail 搜尋條件篩選討論串。	string

搜尋篩選器

篩選器	運算子	說明
來自	包含	來自特定寄件者的郵件。
至	包含	傳送給特定收件者的郵件。
副本	包含	含有特定副本收件者的郵件。
密件副本	包含	含有特定密件副本收件者的郵件。
主旨	包含	比對郵件主旨。
年長者	包含	早於相對時間的郵件 (例如：older:7d)。
較新	包含	晚於相對時間的訊息 (例如：newer:1d)。
deliveredto	包含	傳送至特定位址的郵件。

輸出變數

屬性	說明	類型
執行緒	符合條件的訊息串或郵件清單。	array

觸發條件：收到電子郵件時

觸發條件篩選器

篩選器	運算子	說明
寄件者	包含	比對寄件者的電子郵件地址。
收件者	包含	比對收件者電子郵件地址 (「收件者」欄位)。
主旨	包含	比對電子郵件主旨中的字詞。
標籤	包含	比對含有指定可搜尋 Gmail 標籤的電子郵件。
是	包含	比對 Gmail 狀態 (例如：未讀、已讀、已加星號、重要)。預設為未讀取。
包含	包含	比對含有指定屬性 (例如附件) 的電子郵件。預設值為「attachment」。
副本	包含	比對「副本」欄位中的電子郵件地址。
密件副本	包含	比對「密件副本」欄位中的電子郵件地址。
晚於	包含	比對這個日期之後傳送的電子郵件。
早於	包含	比對這個日期之前傳送的電子郵件。