導覽

整合

連接 Zapier

了解如何使用 Bannerify 應用程式,在 Zap 中生成圖片和 PDF。

Zapier 中的 Bannerify 應用程式,會用你的 Zap 資料繪製範本,並回傳檔案的連結。你可以用它為每一列新的試算表資料或表單回覆製作圖片或 PDF,完全不需要寫程式碼。

動作

動作 輸出 欄位
Create Image PNG、JPEG 或 WebP 檔案 Template、Format、Modifications JSON,以及每個文字或圖片圖層各一個欄位
Create PDF PDF 檔案 Template、Modifications JSON,以及每個文字或圖片圖層各一個欄位

兩個動作都會回傳含有 url 欄位的物件。Bannerify 會把檔案儲存在它的 CDN 上,每次執行計為一次生成。

先決條件

  • 一個 Zapier 帳號。
  • 一組 Bannerify API 金鑰。
  • 一個有命名圖層的範本。名稱為什麼很重要,請見 Modifications。

新增動作

  1. 在你的 Zap 中新增一個步驟,並選擇 Bannerify 應用程式。
  2. 選擇 Create Image 或 Create PDF。
  3. 連接你的帳號,並把 API 金鑰貼到 Project API Key 欄位。
  4. 在 Template 中選擇範本。Zapier 會載入擁有該金鑰的工作區中的範本。
  5. 對於 Create Image,請選擇 Format:png、jpeg 或 webp。預設為 png。
  6. 依照下方說明填寫圖層欄位。
  7. 點選 Test step。結果中會有 url 欄位。開啟該連結來檢查檔案。

填寫圖層

選擇範本之後,Zapier 會為每個文字圖層和每個圖片圖層新增一個欄位。標籤會顯示圖層名稱和它所變更的欄位,例如 headline (text) 或 photo (src)。請把前面步驟的值對應到這些欄位。留空的欄位會維持範本中的值。

對於 QR 碼和表格等其他類型的圖層,請使用 Modifications JSON。它接受一個以圖層名稱為鍵的物件,或 API 所使用的陣列:

{
  "qr": { "qrcode": "https://example.com/orders/1042" },
  "total": "$29.00"
}

每種圖層類型會讀取哪些欄位,請見 Modifications。

範例:把試算表的一列變成 Drive 檔案

  1. 新增 Google Sheets 觸發程序,並選擇 New Spreadsheet Row。
  2. 新增 Bannerify 動作 Create Image。把每個欄位對應到圖層欄位,例如把 Headline 欄對應到 headline (text)。
  3. 新增 Google Drive 動作,並選擇 Upload File。使用 Bannerify 步驟中的 url 作為檔案。
  4. 如果你想把 url 貼到頻道中,請新增 Slack 動作,並選擇 Send Channel Message。

疑難排解

問題 處理方式
Template 清單是空的 請確認 API 金鑰屬於擁有這些範本的工作區
某個圖層沒有變更 請在編輯器中檢查圖層名稱。名稱有區分大小寫,API 會忽略不存在的名稱
步驟因用量上限訊息而失敗 工作區已達到每日或每月上限。請見用量額度與限制
步驟因 TOO_MANY_REQUESTS 而失敗 金鑰在 10 秒內傳送了太多請求。訊息會指出時段重設的時間,請在該時間之後再次執行步驟

步驟失敗時,Zapier 會顯示 API 回傳的訊息。錯誤碼請見處理錯誤。