อัปเดตหรือต่ออายุการสมัครใช้บริการ Google Workspace

หน้านี้อธิบายวิธีต่ออายุการสมัครใช้บริการ Google Workspace โดยใช้เมธอด subscriptions.update() คุณสามารถใช้วิธีการนี้เพื่ออัปเดตเวลาหมดอายุของการสมัครรับข้อมูล ซึ่งรวมถึงการต่ออายุการสมัครรับข้อมูลเพื่อให้ได้เวลาหมดอายุสูงสุด

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

ต่ออายุการสมัครใช้บริการ Google Workspace

ในส่วนนี้ คุณจะใช้เมธอด subscriptions.update() ของ Google Workspace Events API เพื่อต่ออายุการสมัครใช้บริการให้ถึงวันที่หมดอายุสูงสุด หากต้องการระบุเวลาหมดอายุสูงสุด ให้อัปเดตช่อง ttl ของทรัพยากร Subscription เป็น 0

เวลาหมดอายุสูงสุดขึ้นอยู่กับข้อมูลทรัพยากรที่รวมอยู่ในเพย์โหลดของเหตุการณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับเวลาหมดอายุได้ที่ข้อมูลเหตุการณ์สำหรับเหตุการณ์ของ Google Workspace

วิธีต่ออายุการสมัครใช้บริการ Google Workspace

Apps Script

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

    function updateSubscription() {
  // The name of the subscription to update.
  const name = 'subscriptions/SUBSCRIPTION_ID';

  // Call the Workspace Events API using the advanced service.
  const response = WorkspaceEvents.Subscriptions.patch({
    ttl: '0s',
  }, name);
  console.log(response);
}

    แทนที่รายการต่อไปนี้

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

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

Python

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

    """Update 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,
)

BODY = {
    'ttl': {'seconds': 0},
}
NAME = 'subscriptions/SUBSCRIPTION_ID'
response = (
    service.subscriptions()
    .patch(name=NAME, updateMask='ttl', body=BODY)
    .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 update_subscription.py
Google Workspace Events API แสดงผลการดำเนินการที่ใช้เวลานานซึ่งมีอินสแตนซ์ของทรัพยากร Subscription

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