สร้างการสมัครใช้บริการ Google Workspace

Apps Script

• วิธีใช้คำสั่ง Google Cloud CLI ในคู่มือนี้
  1. ติดตั้ง Google Cloud CLI
  2. ถึง เริ่มต้น CLI ของ gcloud แล้วเรียกใช้โค้ดต่อไปนี้

    gcloud init
    

• โปรเจ็กต์ Google Cloud โดยเปิดใช้การเรียกเก็บเงิน สําหรับการสมัครใช้บริการ Chat คุณต้องทำดังนี้ เปิดใช้ Chat API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์และ กำหนดค่าชื่อแอป, URL ของรูปโปรไฟล์ และคำอธิบาย ด้วย โปรดดูรายละเอียดที่หัวข้อ สร้างแอป Google Chat
• ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ด้วยหน้าจอความยินยอม 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 Cloud CLI ในคู่มือนี้
  1. ติดตั้ง Google Cloud CLI
  2. ถึง เริ่มต้น CLI ของ gcloud แล้วเรียกใช้โค้ดต่อไปนี้

    gcloud init
    

• โปรเจ็กต์ Google Cloud โดยเปิดใช้การเรียกเก็บเงิน สําหรับการสมัครใช้บริการ Chat คุณต้องทำดังนี้ เปิดใช้ Chat API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์และ กำหนดค่าชื่อแอป, URL ของรูปโปรไฟล์ และคำอธิบาย ด้วย โปรดดูรายละเอียดที่หัวข้อ สร้างแอป Google Chat
• ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ด้วยหน้าจอความยินยอม OAuth ที่กำหนดค่าสำหรับ แอปนั้น เมื่อกำหนดค่าหน้าจอคำยินยอม คุณต้องระบุขอบเขตเพื่อ รองรับเหตุการณ์แต่ละประเภทสำหรับการสมัครใช้บริการ วิธีกำหนดค่าความยินยอม และระบุขอบเขตที่จำเป็น โปรดดู เลือกขอบเขต

คอนโซล Google Cloud

ในคอนโซล Google Cloud ให้เปิดโปรเจ็กต์ Google Cloud สําหรับแอปและเปิดใช้ Google Workspace Events API และ Pub/Sub API

เปิดใช้ API

gcloud

1. ในไดเรกทอรีที่ใช้งานได้ ให้ลงชื่อเข้าใช้บัญชี Google ของคุณ:

   gcloud auth login
   

2. ตั้งค่าโปรเจ็กต์เป็นโปรเจ็กต์ที่อยู่ในระบบคลาวด์สําหรับแอปของคุณ โดยทำดังนี้

   gcloud config set project PROJECT_ID
   

   แทนที่ PROJECT_ID ด้วย รหัสโปรเจ็กต์สำหรับโปรเจ็กต์ระบบคลาวด์ของแอป

3. เปิดใช้ Google Workspace Events API และ Google Cloud Pub/Sub API:

   gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com
   

คอนโซล Google Cloud

1. ในคอนโซล Google Cloud ให้ไปที่หน้า Pub/Sub แล้วดำเนินการดังนี้

   ไปที่ Google Cloud Pub/Sub

   ตรวจสอบว่าได้เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์สำหรับแอปแล้ว

2. คลิกadd_box สร้างหัวข้อและ ให้ทำดังนี้

   1. ป้อนชื่อหัวข้อ เช่น workspace-events-topic
   2. คงการเลือกเพิ่มการสมัครใช้บริการเริ่มต้นไว้ Pub/Sub ตั้งชื่อสิ่งนี้ การสมัครใช้บริการเริ่มต้นที่คล้ายกับชื่อหัวข้อของคุณ เช่น workspace-events-topic-sub
   3. ไม่บังคับ: อัปเดตหรือกำหนดค่าพร็อพเพอร์ตี้เพิ่มเติม สำหรับหัวข้อของคุณ

3. คลิกสร้าง ชื่อหัวข้อแบบเต็มมีรูปแบบเป็น projects/PROJECT_ID/topics/TOPIC_ID คุณจะใช้ชื่อเต็มนี้ในขั้นตอนถัดไป

4. ให้สิทธิ์เข้าถึงเพื่อเผยแพร่ข้อความ Pub/Sub ไปยังหัวข้อของคุณ:

   1. ในหน้าหัวข้อ ให้ไปที่แผงด้านข้างและเปิด สิทธิ์
   2. คลิกเพิ่มผู้ใช้หลัก
   3. ในช่องเพิ่มผู้ใช้หลัก ให้เพิ่มบัญชีบริการสำหรับ แอปพลิเคชัน Google Workspace ที่ส่งกิจกรรมให้กับ การสมัครใช้บริการ:
      1. สำหรับกิจกรรมใน Chat chat-api-push@system.gserviceaccount.com
      2. สำหรับกิจกรรมใน Meet meet-api-event-push@system.gserviceaccount.com
   4. ในเมนูมอบหมายบทบาท ให้เลือก Pub/Sub Publisher
   5. คลิกบันทึก การอัปเดตสิทธิ์อาจใช้เวลาสักครู่ สำหรับหัวข้อของคุณ

gcloud

1. สร้างหัวข้อในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ด้วยการเรียกใช้โค้ดต่อไปนี้ คำสั่ง:

   gcloud pubsub topics create TOPIC_ID
   

   แทนที่ TOPIC_ID ด้วยรหัสที่ไม่ซ้ำกันสำหรับหัวข้อ เช่น ด้วยชื่อ workspace-events-topic

   ผลลัพธ์จะแสดงชื่อหัวข้อแบบเต็ม โดยมีรูปแบบเป็น projects/PROJECT_ID/topics/TOPIC_ID จดบันทึกชื่อและตรวจสอบว่าค่าของ PROJECT_ID คือรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ สำหรับแอปของคุณ คุณใช้ชื่อหัวข้อในขั้นตอนต่อไปนี้ และเพื่อสร้าง การสมัครใช้บริการ Google Workspace ในภายหลัง

2. วิธีให้สิทธิ์เพื่อเผยแพร่ข้อความในหัวข้อของคุณ

   gcloud pubsub topics add-iam-policy-binding TOPIC_NAME --member='serviceAccount:GOOGLE_WORKSPACE_APPLICATION' --role='roles/pubsub.publisher'
   

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

   • TOPIC_NAME: ชื่อเต็มของหัวข้อ ซึ่งก็คือ เอาต์พุตจากขั้นตอนก่อนหน้า จัดรูปแบบเป็น projects/PROJECT_ID/topics/TOPIC_ID

   • GOOGLE_WORKSPACE_APPLICATION: แอปพลิเคชัน Google Workspace ที่ต้องนำส่งกิจกรรมไปยัง การสมัครใช้บริการของคุณ:

     • หากต้องการรับกิจกรรมจาก Chat ให้ใช้ chat-api-push@system.gserviceaccount.com
     • หากต้องการรับกิจกรรมจาก Meet ให้ใช้ meet-api-event-push@system.gserviceaccount.com

   การอัปเดตสิทธิ์สำหรับหัวข้ออาจใช้เวลา 2-3 นาที

3. สร้างการสมัครใช้บริการ Pub/Sub สำหรับหัวข้อโดยทำดังนี้

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME
   

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

   • SUBSCRIPTION_NAME: ชื่อสำหรับการสมัครใช้บริการของคุณ เช่น workspace-events-subscription
   • TOPIC_NAME: ชื่อหัวข้อที่คุณสร้าง ในขั้นตอนก่อนหน้า

Apps Script

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

   function createSubscription() {
     // The Google Workspace resource to monitor for events.
     const targetResource = 'TARGET_RESOURCE';
   
     // The types of events to receive.
     const eventTypes = [EVENT_TYPES];
   
     // The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
     const pubsubTopic = 'TOPIC_NAME';
   
     // Whether to include resource data or not.
     const resourceData = RESOURCE_DATA;
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.create({
       targetResource: targetResource,
       eventTypes: eventTypes,
       notificationEndpoint: {
         pubsubTopic: pubsubTopic,
       },
       payloadOptions: {
         includeResource: resourceData
       }
     });
     console.log(response);
   }
   

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

   • TARGET_RESOURCE: แหล่งข้อมูลของ Google Workspace ที่คุณกำลังสมัครใช้บริการ โดยมีรูปแบบเป็นชื่อทรัพยากรแบบเต็ม สำหรับ เช่น หากต้องการสมัครใช้บริการพื้นที่ใน Google Chat ด้วยรหัสพื้นที่ทำงาน AAAABBBB ใช้ //chat.googleapis.com/spaces/AAAABBBB
   • EVENT_TYPES: ประเภทเหตุการณ์อย่างน้อย 1 ประเภท ที่คุณต้องการสมัครใช้บริการในทรัพยากรเป้าหมาย จัดรูปแบบเป็น อาร์เรย์ของสตริง เช่น 'google.workspace.chat.message.v1.created'
   • TOPIC_NAME: ชื่อเต็มของหัวข้อ Pub/Sub ที่ ที่คุณสร้างในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ จัดรูปแบบเป็น projects/PROJECT_ID/topics/TOPIC_ID

   • RESOURCE_DATA: บูลีนที่ระบุว่า การสมัครใช้บริการจะมีข้อมูลทรัพยากรในเพย์โหลดดังนี้

     • True: รวมข้อมูลทรัพยากรทั้งหมด เพื่อจำกัดช่องที่ รวม ให้เพิ่ม fieldMask และระบุอย่างน้อย 1 ช่องสำหรับทรัพยากรที่เปลี่ยนแปลง เฉพาะ การสมัครรับการสนับสนุนทรัพยากรของ Chat ซึ่งรวมถึง ข้อมูลทรัพยากร
     • False: ไม่รวมข้อมูลทรัพยากร

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

Python

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

   """Create 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()
   
   # The Google Workspace resource to monitor for events.
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   # The types of events to receive.
   EVENT_TYPES = [EVENT_TYPES]
   
   # The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
   TOPIC = 'TOPIC_NAME'
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'target_resource': TARGET_RESOURCE,
       'event_types': EVENT_TYPES,
       'notification_endpoint': {'pubsub_topic': TOPIC},
       'payload_options': {'include_resource': RESOURCE_DATA},
   }
   response = service.subscriptions().create(body=BODY).execute()
   print(response)
   

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

   • SCOPES: ขอบเขต OAuth อย่างน้อย 1 รายการที่รองรับเหตุการณ์แต่ละประเภท สำหรับการสมัครใช้บริการ จัดรูปแบบเป็นอาร์เรย์ของสตริง หากต้องการแสดงรายการขอบเขตหลายรายการ ให้คั่นด้วยเครื่องหมายจุลภาค เช่น 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
   • TARGET_RESOURCE: แหล่งข้อมูลของ Google Workspace ที่คุณกำลังสมัครใช้บริการ โดยมีรูปแบบเป็นชื่อทรัพยากรแบบเต็ม สำหรับ เช่น หากต้องการสมัครใช้บริการพื้นที่ใน Google Chat ด้วยรหัสพื้นที่ทำงาน AAAABBBB ใช้ //chat.googleapis.com/spaces/AAAABBBB
   • EVENT_TYPES: ประเภทเหตุการณ์อย่างน้อย 1 ประเภท ที่คุณต้องการสมัครใช้บริการในทรัพยากรเป้าหมาย จัดรูปแบบเป็น อาร์เรย์ของสตริง เช่น 'google.workspace.chat.message.v1.created'
   • TOPIC_NAME: ชื่อเต็มของหัวข้อ Pub/Sub ที่ ที่คุณสร้างในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ จัดรูปแบบเป็น projects/PROJECT_ID/topics/TOPIC_ID

   • RESOURCE_DATA: บูลีนที่ระบุว่า การสมัครใช้บริการจะมีข้อมูลทรัพยากรในเพย์โหลดดังนี้

     • True: รวมข้อมูลทรัพยากรทั้งหมด เพื่อจำกัดช่องที่ รวม ให้เพิ่ม fieldMask และระบุอย่างน้อย 1 ช่องสำหรับทรัพยากรที่เปลี่ยนแปลง เฉพาะ การสมัครรับการสนับสนุนทรัพยากรของ Chat ซึ่งรวมถึง ข้อมูลทรัพยากร
     • False: ไม่รวมข้อมูลทรัพยากร

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

   python3 create_subscription.py
   

คอนโซล Google Cloud

1. ทริกเกอร์เหตุการณ์อย่างน้อย 1 ประเภทในทรัพยากรเป้าหมาย การสมัครใช้บริการ Google Workspace เช่น หากสมัครรับข้อมูล ข้อความในพื้นที่ใน Chat ให้โพสต์ข้อความไปยังพื้นที่ทำงาน

2. ในคอนโซล Google Cloud ให้ไปที่หน้า Pub/Sub แล้วดำเนินการดังนี้

   ไปที่ Pub/Sub

   ตรวจสอบว่าได้เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์สำหรับแอปแล้ว

3. คลิกการสมัครรับข้อมูลในเมนู Pub/Sub

4. ในตาราง ค้นหาการสมัครใช้บริการ Pub/Sub สำหรับหัวข้อของคุณและคลิก ชื่อการสมัครใช้บริการ

5. คลิกแท็บข้อความ

6. คลิกพุล การสร้างเหตุการณ์อาจใช้เวลา 2-3 นาที ข้อความ Pub/Sub

gcloud

1. ทริกเกอร์เหตุการณ์อย่างน้อย 1 ประเภทในทรัพยากรเป้าหมาย การสมัครใช้บริการ Google Workspace เช่น หากสมัครรับข้อมูล ข้อความในพื้นที่ใน Chat ให้โพสต์ข้อความในพื้นที่ทำงาน

2. เรียกใช้คำสั่งต่อไปนี้

   gcloud pubsub subscriptions pull PUBSUB_SUBSCRIPTION_NAME --format=json --limit=MESSAGE_COUNT --auto-ack
   

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

   • PUBSUB_SUBSCRIPTION_NAME: ชื่อและนามสกุลของคุณ การสมัครใช้บริการ Pub/Sub ซึ่งมีรูปแบบเป็น projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID
   • MESSAGE_COUNT: จำนวนข้อความ Pub/Sub สูงสุดที่คุณต้องการดึง

   การสร้าง Pub/Sub อาจใช้เวลา 2-3 นาทีสำหรับกิจกรรม