แก้ไขข้อผิดพลาดและเปิดใช้งานการสมัครใช้บริการ Google Workspace อีกครั้ง

หน้านี้อธิบายวิธีเปิดใช้งานการสมัครใช้บริการ Google Workspace ที่ถูกระงับอีกครั้งโดยการแก้ไขหรือแก้ไขข้อผิดพลาดและการเรียกใช้เมธอด subscriptions.reactivate()

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

คุณดูข้อมูลเกี่ยวกับการสมัครใช้บริการที่ถูกระงับได้ดังนี้

• แอปของคุณจะได้รับเหตุการณ์ในวงจรเกี่ยวกับช่วงพัก หากการสมัครใช้บริการถูกระงับเนื่องจากข้อผิดพลาดเกี่ยวกับปลายทาง คุณอาจไม่ได้รับการแจ้งเตือนเหตุการณ์ในวงจรของลูกค้า
• คุณใช้เมธอด subscriptions.get() หรือ subscriptions.list() เพื่อดูว่าช่อง state ของการสมัครใช้บริการตั้งค่าเป็น SUSPENDED หรือไม่
• คุณได้รับการแจ้งเตือนเกี่ยวกับการส่งไปยังปลายทางของการแจ้งเตือนไม่สำเร็จ หากต้องการเรียนรู้เกี่ยวกับการเฝ้าติดตามความล้มเหลวในการนำส่งไปยังหัวข้อ Google Cloud Pub/Sub โปรดดูจัดการความล้มเหลวของข้อความ

การสมัครใช้บริการที่เปิดใช้งานอีกครั้งจะมีวันที่หมดอายุเดิม หากต้องการขยายเวลาหมดอายุของการสมัครใช้บริการ โปรดดูหัวข้ออัปเดตหรือต่ออายุการสมัครใช้บริการ

Apps Script

• การสมัครใช้บริการ Google Workspace ในการสร้างการสมัครใช้บริการ โปรดดูสร้างการสมัครใช้บริการ

• ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ด้วยขอบเขตที่รองรับเหตุการณ์ทุกประเภทสำหรับการสมัครใช้บริการอย่างน้อย 1 ขอบเขต

  หมายเหตุ: หากต้องการเรียกใช้ตัวอย่างโค้ดในคู่มือนี้ คุณต้องใช้ข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth เดียวกันกับที่ใช้สร้างการสมัครใช้บริการ

• โครงการ Apps Script:
  • ใช้โปรเจ็กต์ Google Cloud แทนโปรเจ็กต์เริ่มต้นที่ Apps Script สร้างขึ้นโดยอัตโนมัติ
  • สําหรับขอบเขตที่คุณเพิ่มเพื่อกําหนดค่าหน้าจอขอความยินยอม OAuth คุณต้องเพิ่มขอบเขตนั้นลงในไฟล์ appsscript.json ในโปรเจ็กต์ Apps Script ด้วย เช่น

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • เปิดใช้บริการขั้นสูง Google Workspace Events

Python

• Python 3.6 ขึ้นไป
• เครื่องมือจัดการแพ็กเกจ pip
• ไลบรารีของไคลเอ็นต์ Google ล่าสุดสำหรับ Python หากต้องการติดตั้งหรืออัปเดต ให้เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• การสมัครใช้บริการ Google Workspace หากต้องการสร้างการสมัครใช้บริการ โปรดดูหัวข้อสร้างการสมัครใช้บริการ

• กำหนดให้ต้องตรวจสอบสิทธิ์ผู้ใช้ด้วยขอบเขตที่รองรับเหตุการณ์ทุกประเภทสำหรับการสมัครใช้บริการอย่างน้อย 1 รายการ

  หมายเหตุ: หากต้องการเรียกใช้ตัวอย่างโค้ดในคู่มือนี้ คุณต้องใช้ข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth เดียวกันกับที่ใช้สร้างการสมัครใช้บริการ

ระบุและแก้ไขข้อผิดพลาด

หากต้องการระบุข้อผิดพลาดของการสมัครใช้บริการ ให้ตรวจสอบช่อง suspensionReason ของการสมัครใช้บริการ คุณจะพบช่องนี้เมื่อได้รับเหตุการณ์ตลอดอายุเกี่ยวกับการระงับ หรือใช้เมธอด subscriptions.get() เพื่อตรวจสอบช่องทั้งหมดสำหรับการสมัครใช้บริการ

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

ข้อผิดพลาด	คำอธิบาย	วิธีแก้ไข
USER_SCOPE_REVOKED	ผู้ใช้ที่ให้สิทธิ์ได้เพิกถอนการให้สิทธิ์ OAuth อย่างน้อย 1 ขอบเขตที่จําเป็นสําหรับการสมัครใช้บริการ	รับโทเค็นการเข้าถึงอื่น โปรดดูรายละเอียดที่หัวข้อ รับโทเค็นเพื่อการเข้าถึงจากเซิร์ฟเวอร์การให้สิทธิ์ของ Google
RESOURCE_DELETED	ลบทรัพยากรเป้าหมายสำหรับการสมัครใช้บริการแล้ว	หากมีการกู้คืนทรัพยากร ให้เรียกใช้เมธอด reactivate() แต่หากไม่ต้องการ คุณก็ไม่ต้องดำเนินการใดๆ เนื่องจากคุณจะเปิดใช้งานการสมัครใช้บริการอีกครั้งไม่ได้หากไม่มีทรัพยากรเป้าหมายเดิม
USER_AUTHORIZATION_FAILURE	ผู้ใช้ที่ให้สิทธิ์จะไม่มีสิทธิ์เข้าถึงทรัพยากรสำหรับการสมัครใช้บริการอีกต่อไป	ไม่ต้องดำเนินการใดๆ คุณจะเปิดใช้งานการสมัครใช้บริการอีกครั้งไม่ได้ เนื่องจากผู้ใช้ที่ให้สิทธิ์เข้าถึงไม่สามารถเข้าถึงทรัพยากรเป้าหมายได้
ENDPOINT_PERMISSION_DENIED	แอปพลิเคชัน Google Workspace ไม่มีสิทธิ์เข้าถึงเพื่อส่งเหตุการณ์ไปยังปลายทางการแจ้งเตือน	ให้สิทธิ์เข้าถึงบัญชีบริการสําหรับแอปพลิเคชัน Google Workspace ที่ส่งเหตุการณ์ สําหรับเหตุการณ์ Google Chat บัญชีบริการคือ [e-mail] สำหรับเหตุการณ์ Google Meet บัญชีบริการคือ [e-mail] สําหรับหัวข้อ Pub/Sub ให้มอบบทบาทผู้เผยแพร่เนื้อหา Pub/Sub (roles/pubsub.publisher) ให้กับบัญชีบริการ
ENDPOINT_NOT_FOUND	ไม่มีหรือไม่พบปลายทางการแจ้งเตือน	ตรวจสอบว่าปลายทางยังทำงานอยู่และใช้งานได้ หากต้องการแก้ปัญหาเกี่ยวกับหัวข้อ Pub/Sub โปรดดูเอกสารประกอบเกี่ยวกับการแก้ปัญหา
ENDPOINT_RESOURCE_EXHAUSTED	จุดสิ้นสุดการแจ้งเตือนไม่ได้รับเหตุการณ์เนื่องจากโควต้าไม่เพียงพอหรือถึงขีดจำกัดอัตรา	ขอเพิ่มโควต้า

เปิดใช้งานการสมัครใช้บริการอีกครั้ง

หลังจากแก้ไขข้อผิดพลาดที่ทำให้การสมัครใช้บริการถูกระงับแล้ว คุณจะใช้วิธี reactivate() เพื่อให้การสมัครใช้บริการรับเหตุการณ์อีกครั้งได้ วิธีการนี้จะตรวจสอบว่าข้อผิดพลาดทั้งหมดได้รับการแก้ไขแล้ว และเปลี่ยนช่อง state ของการสมัครใช้บริการจาก SUSPENDED เป็น ACTIVE

วิธีเปิดใช้งานการสมัครใช้บริการ Google Workspace อีกครั้ง

Apps Script

1. ในโปรเจ็กต์ Apps Script ให้สร้างไฟล์สคริปต์ใหม่ชื่อ reactivateSubscription แล้วเพิ่มโค้ดต่อไปนี้

   function reactivateSubscription() {
     // The name of the subscription to reactivate.
     const name = 'subscriptions/SUBSCRIPTION_ID';
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.reactivate({}, name);
     console.log(response);
   }
   

   แทนที่ค่าต่อไปนี้

   • SUBSCRIPTION_ID: รหัสของการสมัครใช้บริการ คุณใช้สิ่งต่อไปนี้เพื่อรับรหัสได้
     • ค่าของช่อง uid
     • รหัสของชื่อทรัพยากรที่แสดงในช่อง name เช่น หากชื่อทรัพยากรคือ subscriptions/subscription-123 ให้ใช้ subscription-123

2. หากต้องการเปิดใช้งานการสมัครใช้บริการ Google Workspace อีกครั้ง ให้เรียกใช้ฟังก์ชัน reactivateSubscription ในโปรเจ็กต์ Apps Script

Python

1. ในไดเรกทอรีที่ทำงานอยู่ ให้สร้างไฟล์ชื่อ reactivate_subscription.py แล้วเพิ่มโค้ดต่อไปนี้

   """Reactivate subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = [SCOPES]
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   NAME = 'subscriptions/SUBSCRIPTION_ID'
   response = service.subscriptions().reactivate(name=NAME).execute()
   print(response)
   

   แทนที่ค่าต่อไปนี้

   • SCOPES: ขอบเขต OAuth อย่างน้อย 1 รายการที่รองรับเหตุการณ์แต่ละประเภทสำหรับการสมัครใช้บริการ จัดรูปแบบเป็นอาร์เรย์สตริง หากต้องการแสดงขอบเขตหลายรายการ ให้คั่นด้วยคอมมา เช่น 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
   • SUBSCRIPTION_ID: รหัสการสมัครใช้บริการ คุณใช้สิ่งต่อไปนี้เพื่อรับรหัสได้
     • ค่าของช่อง uid
     • รหัสของชื่อทรัพยากรที่แสดงในช่อง name เช่น หากชื่อทรัพยากรคือ subscriptions/subscription-123 ให้ใช้ subscription-123

2. ในไดเรกทอรีทํางาน ให้ตรวจสอบว่าคุณได้จัดเก็บข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และตั้งชื่อไฟล์เป็น client_secrets.json แล้ว ตัวอย่างโค้ดใช้ไฟล์ JSON นี้เพื่อตรวจสอบสิทธิ์กับ Google Workspace และรับข้อมูลเข้าสู่ระบบของผู้ใช้ โปรดดูวิธีการที่หัวข้อสร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth

3. หากต้องการเปิดใช้งานการสมัครใช้บริการ Google Workspace อีกครั้ง ให้เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล

   python3 reactivate_subscription.py

Google Workspace Events API จะแสดงการดำเนินการที่ทำงานต่อเนื่องซึ่งมีอินสแตนซ์ของทรัพยากร Subscription

หากคำขอไม่สำเร็จ โปรดดูส่วนต่อไปนี้เพื่อแก้ปัญหาข้อผิดพลาดเพิ่มเติม

แก้ปัญหาข้อผิดพลาดหลายรายการ

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

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

เมื่อการสมัครใช้บริการมีข้อผิดพลาดหลายรายการ ค่าสำหรับช่อง suspensionReason จะใช้ข้อผิดพลาดเดิมที่ทำให้การสมัครใช้บริการถูกระงับเสมอ

หัวข้อที่เกี่ยวข้อง

• อัปเดตหรือต่ออายุการสมัครใช้บริการ
• ลบการสมัครใช้บริการ
• สมัครใช้บริการ
• แสดงรายการการสมัครใช้บริการ
• สร้างการสมัครใช้บริการ