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

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

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

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

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

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

Apps Script

  • โปรเจ็กต์ 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

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

หากต้องการระบุข้อผิดพลาดของการสมัครใช้บริการ ให้ตรวจสอบช่อง 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 บัญชีบริการคือ chat-api-push@system.gserviceaccount.com สำหรับเหตุการณ์ Google Meet บัญชีบริการคือ meet-api-event-push@system.gserviceaccount.com

สําหรับหัวข้อ 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 จะใช้ข้อผิดพลาดเดิมที่ทำให้การสมัครใช้บริการถูกระงับเสมอ