การเชื่อมต่อ Notion API

ในเอกสารช่วยเหลือนี้

ด้วย API ของ Notion คุณสามารถสร้างการเชื่อมต่อภายในแบบกำหนดเองได้ พาร์ทเนอร์บางรายของเราอาจต้องการโทเค็นการเชื่อมต่อภายในเพื่อ ลิงค์แพลตฟอร์มของตนเข้ากับพื้นที่ทำงาน Notion ของคุณ ด้านล่างนี้ เราจะแนะนำขั้นตอนการตั้งค่าให้คุณทราบ


ไปที่ ฮับนักพัฒนา ของเราเพื่อดูเอกสาร ทรัพยากร และเครื่องมือจัดการการเชื่อมต่อ

หมายเหตุ: เจ้าของพื้นที่ทำงานจะจัดการการเชื่อมต่อทั้งหมดในพื้นที่ทำงาน ดูข้อมูลเพิ่มเติม ที่นี่ →

  1. ในแถบด้านข้างซ้ายของคุณ ให้ไปที่ Settings แล้วไปที่แท็บ Connections

  2. เฉพาะเจ้าของพื้นที่ทำงานเท่านั้นที่จะสามารถเข้าถึงแท็บ Connections และสร้างการเชื่อมต่อได้ หากคุณไม่ใช่ผู้ดูแล โปรดติดต่อผู้ดูแลพื้นที่ทำงานของคุณหรือใช้พื้นที่ทำงานอื่น

  3. คลิกลิงก์ Develop your own connections ที่ด้านล่าง

  4. My connections จะเปิดขึ้นในเบราว์เซอร์เริ่มต้นของคุณ คลิกปุ่ม + New connection

  5. ระบุ Name สำหรับการเชื่อมต่อของคุณ คุณสามารถเลือกอัปโหลดรูปภาพเพื่อใช้เป็น โลโก้ ได้เช่นกัน

  6. ใช้เมนูดร็อปดาวน์เพื่อระบุว่าคุณต้องการใช้การเชื่อมต่อนี้กับ พื้นที่ทำงานที่เกี่ยวข้อง ใด

    หมายเหตุ: ตรวจสอบให้แน่ใจว่าคุณได้เข้าสู่ระบบ Notion ในเซสชันเว็บของคุณด้วยบัญชีเดียวกับที่คุณใช้บนเดสก์ท็อป มิฉะนั้น คุณจะไม่เห็นบัญชีและพื้นที่ทำงานที่ถูกต้อง!

  7. เพิ่มการเชื่อมต่อภายในของคุณเรียบร้อยแล้ว! ตอนนี้คุณจะสามารถเห็นการเชื่อมต่อดังกล่าวในพื้นที่ทำงานของคุณได้ที่เมนู SettingsConnections

  8. คลิก ••• ถัดจากการเชื่อมต่อภายในเพื่อเรียกดูโทเค็นการเชื่อมต่อภายใน คุณจะต้องใช้โทเค็นนี้สำหรับระบบอัตโนมัติหรือเวิร์กโฟลว์ที่ใช้ API ซึ่งทีมของคุณสร้างขึ้น หรือเพื่อเชื่อมโยงพื้นที่ทำงานของคุณเข้ากับแพลตฟอร์มของพาร์ทเนอร์บางราย

หมายเหตุ: การเชื่อมต่อภายในจะเฉพาะเจาะจงกับพื้นที่ทำงาน ดังนั้นหากต้องการเปลี่ยนพื้นที่ทำงานที่เกี่ยวข้อง คุณจะต้องสร้างการเชื่อมต่อใหม่

การเชื่อมต่อที่เพิ่มเข้ามาใหม่ทั้งหมดจะเป็นการเชื่อมต่อภายในโดยเริ่มต้น หากคุณเป็นนักพัฒนาที่กำลังสร้างการเชื่อมต่อสาธารณะ ให้ใช้คำแนะนำข้างต้นเพื่อสร้างการเชื่อมต่อภายในก่อน

จากนั้น ให้ทำตามคำสั่งใน คู่มือสำหรับนักพัฒนา ของเราเพื่อแปลงให้เป็นการเชื่อมต่อสาธารณะ

ในระหว่างขั้นตอนการตั้งค่าแอป นักพัฒนาจะสามารถเลือกระดับการเข้าถึงที่ต้องการจากผู้ใช้ได้

  • ความสามารถในการเข้าถึงเนื้อหา:

    • อ่านเนื้อหาเท่านั้น

    • เขียนเนื้อหาเท่านั้น

    • แทรกเนื้อหา

  • ความสามารถของผู้ใช้

    • ไม่มีข้อมูลผู้ใช้

    • อ่านข้อมูลผู้ใช้ (ไม่รวมที่อยู่อีเมลของผู้ใช้)

    • อ่านข้อมูลผู้ใช้ (รวมอีเมล)

เมื่อผู้ใช้ติดตั้งการเชื่อมต่อ ระดับการเข้าถึงนี้จะแสดงขึ้น นอกจากนี้ยังจะแสดงในเมนู แชร์ ของหน้าที่มีการเพิ่มการเชื่อมต่อเข้าไป ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งการเชื่อมต่อในพื้นที่ทำงาน →

เว็บฮุคการเชื่อมต่อช่วยให้การเชื่อมต่อสามารถตรวจสอบและตอบสนองต่อการเปลี่ยนแปลงในพื้นที่ทำงาน Notion ได้แบบเรียลไทม์

เมื่อมีการเปลี่ยนแปลงเกิดขึ้นในหน้าหรือฐานข้อมูลที่แชร์กับ การเชื่อมต่อ ของคุณ Notion จะส่งการแจ้งเตือนไปยังปลายทางเว็บฮุคของคุณโดยอัตโนมัติ ซึ่งช่วยให้การเชื่อมต่อของคุณสามารถอัปเดตเครื่องมืออื่นๆ เรียกใช้งานอัตโนมัติ หรือแสดงการเปลี่ยนแปลงล่าสุดได้ทันที

ตั้งค่าเว็บฮุคการเชื่อมต่อ

สำหรับคำแนะนำ โปรดไปที่ เอกสารสำหรับนักพัฒนา ของเรา

ปัจจุบันเว็บฮุคการเชื่อมต่อไม่รองรับการแจ้งเตือนสำหรับ:

  • การเปลี่ยนแปลงของผู้ใช้ (รวมถึงการเปลี่ยนแปลงสมาชิกในพื้นที่ทำงาน การอัปเดตอีเมล/ชื่อ และการแก้ไขสิทธิ์)

  • การเปลี่ยนแปลงการตั้งค่าพื้นที่ทำงานและพื้นที่ทำงานของทีม

สำหรับการแจ้งเตือนประเภทเหล่านี้ ให้ใช้ บันทึกการตรวจสอบ แทน

การดำเนินการผ่านเว็บฮุคเทียบกับเว็บฮุคการเชื่อมต่อ

การดำเนินการผ่านเว็บฮุค และเว็บฮุคการเชื่อมต่อมีความคล้ายคลึงกันบางประการ ทั้งคู่มีทริกเกอร์และสามารถส่งเหตุการณ์ไปยังบริการของบุคคลที่สามได้ อย่างไรก็ตาม เว็บฮุคการเชื่อมต่อมีความสามารถที่กว้างขวางกว่า:

  • สามารถตรวจสอบกิจกรรมในหลายพื้นที่ทำงานได้

  • สามารถจัดการการดำเนินการได้ไม่จำกัดจำนวน

ในทางตรงกันข้าม การดำเนินการผ่านเว็บฮุคได้รับการออกแบบมาสำหรับกรณีการใช้งานที่ง่ายกว่า และกำหนดค่าผ่านระบบอัตโนมัติของฐานข้อมูลโดยมีชุดทริกเกอร์ที่จำกัด


ให้ข้อเสนอแนะ

แหล่งข้อมูลนี้มีประโยชน์หรือไม่?


Powered by Fruition