Google OAuth2 ภาษาไทย

การเอกสารสำหรับการรับรอง OAuth2 ของ Google ใช้รับรองเหล่านี้เพื่อรับรองบริการ Google ใน n8n, แพลตฟอร์มอัตโนมัติการทำงาน

เอกสารนี้มีคำแนะนำในการสร้างใบรับรอง API ของ Google OAuth2 โดยทั่วไปเพื่อใช้กับ Custom API actions for existing nodes.

• Google Calendar
• Google Calendar Trigger
• Google Chat
• Google Contacts
• Google Docs
• Google Drive
• Google Drive Trigger
• Gmail
• Gmail Trigger
• Google Sheets
• Google Sheets Trigger
• Google Slides
• Google Tasks
• YouTube

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

• สร้างก Google โคลน บัญชี

ติดตั้ง OAuth

มี 5 ขั้นตอนในการเชื่อมต่อการรับรอง n8n ของคุณกับบริการ Google:

1. สร้างโครงการ Google Cloud Console .
2. อนุญาต APIs .
3. การตั้งค่าหน้าจอความยินยอม OAuth ของคุณ .
4. สร้างใบรับรองของลูกค้า Google OAuth ของคุณ .
5. เสร็จสิ้นการรับรอง n8n ของคุณ .

สร้างโครงการ Google Cloud Console (Create a Google Cloud Console project)

ก่อนอื่นสร้างโครงการ Google Cloud Console หากคุณมีโครงการแล้วคลิกที่ ส่วนต่อไป :

1. ลงชื่อเข้าสู่ระบบของคุณ Google Cloud Console ใช้ใบรับรอง Google ของคุณ

2. ในเมนูด้านบนเลือกโครงการ dropdown ในการนำทางด้านบนและเลือก โครงการใหม่ (New project) หรือไปโดยตรงไปยัง โครงการใหม่ หน้า

3. ป้อนก ชื่อโครงการ (Project name) และเลือกตำแหน่ง ( Organization และ / หรือ หลักทรัพย์ (Parent resource) ) สำหรับโครงการของคุณ

4. เลือก Create.

5. ตรวจสอบการนำทางด้านบนและตรวจสอบให้แน่ใจว่าโครงการ dropdown ได้เลือกโครงการของคุณ หากไม่เลือกโครงการที่คุณสร้างได้

   

Enable APIs

ด้วยการสร้างโครงการของคุณคุณจะเปิดใช้งาน API ที่คุณต้องการเข้าถึง:

1. การเข้าถึงของคุณ Google Cloud Console - ร้านค้า ให้แน่ใจว่าคุณอยู่ในโครงการที่ถูกต้อง

   

2. ไปที่ API และบริการ > ไลบรารี (APIs & Services > Library).

3. ค้นหาและเลือก API(s) ที่คุณต้องการเปิดใช้งาน ตัวอย่างเช่นสำหรับ node Gmail ค้นหาและเปิดใช้งาน API Gmail

4. การบูรณาการบางอย่างต้องใช้ API อื่น ๆ หรือต้องขอเข้าถึง:
   

   • Google มุมมอง: กรุณาเข้าถึง API .
   • Google Ads: รับ A ผู้พัฒนา Token .

   Google Drive API ที่จำเป็น (Google Drive API required)

   การบูรณาการต่อไปนี้ต้องใช้ API ของ Google Drive เช่นเดียวกับ API ของตัวเอง:

   • Google เอกสาร
   • Google ชีต
   • Google สไลด์

   Google Vertex AI API

   นอกเหนือจาก Vertex AI API คุณยังต้องเปิดใช้งาน API ของ Cloud Resource Manager .

5. เลือก ENABLE.

การตั้งค่าหน้าจอความยินยอม OAuth ของคุณ (Configure your OAuth consent screen)

หากคุณไม่ได้ใช้ OAuth ในโครงการ Google Cloud ของคุณก่อนหน้านี้คุณจะต้อง การกำหนดค่าหน้าจอความยินยอมของ OAuth :

1. การเข้าถึงของคุณ Google Cloud Console - ร้านค้า ให้แน่ใจว่าคุณอยู่ในโครงการที่ถูกต้อง

   

2. เปิดเมนูการนำทางด้านซ้ายและไปที่ API และบริการ > หน้าจอความยินยอมของ OAuth (APIs & Services > OAuth consent screen) Google จะนำคุณไปยัง Google Auth Platform Overview Page

3. เลือก เริ่มต้นเลย (Get started) บน Overview แท็บเพื่อเริ่มต้นการกำหนดค่าความยินยอมของ OAuth

4. ป้อน App name และ อีเมลการสนับสนุนผู้ใช้ (User support email) รวมไว้ในหน้าจอ Oauth. เลือก Next เพื่อดำเนินการ

5. สำหรับ Audience ให้เลือก Internal สำหรับการเข้าถึงผู้ใช้ภายในพื้นที่ทำงานของ Google ขององค์กรของคุณหรือ External สำหรับผู้ใช้ใด ๆ ที่มีบัญชี Google. คำอธิบายถึง Google ประเภทผู้ใช้เอกสาร สำหรับข้อมูลเพิ่มเติมเกี่ยวกับประเภทผู้ใช้ เลือก Next เพื่อดำเนินการ
   

   โหมดการทดสอบและผู้ใช้ทดสอบ (Testing mode and test users)

   หากคุณเลือก External แอปของคุณจะเริ่มต้นไปที่โหมดการทดสอบ ในโหมดนี้เพียงบัญชี Google ที่คุณเพิ่มด้วยตนเองเมื่อผู้ใช้ทดสอบสามารถเสร็จสิ้นการไหลของ OAuth - ทุกคนอื่นจะเห็นหน้าจอ "การเข้าถึงที่ปฏิเสธ" ดู Google ยังไม่ได้ยืนยันแอปนี้ เรียนรู้วิธีการเพิ่ม

6. เลือก ที่อยู่อีเมล (Email addresses) Google ควรใช้เพื่อติดต่อคุณเกี่ยวกับการเปลี่ยนแปลงโครงการของคุณ เลือก Next เพื่อดำเนินการ

7. อ่านและยอมรับนโยบายข้อมูลผู้ใช้ของ Google เลือก Continue จากนั้นเลือก Create.

8. ในเมนูด้านซ้ายเลือก Branding.

9. ใน โดเมนที่ได้รับอนุญาต (Authorized domains) ส่วน ให้เลือก เพิ่มโดเมน (Add domain):

   • หากคุณใช้บริการคลาวด์ของ n8n เพิ่ม n8n.cloud
   • ถ้าคุณเป็น โฮสติ้งด้วยตนเอง , เพิ่มโดเมนของ instance n8n ของคุณ

10. เลือก Save ด้านล่างของหน้า

สร้างใบรับรองของลูกค้า Google OAuth ของคุณ (Create your Google OAuth client credentials)

ต่อไปนี้สร้างใบรับรองของลูกค้า OAuth ใน Google:

1. การเข้าถึงของคุณ Google Cloud Console ให้แน่ใจว่าคุณอยู่ในโครงการที่ถูกต้อง

2. ใน APIs และบริการ (APIs & Services) ส่วน ให้เลือก Credentials.

3. เลือก + สร้างใบรับรอง (+ Create credentials) > ID ลูกค้า OAuth (OAuth client ID).

4. ใน ประเภทการใช้งาน (Application type) dropdown, เลือก การใช้งานเว็บไซต์ (Web application).

5. Google สร้างอัตโนมัติ Name ปรับปรุง The Name สำหรับสิ่งที่คุณจะยอมรับในคอนโซลของคุณ

6. จากการรับรอง n8n ของคุณคัดลอก OAuth Redirect URL ใส่มันลงใน URI ที่ได้รับอนุญาต (Authorized redirect URIs) ใน Google Console
   

   OAuth เปลี่ยน URL สำหรับโฮสติ้งตนเอง (OAuth redirect URL for self-hosting)

   หากคุณทำงาน n8n บนเครื่องท้องถิ่นของคุณคุณไม่จำเป็นต้องใช้โดเมนสาธารณะใบรับรอง SSL หรือพอร์ตส่งเพื่อใช้ Google OAuth Google ช่วยให้ localhost เป็น URI ที่ถูกต้องเพื่อวัตถุประสงค์การพัฒนา URL ของ n8n OAuth ของคุณจะดูเหมือนสิ่งนี้: http://localhost:5678/rest/oauth2-credential/callback สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ URIs ที่ได้รับการยอมรับ, โปรดดูที่ ไฟล์ URI ของ Google .

7. เลือก Create.

เสร็จสิ้นการรับรอง n8n ของคุณ (Finish your n8n credential)

ด้วยโครงการ Google และใบรับรองที่กำหนดเองอย่างสมบูรณ์เสร็จสิ้นใบรับรอง n8n:

1. จาก Google OAuth ลูกค้าสร้างขึ้น (OAuth client created) modal, คัดลอก the Client ID . ใส่สิ่งนี้ใน n8n การรับรองของคุณ

2. จากรูปแบบเดียวกันของ Google คัดลอก Client Secret . ใส่สิ่งนี้ใน n8n การรับรองของคุณ

3. คุณต้องให้สปอตสำหรับใบรับรองนี้ โปรดทราบว่า ขอบเขต สำหรับข้อมูลเพิ่มเติม โปรดใส่คอลัมน์หลายในรายการแยกพื้นที่เช่น:

   https://www.googleapis.com/auth/gmail.labels https://www.googleapis.com/auth/gmail.addons.current.action.compose
   

4. ใน n8n เลือก Sign in with Google เพื่อเสร็จสิ้นการรับรอง Google ของคุณ

5. Save การรับรองใหม่ของคุณ

วีดีโอ

วิดีโอต่อไปนี้แสดงให้เห็นถึงขั้นตอนที่อธิบายไว้ข้างต้น:

เปิดสื่อประกอบ

ขอบเขต

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

n8n ไม่สนับสนุนสป็อตทั้งหมด เมื่อสร้างการรับรอง API ของ Google OAuth2 คุณสามารถเข้าสู่สป็อตจาก ปลั๊กที่ได้รับการสนับสนุน (Supported scopes) รายการด้านล่าง หากคุณเข้าสู่ช่วงที่ n8n ไม่สนับสนุนแล้วมันจะไม่ทำงาน

การแก้ไขปัญหา

Google ยังไม่ได้ยืนยันแอปนี้ (Google hasn't verified this app)

หากใช้วิธีการตรวจสอบสิทธิ์ OAuth คุณอาจเห็นคำเตือน Google ยังไม่ได้ยืนยันแอปนี้ (Google hasn't verified this app) . เพื่อหลีกเลี่ยงสิ่งนี้:

• หากแอปของคุณ User Type คือ Internal ให้สร้าง credentials OAuth จากบัญชีเดียวกับที่คุณต้องการตรวจสอบสิทธิ์
• หากแอปของคุณ User Type คือ External คุณสามารถเพิ่มอีเมลของคุณลงในรายชื่อผู้ทดสอบสำหรับแอปได้: ไปที่ Audience และเพิ่มอีเมลที่คุณลงชื่อเข้าใช้ลงในรายการ ผู้ใช้ทดสอบ (Test users).

หากคุณจำเป็นต้องใช้ credentials ที่สร้างโดยบัญชีอื่น (โดยนักพัฒนาหรือบุคคลที่สามอื่น) ให้ทำตามคำแนะนำใน เอกสารประกอบของ Google Cloud | ข้อผิดพลาดในการให้สิทธิ์: Google ยังไม่ได้ยืนยันแอปนี้ .

แอป Google Cloud ไม่ได้รับอนุญาต (Google Cloud app becoming unauthorized)

สำหรับแอป Google Cloud ด้วย สถานะการเผยแพร่ (Publishing status) ตั้งค่าเป็น Testing และ ประเภทผู้ใช้ (User type) ตั้งค่าเป็น External ความยินยอมและ token จะหมดอายุหลังจากเจ็ดวัน อ้างถึง ความช่วยเหลือเกี่ยวกับคอนโซลแพลตฟอร์ม Google Cloud | การตั้งค่าหน้าจอยินยอม OAuth สำหรับข้อมูลเพิ่มเติม หากต้องการแก้ไขปัญหานี้ ให้เชื่อมต่อแอปอีกครั้งในโมดอลข้อมูลประจำตัว n8n

แนะนำ_uri_mismatch (redirect_uri_mismatch)

ข้อผิดพลาดนี้หมายความว่า URI n8n จะส่งไม่ตรงกับ URI ที่ลงทะเบียนในลูกค้า OAuth ของ Google Cloud Console ของคุณ

Fix: คัดลอก OAuth Redirect URL จากแผงการรับรอง n8n ของคุณและติดมันอย่างแม่นยำ — รวมถึงโปรโตคอล ( http หรือ https ) และหมายเลขพอร์ต - ไปยัง URI ที่ได้รับอนุญาต (Authorized redirect URIs) พื้นที่ของลูกค้า Google OAuth ของคุณ

การเข้าถึงที่ปฏิเสธ / "แอปที่ไม่ได้รับการตรวจสอบ" (Access denied / "app not verified")

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

Fix: ไปที่ APIs และบริการ (APIs & Services) > หน้าจอความยินยอม OAuth (OAuth consent screen) > ผู้ใช้ทดสอบ (Test users) และเพิ่มบัญชีที่คุณกำลังพยายามใช้

invalid / ลูกค้า (invalid_client)

ข้อผิดพลาดนี้มักจะหมายความว่า ID ของลูกค้าหรือ Client Secret ใน n8n ของคุณไม่ตรงกับสิ่งที่อยู่ใน Google Cloud Console

Fix: กลับไปที่ลูกค้า OAuth ของคุณใน Google Cloud Console คัดลอกทั้งสองค่าใหม่และป้อนอีกครั้งใน n8n ตรวจสอบให้แน่ใจว่าพื้นที่ที่ผิดพลาดเมื่อคัดลอก