Credentials สำหรับ Grist

การเอกสารสำหรับการรับรอง Grist ใช้การรับรองเหล่านี้เพื่อรับรอง Grist ใน n8n ซึ่งเป็นแพลตฟอร์มอัตโนมัติการทำงาน

คุณสามารถใช้ credentials เหล่านี้เพื่อตรวจสอบสิทธิ์ node ต่อไปนี้:

• Grist

ข้อกำหนดเบื้องต้น

สร้างก กริสต์ บัญชี

วิธีการรับรองความถูกต้องที่รองรับ

• คีย์เอพีไอ
• OAuth2

ทรัพยากรที่เกี่ยวข้อง

อ้างถึง การรับรอง API ของ Grist สำหรับข้อมูลเพิ่มเติมเกี่ยวกับบริการ

การใช้คีย์ API

ในการกำหนดค่า credentials นี้ คุณจะต้อง:

• อ API Key : ใน Grist เปิดเมนูบัญชี (ด้านบนด้านขวา) จากนั้นไปที่ การตั้งค่าบัญชี (Account settings) > Developer เพื่อสร้างหรือคัดลอกคีย์ API ของคุณ การรับรองข้อมูลการรับรอง API Grist สำหรับข้อมูลเพิ่มเติม
• A Grist URL นี่คือจุด n8n บนเซิร์ฟเวอร์ Grist ของคุณ:
  • ความผิดพลาด https://api.getgrist.com , ทำงานสำหรับบัญชีใด ๆ ที่โฮสต์ Grist (getgrist.com)
  • เพื่อ จำกัด การเชื่อมต่อกับทีมเดียวใช้ https://YOUR_TEAM.getgrist.com.
  • สำหรับตัวอย่างที่จัดการด้วยตนเองใช้ URL ของมัน (เช่น https://grist.example.com).

การใช้ OAuth2

บน Grist ที่ได้รับการจัดการด้วยตนเองแอป OAuth เป็นส่วนหนึ่งของ การพิมพ์ Grist หากตัวอย่างของคุณไม่ให้พวกเขาใช้คีย์ API

ในการกำหนดค่า credentials นี้ คุณจะต้อง:

• A Client ID : Grist จะให้สิ่งนี้เมื่อคุณลงทะเบียนแอป OAuth
• A Client Secret : Grist จะให้สิ่งนี้เมื่อคุณลงทะเบียนแอป OAuth
• A Grist URL นี่คือจุด n8n บนเซิร์ฟเวอร์ Grist ของคุณ:
  • ความผิดพลาด https://api.getgrist.com , ทำงานสำหรับบัญชีใด ๆ ที่โฮสต์ Grist (getgrist.com)
  • เพื่อ จำกัด การเชื่อมต่อกับทีมเดียวใช้ https://YOUR_TEAM.getgrist.com.
  • สำหรับตัวอย่างที่จัดการด้วยตนเองใช้ URL ของมัน (เช่น https://grist.example.com).

การลงทะเบียนแอปและเชื่อมต่อ:

1. ใน n8n เริ่มสร้าง A Grist OAuth2 API การรับรองและคัดลอก OAuth Redirect URL.
2. ใน Grist เปิดเมนูบัญชี (ด้านบนด้านขวา) จากนั้นไปที่ การตั้งค่าบัญชี (Account settings) > Developer.
3. ใน แอป OAuth (OAuth apps) ส่วน ให้เลือก การลงทะเบียนแอป (Register app) เข้าสู่ระบบ ชื่อแอพลิเคชัน (Application name) ตัวอย่างเช่น n8n , และแทรกที่ n8n redirects URL ในขณะที่ Redirect URI.
4. เลือกเป้าหมายเหล่านี้: offline_access, doc:read และ doc:write.
5. เลือก Register จากนั้นคัดลอก The Client ID และ Client Secret ความรุนแรงแสดงความลับเพียงครั้งเดียว
6. กลับใน n8n ใส่ ID ลูกค้าและความลับ ลูกค้าแล้วเลือก Connect my account.
7. บนหน้าจอใบอนุญาตของ Grist เลือกสิ่งที่ใบรับรองสามารถเข้าถึงได้: ทั้งหมดเอกสาร (ตอนนี้และในอนาคต) (All documents (now and in the future)) หรือ วัตถุดิบที่เลือก (Selected resources) เลือกเอกสารที่กำหนดเองพื้นที่งานหรือเว็บไซต์ จากนั้นเลือก Authorize.

การเลือกในขั้นตอน 7 ลดการรับรองมากกว่าที่สปอตทำ Grist จะบังคับใช้มันในแต่ละโทรศัพท์: การขอเอกสารภายนอกการรับรองจะล้มเหลวแม้ว่าคุณจะสามารถเปิดเอกสารนี้ได้ด้วยตัวเอง การระบุการรับรองในเอกสารเดียวเป็นวิธีที่ดีในการให้การเข้าถึงข้อมูลที่ต้องการเท่านั้น เพื่อเปลี่ยนการเลือกในภายหลังหรือเพื่อยกเลิกการเข้าถึงการรับรองด้วยตนเอง การตั้งค่าบัญชี (Account settings) > ปพลิเคชันที่ได้รับอนุญาต (Authorized apps) ในความรุนแรง

อ้างถึง การรับรองแอปพลิเคชันที่เชื่อมต่อของ Grist เกี่ยวกับวิธีที่อนุญาตทำงานและวิธีการจัดการและ Grist's OAuth แอปเอกสาร สำหรับรายละเอียดเกี่ยวกับการลงทะเบียนแอป

การลงทะเบียนแอพพลิเคชันที่มีช่วงใด ๆ ของคำขอการรับรอง (Register the app with every scope the credential requests)

Grist คิดการอนุมัติที่ร้องขอการครอบคลุมที่แอปไม่ได้ลงทะเบียนกับและการเชื่อมต่อไม่สามารถเชื่อมต่อกับ invalid_scope ข้อผิดพลาด. หากคุณลงทะเบียนแอปที่มีข้อบกพร่องน้อยลงใช้ คู่มือที่กำหนดเอง ต้องขอเพียงคนเหล่านี้

ใช้ใบรับรองอย่างน้อยหนึ่งครั้งต่อเดือน (Use the credential at least once a month)

รหัสการทำความสะอาดของ Grist จะหมดอายุหลังจาก 60 วัน workflow ที่ทำงานอย่างน้อยทุก 30 วันยังคงทำงานการรับรองอย่างไม่นาน หากการรับรองไม่ได้ใช้เป็นเวลานานให้เชื่อมต่อใหม่กับ Connect my account . API Key Credentials ไม่หมดอายุ

การตั้งค่าขอบเขตที่กำหนดเอง

การรับรอง Grist OAuth2 ใช้ข้อกำหนดต่อไปนี้โดยเริ่มต้น:

• offline_access
• doc:read
• doc:write

หากต้องการเลือกขอบเขตที่แตกต่างกันสำหรับข้อมูลประจำตัวของคุณ ให้เปิดใช้งาน Custom Scopes เลื่อนและแก้ไข Enabled Scopes รายการ โปรดจำไว้ว่าคุณสมบัติบางอย่างอาจไม่ทำงานตามที่คาดหวังกับเป้าหมายที่ จำกัด มากขึ้น ตัวอย่างเช่นการรับรองโดยไม่มี doc:write สามารถอ่านบันทึก แต่ไม่สามารถสร้างอัปเดตหรือลบบันทึก Grist's OAuth ปิด สำหรับรายการเต็มของสปอตที่มีอยู่