ดูรายละเอียดเกี่ยวกับการสมัครใช้บริการ Google Workspace

หน้านี้อธิบายวิธีดูรายละเอียดเกี่ยวกับการสมัครใช้บริการ Google Workspace โดยใช้เมธอด subscriptions.get()

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

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

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 หากต้องการสร้างการสมัครใช้บริการ โปรดดูหัวข้อสร้างการสมัครใช้บริการ

  • ต้องมีการตรวจสอบสิทธิ์ในกรณีต่อไปนี้

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

รับการสมัครใช้บริการที่ได้รับอนุญาตจากผู้ใช้

ตัวอย่างโค้ดต่อไปนี้จะแสดงรายละเอียดเกี่ยวกับSubscriptionทรัพยากรที่ใช้การตรวจสอบสิทธิ์ผู้ใช้ เมื่อตรวจสอบสิทธิ์ในฐานะผู้ใช้แล้ว เมธอดจะแสดงการสมัครใช้บริการที่ผู้ใช้อนุญาตให้แอปสร้าง

วิธีรับการสมัครใช้บริการที่ได้รับอนุญาตจากผู้ใช้

Apps Script

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

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

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

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

Python

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

    """Get subscription."""
    
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = ['SCOPE']
    
    # 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'
    subscription = service.subscriptions().get(name=NAME).execute()
    print(subscription)
    

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

    • SCOPE: ขอบเขต OAuth ที่รองรับเหตุการณ์อย่างน้อย 1 ประเภทจากการสมัครใช้บริการ เช่น หากการสมัครใช้บริการได้รับกิจกรรม ในพื้นที่ใน Chat ที่อัปเดตแล้ว https://www.googleapis.com/auth/chat.spaces.readonly
    • SUBSCRIPTION_ID: รหัสของการสมัครใช้บริการ หากต้องการรับรหัส ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
      • ค่าของช่อง uid
      • รหัสของชื่อทรัพยากรที่แสดงในช่อง name เช่น หากชื่อทรัพยากรคือ subscriptions/subscription-123 ให้ใช้ subscription-123
  2. ในไดเรกทอรีที่ทำงาน ให้ตรวจสอบว่าคุณได้เก็บข้อมูลเข้าสู่ระบบของรหัสไคลเอ็นต์ OAuth และตั้งชื่อไฟล์เป็น client_secrets.json แล้ว ตัวอย่างโค้ดจะใช้ไฟล์ JSON นี้เพื่อตรวจสอบสิทธิ์กับ Google Workspace และรับข้อมูลเข้าสู่ระบบของผู้ใช้ โปรดดูวิธีการที่หัวข้อสร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth

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

    python3 get_subscription.py