整合
連接 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。
新增動作
- 在你的 Zap 中新增一個步驟,並選擇 Bannerify 應用程式。
- 選擇 Create Image 或 Create PDF。
- 連接你的帳號,並把 API 金鑰貼到 Project API Key 欄位。
- 在 Template 中選擇範本。Zapier 會載入擁有該金鑰的工作區中的範本。
- 對於 Create Image,請選擇 Format:
png、jpeg或webp。預設為png。 - 依照下方說明填寫圖層欄位。
- 點選 Test step。結果中會有
url欄位。開啟該連結來檢查檔案。
填寫圖層
選擇範本之後,Zapier 會為每個文字圖層和每個圖片圖層新增一個欄位。標籤會顯示圖層名稱和它所變更的欄位,例如 headline (text) 或 photo (src)。請把前面步驟的值對應到這些欄位。留空的欄位會維持範本中的值。
對於 QR 碼和表格等其他類型的圖層,請使用 Modifications JSON。它接受一個以圖層名稱為鍵的物件,或 API 所使用的陣列:
{
"qr": { "qrcode": "https://example.com/orders/1042" },
"total": "$29.00"
}
每種圖層類型會讀取哪些欄位,請見 Modifications。
範例:把試算表的一列變成 Drive 檔案
- 新增 Google Sheets 觸發程序,並選擇 New Spreadsheet Row。
- 新增 Bannerify 動作 Create Image。把每個欄位對應到圖層欄位,例如把
Headline欄對應到headline (text)。 - 新增 Google Drive 動作,並選擇 Upload File。使用 Bannerify 步驟中的
url作為檔案。 - 如果你想把
url貼到頻道中,請新增 Slack 動作,並選擇 Send Channel Message。
疑難排解
| 問題 | 處理方式 |
|---|---|
| Template 清單是空的 | 請確認 API 金鑰屬於擁有這些範本的工作區 |
| 某個圖層沒有變更 | 請在編輯器中檢查圖層名稱。名稱有區分大小寫,API 會忽略不存在的名稱 |
| 步驟因用量上限訊息而失敗 | 工作區已達到每日或每月上限。請見用量額度與限制 |
步驟因 TOO_MANY_REQUESTS 而失敗 |
金鑰在 10 秒內傳送了太多請求。訊息會指出時段重設的時間,請在該時間之後再次執行步驟 |
步驟失敗時,Zapier 會顯示 API 回傳的訊息。錯誤碼請見處理錯誤。