การเชื่อมต่อ Notion API
API ของ Notion ช่วยให้สร้างการเชื่อมต่อภายในแบบกำหนดเองได้ พาร์ทเนอร์บางรายอาจต้องใช้โทเค็น API เพื่อเชื่อมต่อแพลตฟอร์มกับพื้นที่ทำงาน Notion ของคุณ ต่อไปนี้คือวิธีตั้งค่า
คุณสามารถจัดการโทเค็นการเข้าถึงส่วนบุคคลได้จาก Notion เปิดโหมดนักพัฒนาซอฟต์แวร์จาก การตั้งค่า จากนั้นเปิดโทเค็นการเข้าถึงส่วนบุคคลจากส่วนนักพัฒนาซอฟต์แวร์ในแถบด้านข้างของคุณ เยี่ยมชม ฮับนักพัฒนา ของเราเพื่อดูเอกสารประกอบ ทรัพยากร และเครื่องมือจัดการการเชื่อมต่อ
หมายเหตุ: การเชื่อมต่อแต่ละรายการมีเจ้าของอย่างน้อย 1 คน เจ้าของทุกคนจัดการการเชื่อมต่อและรับโทเค็น API ได้ ใครสร้างการเชื่อมต่อได้บ้างขึ้นอยู่กับแพ็คเกจและการตั้งค่าพื้นที่ทำงานของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับ การตั้งค่าการเชื่อมต่อสำหรับ Enterprise →
กำลังมองหาโทเค็นผู้ดูแลอยู่ใช่ไหม? โทเค็นในหน้านี้ใช้งานภายในพื้นที่ทำงานเดียวและจัดการเนื้อหาของหน้า หากคุณต้องการทำงานผู้ดูแลขององค์กร เช่น การส่งออก การบล็อค หรือการออกจากระบบของผู้ใช้ โปรดดู Admin APIs for Enterprise organizations.
ต้องใช้โทเค็นไหน? Notion ใช้โทเค็นหลายแบบ โทเค็นที่คัดลอกสำหรับการเชื่อมต่อภายในคือ โทเค็น API ซึ่งเป็นโทเค็นที่กล่าวถึงในบทความนี้ โทเค็นการเข้าถึงส่วนบุคคล ผูกกับบัญชีของคุณ ส่วน OAuth ใช้จัดการแอพที่คุณลงชื่อเข้าใช้ หากแพลตฟอร์มของพาร์ทเนอร์ขอโทเค็นสำหรับการเชื่อมต่อที่คุณสร้าง ให้ใช้โทเค็น API
ในแถบด้านข้างซ้ายของคุณ ให้ไปที่
Settingsแล้วไปที่แท็บConnectionsสิทธิ์ในการสร้างการเชื่อมต่อขึ้นอยู่กับพื้นที่ทำงานของคุณ สำหรับแพ็คเกจฟรีและแพ็คเกจ Plus มีเพียงเจ้าของพื้นที่ทำงานที่สร้างการเชื่อมต่อได้ ส่วนแพ็คเกจ Business และแพ็คเกจ Enterprise เจ้าของพื้นที่ทำงานยังอนุญาตให้สมาชิกหรือสมาชิกในบางกลุ่มสร้างการเชื่อมต่อได้ด้วย หากสร้างไม่ได้ ให้สอบถามเจ้าของพื้นที่ทำงาน
เปิด โหมดนักพัฒนาซอฟต์แวร์ จากนั้นเปิดโทเค็นการเข้าถึงส่วนบุคคลจากส่วนนักพัฒนาซอฟต์แวร์ในแถบด้านข้างของคุณ
คลิก
+ เพิ่มการเชื่อมต่อใหม่ระบุ
Nameสำหรับการเชื่อมต่อของคุณ คุณสามารถเลือกอัปโหลดรูปภาพเพื่อใช้เป็นโลโก้ได้เช่นกันใช้เมนูดร็อปดาวน์เพื่อระบุว่าคุณต้องการใช้การเชื่อมต่อนี้กับ
พื้นที่ทำงานที่เกี่ยวข้องใด
หมายเหตุ: ตรวจสอบให้แน่ใจว่าคุณได้เข้าสู่ระบบ Notion ในเซสชันเว็บของคุณด้วยบัญชีเดียวกับที่คุณใช้บนเดสก์ท็อป มิฉะนั้น คุณจะไม่เห็นบัญชีและพื้นที่ทำงานที่ถูกต้อง!

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

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

การเชื่อมต่อภายในทุกการเชื่อมต่อมีเจ้าของอย่างน้อย 1 คน เจ้าของเปลี่ยนการตั้งค่าและดูโทเค็น API ของการเชื่อมต่อได้ คุณแชร์สิทธิ์เจ้าของให้หลายคนจัดการการเชื่อมต่อเดียวกันได้ งานจึงไม่สะดุดเมื่อมีใครเปลี่ยนหน้าที่หรือออกจากทีม
ในการเพิ่มหรือลบเจ้าของ:
เปิดพอร์ทัลนักพัฒนาแล้วเลือกการเชื่อมต่อของคุณ
เปิดแท็บ
เจ้าของการเชื่อมต่อเพิ่มสมาชิกหรือกลุ่มเป็นเจ้าของ หรือลบออก
โปรดทราบข้อมูลต่อไปนี้เกี่ยวกับเจ้าของการเชื่อมต่อ:
เฉพาะสมาชิกที่มีสิทธิ์เข้าถึงเต็มรูปแบบและเจ้าของพื้นที่ทำงานเท่านั้นที่เป็นเจ้าของการเชื่อมต่อได้ ผู้ใช้ชั่วคราวและสมาชิกที่มีสิทธิ์เข้าถึงแบบจำกัดเป็นเจ้าของไม่ได้
การตั้งค่าพื้นที่ทำงานที่กำหนดว่าใครสร้างการเชื่อมต่อได้ ยังเป็นตัวกำหนดด้วยว่าคุณเพิ่มใครเป็นเจ้าของได้บ้าง
การเชื่อมต่อต้องมีเจ้าของอย่างน้อย 1 คนเสมอ จึงลบเจ้าของคนสุดท้ายไม่ได้
หากคุณเป็นเจ้าของพื้นที่ทำงานและต้องการรับช่วงดูแลการเชื่อมต่อ ให้เพิ่มตัวเองเป็นเจ้าของก่อน
หากเจ้าของคนสุดท้ายออกจากพื้นที่ทำงาน โทเค็น API ของการเชื่อมต่อจะหยุดทำงานทันที
แพ็คเกจ Plus, Business และ Enterprise แชร์สิทธิ์เจ้าของการเชื่อมต่อได้เมื่อใช้ Notion ผ่านเบราว์เซอร์หรือแอพเดสก์ท็อป
การเชื่อมต่อที่เพิ่มเข้ามาใหม่ทั้งหมดจะเป็นการเชื่อมต่อภายในโดยเริ่มต้น หากคุณเป็นนักพัฒนาที่กำลังสร้างการเชื่อมต่อสาธารณะ ให้ใช้คำแนะนำข้างต้นเพื่อสร้างการเชื่อมต่อภายในก่อน
จากนั้น ให้ทำตามคำสั่งใน คู่มือสำหรับนักพัฒนา ของเราเพื่อแปลงให้เป็นการเชื่อมต่อสาธารณะ
เมื่อสร้างการเชื่อมต่อสาธารณะ คุณต้องเลือกว่าจะให้ใครติดตั้งได้:
พื้นที่ทำงานใดก็ได้: ใครก็ได้ติดตั้งการเชื่อมต่อของคุณในพื้นที่ทำงาน Notion ของตัวเองพื้นที่ทำงานที่เลือก: ติดตั้งการเชื่อมต่อของคุณได้เฉพาะในพื้นที่ทำงานที่อยู่ในลิสต์เท่านั้น
เลือก พื้นที่ทำงานที่เลือก หากกำลังสร้างสิ่งที่ใช้เฉพาะในบริษัทของคุณ และไม่ต้องการให้องค์กรอื่นติดตั้ง
Notion จะตรวจสอบทุกครั้งที่มีคนติดตั้งการเชื่อมต่อของคุณ หากพื้นที่ทำงานของคนนั้นไม่อยู่ในลิสต์ การติดตั้งจะหยุดและแสดงข้อความแสดงข้อผิดพลาด
เฉพาะการเชื่อมต่อที่ใครก็ได้ติดตั้งเท่านั้นที่จะแสดงในแกลเลอรีการเชื่อมต่อ ส่วนการเชื่อมต่อที่จำกัดไว้เฉพาะพื้นที่ทำงานที่เลือกจะไม่แสดงในนั้น
หมายเหตุ: คุณเลือกการตั้งค่านี้ตอนสร้างการเชื่อมต่อ หากต้องการใช้การตั้งค่าอื่นในภายหลัง ให้สร้างการเชื่อมต่อใหม่
การเชื่อมต่อที่คุณเป็นเจ้าของจะแสดงในพอร์ทัลนักพัฒนาของพื้นที่ทำงานทุกแห่งที่ติดตั้งได้ ติดตั้งไว้แล้ว หรือเป็นพื้นที่ทำงานที่คุณใช้สร้างการเชื่อมต่อนั้น
การเชื่อมต่อสาธารณะแต่ละรายการจะมีพื้นที่ทำงานหนึ่งแห่งสำหรับสร้างและทดสอบ คุณเปลี่ยนไปใช้พื้นที่ทำงานอื่นได้โดยไม่ต้องเริ่มใหม่
เปิดการเชื่อมต่อของคุณในพอร์ทัลนักพัฒนา
ไปที่การตั้งค่าของการเชื่อมต่อ
เลือกพื้นที่ทำงานที่ต้องการใช้สร้างการเชื่อมต่อ
Notion จะเชื่อมการเชื่อมต่อของคุณกับพื้นที่ทำงานที่เลือก โดยไม่ต้องสร้างการเชื่อมต่อใหม่
ในระหว่างขั้นตอนการตั้งค่าแอป นักพัฒนาจะสามารถเลือกระดับการเข้าถึงที่ต้องการจากผู้ใช้ได้
ความสามารถในการเข้าถึงเนื้อหา:
อ่านเนื้อหาเท่านั้น
เขียนเนื้อหาเท่านั้น
แทรกเนื้อหา
ความสามารถของผู้ใช้
ไม่มีข้อมูลผู้ใช้
อ่านข้อมูลผู้ใช้ (ไม่รวมที่อยู่อีเมลของผู้ใช้)
อ่านข้อมูลผู้ใช้ (รวมอีเมล)
เมื่อผู้ใช้ติดตั้งการเชื่อมต่อ ระดับการเข้าถึงนี้จะแสดงขึ้น นอกจากนี้ยังจะแสดงในเมนู แชร์ ของหน้าที่มีการเพิ่มการเชื่อมต่อเข้าไป ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งการเชื่อมต่อในพื้นที่ทำงาน →
เว็บฮุคการเชื่อมต่อช่วยให้การเชื่อมต่อสามารถตรวจสอบและตอบสนองต่อการเปลี่ยนแปลงในพื้นที่ทำงาน Notion ได้แบบเรียลไทม์
เมื่อมีการเปลี่ยนแปลงเกิดขึ้นในหน้าหรือฐานข้อมูลที่แชร์กับ การเชื่อมต่อ ของคุณ Notion จะส่งการแจ้งเตือนไปยังปลายทางเว็บฮุคของคุณโดยอัตโนมัติ ซึ่งช่วยให้การเชื่อมต่อของคุณสามารถอัปเดตเครื่องมืออื่นๆ เรียกใช้งานอัตโนมัติ หรือแสดงการเปลี่ยนแปลงล่าสุดได้ทันที
สำหรับคำแนะนำ โปรดไปที่ เอกสารสำหรับนักพัฒนา ของเรา
ปัจจุบันเว็บฮุคการเชื่อมต่อไม่รองรับการแจ้งเตือนสำหรับ:
การเปลี่ยนแปลงของผู้ใช้ (รวมถึงการเปลี่ยนแปลงสมาชิกในพื้นที่ทำงาน การอัปเดตอีเมล/ชื่อ และการแก้ไขสิทธิ์)
การเปลี่ยนแปลงการตั้งค่าพื้นที่ทำงานและพื้นที่ทำงานของทีม
สำหรับการแจ้งเตือนประเภทเหล่านี้ ให้ใช้ บันทึกการตรวจสอบ แทน
การดำเนินการผ่านเว็บฮุค และเว็บฮุคการเชื่อมต่อมีความคล้ายคลึงกันบางประการ ทั้งคู่มีทริกเกอร์และสามารถส่งเหตุการณ์ไปยังบริการของบุคคลที่สามได้ อย่างไรก็ตาม เว็บฮุคการเชื่อมต่อมีความสามารถที่กว้างขวางกว่า:
สามารถตรวจสอบกิจกรรมในหลายพื้นที่ทำงานได้
สามารถจัดการการดำเนินการได้ไม่จำกัดจำนวน
ในทางตรงกันข้าม การดำเนินการผ่านเว็บฮุคได้รับการออกแบบมาสำหรับกรณีการใช้งานที่ง่ายกว่า และกำหนดค่าผ่านระบบอัตโนมัติของฐานข้อมูลโดยมีชุดทริกเกอร์ที่จำกัด
