นำเข้าข้อมูลไปยัง Google Chat

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

ต่อไปนี้เป็นภาพรวมกระบวนการนําเข้าที่สมบูรณ์

  1. วางแผนการนําเข้า
  2. กำหนดค่าการให้สิทธิ์สำหรับแอป Chat
  3. สร้างพื้นที่ทำงานในโหมดการนําเข้า
  4. นําเข้าทรัพยากร
  5. ตรวจสอบทรัพยากรที่นําเข้า
  6. ปรับยอดความแตกต่างของทรัพยากรที่นําเข้าจากข้อมูลต้นทาง
  7. โหมดการนําเข้าที่สมบูรณ์
  8. ให้สิทธิ์เข้าถึงพื้นที่ทำงานหลังจากโหมดการนำเข้า
  9. การแก้ปัญหา

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

Apps Script

Python

วางแผนการนําเข้า

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

ตรวจสอบขีดจำกัดการใช้งาน API

เวลาที่ใช้ในการนำเข้าข้อมูลไปยัง Chat อาจแตกต่างกันไปอย่างมาก โดยขึ้นอยู่กับจำนวนทรัพยากรของ Chat ที่จะนำเข้า ตรวจสอบขีดจำกัดการใช้งานของแอป Chat และปริมาณข้อมูลที่กําหนดเวลาให้นําเข้าจากแพลตฟอร์มการรับส่งข้อความต้นทางเพื่อกําหนดลําดับเวลาโดยประมาณ

เมื่อนำเข้าข้อความไปยังพื้นที่ทำงาน เราขอแนะนำให้คุณกระจายการเรียกใช้เมธอด messages.create() ไปยังชุดข้อความต่างๆ

ระบุพื้นที่ทำงานที่รองรับเพื่อนําเข้า

โหมดการนําเข้ารองรับเฉพาะ SpaceType ของ SPACE และ GROUP_CHAT เท่านั้น แต่จะไม่รองรับ DIRECT_MESSAGE ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบสำหรับ SpaceType

สร้างพื้นที่ทำงานในโหมดการนำเข้า

หากต้องการสร้างพื้นที่ทำงานในโหมดการนำเข้า ให้เรียกใช้เมธอด create ในทรัพยากร Space แล้วตั้งค่า importMode เป็น true

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อสร้างพื้นที่ทำงานในโหมดการนำเข้า

  • วันที่และเวลา - โปรดทราบว่าโหมดการนําเข้าต้องเสร็จสมบูรณ์ภายใน 90 วัน หากพื้นที่ทำงานยังคงอยู่ในโหมดการนำเข้าหลังจากผ่านไป 90 วันนับจากเวลาที่เรียกใช้เมธอด spaces.create() ระบบจะลบพื้นที่ทำงานโดยอัตโนมัติและจะไม่สามารถเข้าถึงได้และจะกู้คืนไม่ได้
    • ใช้ค่าของช่อง importModeExpireTime เพื่อติดตามการหมดอายุของกรอบเวลา 90 วัน
    • อย่าใช้ค่าของช่อง createTime เพื่อติดตามการหมดอายุของกรอบเวลา 90 วัน ซึ่งอาจไม่เหมือนกับเมื่อคุณเรียกใช้เมธอด spaces.create() เมื่อใช้โหมดการนําเข้า คุณสามารถตั้งค่าช่อง createTime เป็นการประทับเวลาย้อนหลังเมื่อสร้างพื้นที่ทํางานในแหล่งที่มาเพื่อรักษาเวลาสร้างเดิม
  • ชื่อทรัพยากรของพื้นที่ทำงาน (name) - ตัวระบุที่ไม่ซ้ำกันซึ่งใช้เพื่อดึงข้อมูลเกี่ยวกับพื้นที่ทำงานที่เฉพาะเจาะจงและจะอ้างอิงในขั้นตอนต่อๆ ไปเมื่อนำเข้าเนื้อหาไปยังพื้นที่ทำงาน

หากต้องการเก็บรักษาเวลาสร้างเอนทิตีพื้นที่ทำงานที่เทียบเท่าจากแพลตฟอร์มการรับส่งข้อความต้นทาง คุณสามารถตั้งค่า createTime ของพื้นที่ทำงานได้ createTime นี้ต้องตั้งค่าเป็นค่าระหว่างวันที่ 1 มกราคม 2000 ถึงปัจจุบัน

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

ตัวอย่างต่อไปนี้แสดงวิธีสร้างพื้นที่ทำงานในโหมดการนำเข้า

Apps Script

function createSpaceInImportMode() {
  const space = Chat.Spaces.create({
      spaceType: 'SPACE',
      displayName: 'DISPLAY_NAME',
      importMode: true,
      createTime: (new Date('January 1, 2000')).toJSON()
  });
  console.log(space.name);
}

Python

"""Create a space in import mode."""

import datetime

from google.oauth2 import service_account
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = [
    'https://www.googleapis.com/auth/chat.import',
]

CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
    .with_subject('EMAIL')
)

# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)

result = (
    service.spaces()
    .create(
        body={
            'spaceType': 'SPACE',
            'displayName': 'DISPLAY_NAME',
            'importMode': True,
            'createTime': f'{datetime.datetime(2000, 1, 1).isoformat()}Z',
        }
    )
    .execute()
)

print(result)

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

  • EMAIL: อีเมลของบัญชีผู้ใช้ที่คุณแอบอ้างเป็นบุคคลที่มีสิทธิ์ระดับโดเมน
  • DISPLAY_NAME: ชื่อสำหรับพื้นที่ทำงานที่สร้างในโหมดการนําเข้า ชื่อนี้ต้องเป็นชื่อที่ไม่ซ้ำกันสำหรับพื้นที่ทำงานที่จะแสดงต่อผู้ใช้ Chat เราขอแนะนำให้ใช้ชื่อที่แสดงเดียวกับพื้นที่ทำงานที่คุณนำเข้าข้อมูล

นำเข้าทรัพยากร

หากต้องการนำเข้าทรัพยากรจากแพลตฟอร์มการรับส่งข้อความอื่นๆ คุณจะต้องสร้างทรัพยากร Google Chat (เช่น ข้อความ รีแอ็กชัน ไฟล์แนบ) ในพื้นที่ทำงานโหมดการนำเข้า เมื่อสร้างทรัพยากรในพื้นที่ทำงาน คุณต้องระบุข้อมูลจากทรัพยากรที่เกี่ยวข้องจากแพลตฟอร์มการรับส่งข้อความที่คุณจะย้ายข้อมูล

ข้อความ

แอปใน Chat สามารถนำเข้าข้อความโดยใช้สิทธิ์ของตนเอง หรือในนามของผู้ใช้ผ่านการแอบอ้างเป็นบุคคลอื่น ตั้งค่าผู้เขียนข้อความเป็นบัญชีผู้ใช้ที่แอบอ้างเป็นบุคคลอื่น โปรดดูข้อมูลเพิ่มเติมที่หัวข้อให้สิทธิ์แอป Chat หากต้องการนําเข้าข้อความในพื้นที่ทํางานโหมดการนําเข้า ให้เรียกใช้เมธอด create ในทรัพยากร Message หากต้องการเก็บรักษาเวลาสร้างของข้อความต้นฉบับจากแพลตฟอร์มการรับส่งข้อความต้นทาง คุณสามารถตั้งค่าcreateTimeของข้อความได้ createTime นี้ต้องตั้งค่าเป็นค่าระหว่างเวลาที่สร้างพื้นที่ทำงานที่คุณตั้งไว้ก่อนหน้านี้กับเวลาปัจจุบัน

ข้อความในพื้นที่ทำงานเดียวกันต้องไม่มี createTime เดียวกัน แม้ว่าจะมีการลบข้อความก่อนหน้าที่มีเวลานั้นไปแล้วก็ตาม

ข้อความที่มี URL ของบุคคลที่สามในพื้นที่ทำงานโหมดการนำเข้าจะแสดงตัวอย่างลิงก์ใน Google Chat ไม่ได้

เมื่อคุณสร้างข้อความในโหมดการนำเข้า พื้นที่ทำงานจะไม่แจ้งเตือนหรือส่งอีเมลถึงผู้ใช้รายใด รวมถึงข้อความที่มีการพูดถึงผู้ใช้

ตัวอย่างต่อไปนี้แสดงวิธีสร้างข้อความในพื้นที่ทำงานโหมดการนำเข้า

Python

"""Create a message in import mode space."""

import datetime

from google.oauth2 import service_account
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = [
    'https://www.googleapis.com/auth/chat.import',
]

CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
    .with_subject('EMAIL')
)

# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)

NAME = 'spaces/SPACE_NAME'
result = (
    service.spaces()
    .messages()
    .create(
        parent=NAME,
        body={
            'text': 'Hello, world!',
            'createTime': f'{datetime.datetime(2000, 1, 2).isoformat()}Z',
        },
    )
    .execute()
)

print(result)

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

รีแอ็กชัน

แอป Chat สามารถนําเข้าความรู้สึกที่มีต่อข้อความได้โดยใช้ Chat API ดูข้อมูลเกี่ยวกับวิธีการของทรัพยากรและประเภทการตรวจสอบสิทธิ์ที่รองรับในพื้นที่ทำงานโหมดการนําเข้าได้ที่ให้สิทธิ์แอปใน Chat

ไฟล์แนบ

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

การเป็นสมาชิกที่ผ่านมา

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

ในหลายกรณี เมื่อสมาชิกเดิมเหล่านั้นอยู่ภายใต้นโยบายการเก็บรักษาข้อมูลใน Google คุณอาจต้องเก็บรักษาข้อมูล (เช่น ข้อความและการรีแอ็กชัน) ที่สมาชิกเดิมสร้างขึ้นในพื้นที่ทำงานก่อนนำเข้าข้อมูลดังกล่าวไปยัง Chat ขณะที่พื้นที่ทำงานอยู่ในโหมดการนําเข้า คุณสามารถนําเข้าการเป็นสมาชิกที่ผ่านมาเหล่านั้นมายังพื้นที่ทำงานได้โดยใช้เมธอด create ในแหล่งข้อมูล Membership คุณต้องตั้งค่าdeleteTimeของการเป็นสมาชิกเพื่อเก็บรักษาเวลาออกของการเป็นสมาชิกที่ผ่านมา เวลาสิ้นสุดการเป็นสมาชิกนี้ต้องถูกต้องเนื่องจากจะส่งผลต่อข้อมูลที่ควรเก็บรักษาไว้สำหรับการเป็นสมาชิกเหล่านั้น นอกจากนี้ deleteTime ต้องอยู่หลังการประทับเวลาการสร้างพื้นที่ทำงานและต้องไม่ใช่การประทับเวลาในอนาคต

นอกจาก deleteTime แล้ว คุณยังตั้งค่า createTime เพื่อเก็บรักษาเวลาเข้าร่วมเดิมของการเป็นสมาชิกที่ผ่านมาได้ด้วย คุณจะระบุ createTime หรือไม่ก็ได้ ต่างจาก deleteTime หากไม่ได้ตั้งค่าไว้ ระบบจะคํานวณ createTime โดยอัตโนมัติโดยหัก 1 ไมโครวินาทีจาก deleteTime หากตั้งค่าไว้ createTime ต้องอยู่ก่อน deleteTime และต้องอยู่หลังหรือเท่ากับเวลาสร้างพื้นที่ทำงาน createTime ระบบจะไม่ใช้ข้อมูลนี้เพื่อกำหนดการเก็บรักษาข้อมูลและข้อมูลดังกล่าวจะไม่ปรากฏในเครื่องมือของผู้ดูแลระบบ เช่น คอนโซลผู้ดูแลระบบของ Google และ Google ห้องนิรภัย

แม้ว่าผู้ใช้จะเข้าร่วมและออกจากพื้นที่ในแพลตฟอร์มการรับส่งข้อความต้นทางได้หลายวิธี (ผ่านคำเชิญ เข้าร่วมด้วยตนเอง หรือการได้รับเพิ่มโดยผู้ใช้รายอื่น) แต่การดำเนินการทั้งหมดเหล่านั้นจะแสดงใน Chat โดยแสดงเป็นการเพิ่มหรือนำสมาชิกในอดีตในช่อง createTime และ deleteTime ออก

ตัวอย่างต่อไปนี้แสดงวิธีสร้างการเป็นสมาชิกที่ผ่านมาในพื้นที่ทำงานโหมดการนําเข้า

Python

"""Create a historical membership in import mode space."""

import datetime

from google.oauth2 import service_account
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = [
    'https://www.googleapis.com/auth/chat.import',
]

CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
    .with_subject('EMAIL')
)

# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)

NAME = 'spaces/SPACE_NAME'
USER = 'users/USER_ID'
result = (
    service.spaces()
    .members()
    .create(
        parent=NAME,
        body={
            'createTime': f'{datetime.datetime(2000, 1, 3).isoformat()}Z',
            'deleteTime': f'{datetime.datetime(2000, 1, 4).isoformat()}Z',
            'member': {'name': USER, 'type': 'HUMAN'},
        },
    )
    .execute()
)

print(result)

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

นำเข้าทรัพยากรในพื้นที่ทำงานภายนอก

คุณสร้างพื้นที่ทำงานภายนอกได้โดยใช้โหมดการนําเข้าด้วยข้อมูลเข้าสู่ระบบของผู้ใช้ภายในองค์กร Workspace เท่านั้น ซึ่งจะมีผลขณะที่พื้นที่ทำงานอยู่ในโหมดการนำเข้าเท่านั้น เมื่อพื้นที่ทำงานเข้าสู่โหมดการนําเข้าจนเสร็จสมบูรณ์แล้ว คุณจะเชิญผู้ใช้ภายนอกให้เข้าร่วมพื้นที่ทำงานที่นําเข้าได้ (ดูส่วนการเข้าถึง) และสามารถใช้ข้อมูลเข้าสู่ระบบของผู้ใช้เหล่านั้นเพื่อเรียกใช้ Chat API

ตรวจสอบทรัพยากรที่นําเข้า

แอปใน Chat สามารถอ่านและตรวจสอบเนื้อหาของพื้นที่ทำงานโหมดการนำเข้าได้โดยเรียกใช้เมธอด list ในแหล่งข้อมูล Message คุณสามารถอ่านแหล่งข้อมูล Reaction และ Attachment จากฟิลด์ emojiReactionSummaries และ attachment ของข้อความที่แสดง แอปแชทจะเรียกใช้เมธอดนี้ในนามของผู้ใช้ผ่านการแอบอ้างเป็นบุคคลอื่นได้เท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ให้สิทธิ์แอปใน Chat

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

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

คุณสามารถอ่านพร็อพเพอร์ตี้ของพื้นที่ทำงานโหมดการนําเข้าได้โดยเรียกใช้เมธอด get ในทรัพยากร Space ระบบจะป้อนข้อมูลimportModeExpireTimeลงในคำตอบด้วย เพื่อให้คุณติดตามกรอบเวลาได้อย่างถูกต้องเพื่อดําเนินการนําเข้าให้เสร็จสมบูรณ์ แอปแชทจะเรียกใช้เมธอดนี้ได้โดยใช้สิทธิ์ของตนเองเท่านั้น โปรดดูข้อมูลเพิ่มเติมที่หัวข้อให้สิทธิ์แอป Chat

ปรับยอดความแตกต่างของทรัพยากรที่นําเข้าจากข้อมูลต้นทาง

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

ข้อความ

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

หากต้องการลบข้อความในพื้นที่ทำงานโหมดการนําเข้า ให้เรียกใช้เมธอด delete ในทรัพยากร Message ข้อความในพื้นที่ทำงานโหมดการนำเข้าไม่จำเป็นต้องลบโดยผู้สร้างข้อความเดิม และสามารถลบได้โดยแอบอ้างเป็นผู้ใช้รายใดก็ได้ในโดเมน แอปแชทจะลบได้เฉพาะข้อความของตนเองโดยใช้สิทธิ์ของตนเอง โปรดดูข้อมูลเพิ่มเติมที่หัวข้อให้สิทธิ์แอป Chat

รีแอ็กชัน

หากต้องการลบรีแอ็กชันสำหรับข้อความในพื้นที่ทำงานโหมดการนำเข้า ให้ใช้เมธอด delete ในทรัพยากร reactions ดูข้อมูลเกี่ยวกับวิธีการของทรัพยากรและประเภทการตรวจสอบสิทธิ์ที่รองรับในพื้นที่ทำงานโหมดการนําเข้าได้ที่ให้สิทธิ์แอปใน Chat

ไฟล์แนบ

หากต้องการอัปเดตไฟล์แนบสำหรับข้อความในพื้นที่ทำงานโหมดการนำเข้า ให้ใช้เมธอด upload ในmediaแหล่งข้อมูล ดูข้อมูลเกี่ยวกับวิธีการของทรัพยากรและประเภทการตรวจสอบสิทธิ์ที่รองรับในพื้นที่ทำงานโหมดการนําเข้าได้ที่หัวข้อให้สิทธิ์แอปใน Chat

การเป็นสมาชิกที่ผ่านมา

หากต้องการลบการเป็นสมาชิกที่ผ่านมาในพื้นที่ทำงานโหมดการนําเข้า ให้ใช้เมธอด delete ในแหล่งข้อมูล Membership หลังจากพื้นที่ทำงานออกจากโหมดการนําเข้าแล้ว วิธี delete จะไม่อนุญาตให้คุณลบการเป็นสมาชิกที่ผ่านมาอีกต่อไป

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

พื้นที่ทำงาน

หากต้องการอัปเดตช่องที่รองรับในพื้นที่ทำงานโหมดการนําเข้า ให้ใช้เมธอด patch ในทรัพยากร spaces

หากต้องการลบพื้นที่ทำงานโหมดการนําเข้า ให้ใช้เมธอด delete ในทรัพยากร spaces

ดูข้อมูลเกี่ยวกับวิธีการของทรัพยากรและประเภทการตรวจสอบสิทธิ์ที่รองรับในพื้นที่ทำงานโหมดการนำเข้า และดูให้สิทธิ์แอปใน Chat

โหมดการนําเข้าที่สมบูรณ์

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

จดวันที่และเวลาที่โทรหา completeImport, ชื่อทรัพยากรของผู้ใช้ที่โทร และคำตอบที่ได้รับ ซึ่งจะมีประโยชน์ในกรณีที่คุณพบปัญหาและต้องตรวจสอบ

หากต้องการใช้โหมดการนําเข้าให้เสร็จสมบูรณ์และทําให้ผู้ใช้เข้าถึงพื้นที่ทํางานได้ แอปใน Chat สามารถเรียกใช้เมธอด completeImport ในแหล่งข้อมูล Space แอปแชทจะเรียกใช้เมธอดนี้ในนามของผู้ใช้ผ่านการแอบอ้างเป็นบุคคลอื่นได้เท่านั้น โปรดดูข้อมูลเพิ่มเติมที่หัวข้อให้สิทธิ์แอป Chat ระบบจะเพิ่มผู้ใช้ที่แอบอ้างเป็นบุคคลอื่นไปยังพื้นที่ทำงานในฐานะผู้จัดการพื้นที่ทำงานเมื่อใช้วิธีการนี้เสร็จสมบูรณ์ โดยต้องเรียกใช้เมธอดนี้ภายใน90 วันนับจากที่มีการเรียกใช้เมธอด create.space ครั้งแรก หากคุณพยายามเรียกใช้เมธอดนี้หลังจากผ่านไป 90 วัน การเรียกใช้จะดำเนินการไม่สำเร็จเนื่องจากระบบจะลบพื้นที่ทำงานโหมดการนำเข้าและแอปรับแชทจะเข้าถึงพื้นที่ทำงานดังกล่าวไม่ได้อีกต่อไป

ผู้ใช้ที่แอบอ้างเป็นบุคคลอื่นในเมธอด completeImport ไม่จำเป็นต้องเป็นผู้สร้างพื้นที่ทำงาน

อย่าโทรหา completeImport ใกล้กับวันที่ importModeExpireTime มากเกินไป เนื่องจากเราไม่สามารถรับประกันได้ว่าคำขอจะมาถึงก่อนวันที่ importModeExpireTime และอาจเกิดข้อขัดแย้งกับระบบการประมวลผลข้อมูลที่ทริกเกอร์เมื่อถึงเวลาหมดอายุ เราขอแนะนำให้โทรหา completeImport อย่างน้อย 30 นาทีก่อนเวลา importModeExpireTime

ตัวอย่างต่อไปนี้แสดงวิธีดำเนินการในโหมดการนำเข้าให้เสร็จสมบูรณ์

Python

"""Complete import."""

from google.oauth2 import service_account
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = [
    'https://www.googleapis.com/auth/chat.import',
]

CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
    .with_subject('EMAIL')
)

# Build a service endpoint for Chat API.
service = build('chat', 'v1', credentials=CREDENTIALS)

NAME = 'spaces/SPACE_NAME'
result = service.spaces().completeImport(name=NAME).execute()

print(result)

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

ให้สิทธิ์เข้าถึงพื้นที่ทำงานหลังโหมดการนำเข้า

หากต้องการให้ผู้ใช้ Chat เข้าถึงพื้นที่ทำงานที่นำเข้าล่าสุดได้ แอป Chat จะใช้ขอบเขต chat.import และการแอบอ้างเป็นผู้ใช้ต่อไปได้ภายใน 90 วันนับจากที่มีการเรียกใช้เมธอด create.space() ครั้งแรกเพื่อทำสิ่งต่อไปนี้

  • เพิ่มสมาชิกในพื้นที่ทำงาน: เรียกเมธอด create() ในทรัพยากร Membership เราขอแนะนำให้แอป Chat สร้างทรัพยากร Membership ทันทีหลังจากการนําเข้าพื้นที่ทํางานเสร็จสมบูรณ์ เพื่อให้แอป Chat ใช้ขอบเขต Membership ได้ต่อไป และตรวจสอบว่าสมาชิกที่นําเข้าทั้งหมดมีสิทธิ์เข้าถึงพื้นที่ทํางานchat.import คุณควรให้ความสําคัญกับการเพิ่มสมาชิกที่อาจอยู่ภายใต้นโยบายการคงไว้ชั่วคราวของห้องนิรภัย ซึ่งอนุญาตให้เก็บรักษาข้อความที่นําเข้าแม้ว่าข้อความเหล่านั้นจะไม่ได้อยู่ภายใต้การเก็บรักษาก็ตาม
  • กําหนดกลุ่มเป้าหมาย: เรียกใช้update()ในทรัพยากร Space ดูวิธีสร้างและเพิ่มกลุ่มเป้าหมายได้ที่หัวข้อทําให้ผู้ใช้บางรายในองค์กร Google Workspace ค้นพบพื้นที่ทำงานของ Google Chat ได้

หากต้องการใช้เมธอดเหล่านี้กับขอบเขต chat.import ผู้ใช้ที่แอบอ้างเป็นบุคคลอื่นต้องเป็นผู้จัดการพื้นที่ทำงาน

สำหรับพื้นที่ทำงานภายนอก create() ที่เป็นสมาชิกยังอนุญาตให้เชิญผู้ใช้ภายนอกองค์กร Workspace ของคุณได้ด้วย โปรดตรวจสอบว่าคุณเข้าใจข้อจำกัดที่ทราบทั้งหมดสำหรับผู้ใช้ภายนอก

การแก้ปัญหา

หากพบปัญหาเมื่อนำเข้าพื้นที่ใน Chat โปรดดูปัญหาต่อไปนี้เพื่อรับความช่วยเหลือ หากพบการตอบกลับที่เป็นข้อผิดพลาด โปรดจดบันทึกไว้ (คัดลอก/วางข้อความลงในเอกสารหรือบันทึกภาพหน้าจอ) เพื่อใช้อ้างอิงและการแก้ปัญหาในอนาคต

เมื่อนําเข้าพื้นที่ทํางานสําเร็จ CompleteImportSpace จะเสร็จสมบูรณ์โดยมีสถานะเป็น OK

ไม่ได้นําเข้าให้เสร็จสมบูรณ์ก่อนที่กรอบเวลา 90 วันจะหมดอายุ

ตามที่อธิบายไว้ก่อนหน้านี้ในหัวข้อสร้างพื้นที่ทำงานในโหมดการนําเข้า หากพื้นที่ทำงานยังคงอยู่ในโหมดการนําเข้าหลังจากผ่านไป 90 วันนับจากเวลาที่เรียกใช้เมธอดสร้าง ระบบจะลบพื้นที่ทำงานโดยอัตโนมัติและจะไม่สามารถเข้าถึงได้และจะกู้คืนไม่ได้

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

ค้นหาเว้นวรรคที่หายไป

หากไม่พบพื้นที่ใน Chat ใหม่ ให้ตรวจสอบตารางต่อไปนี้เพื่อดูคำตอบที่คุณได้รับจาก CompleteImportSpace เพื่อดูคำอธิบายและวิธีแก้ปัญหา

ได้รับคำตอบแล้ว ขั้นตอนการตรวจสอบ คำอธิบาย ความละเอียด
CompleteImportSpace ทำให้เกิดข้อยกเว้นและการเรียกใช้ GetSpace จะแสดงผลเป็น PERMISSION_DENIED ตรวจสอบบันทึกว่าพื้นที่ทำงานสร้างขึ้นเมื่อใด หากมีอายุมากกว่า 90 วัน แสดงว่าระบบได้ลบพื้นที่ทำงานนั้นโดยอัตโนมัติแล้ว นอกจากนี้ ไม่มีระเบียนของพื้นที่ทำงานที่นําเข้าในเครื่องมือการจัดการพื้นที่ทํางานหรือบันทึกการตรวจสอบ ดำเนินการนำเข้าไปแล้วนานกว่า 90 วัน แต่พื้นที่ทำงานไม่สามารถออกจากการย้ายข้อมูลได้ สร้างพื้นที่ทำงานใหม่และเรียกใช้กระบวนการนําเข้าอีกครั้ง
การเรียกใช้ CompleteImportSpace จะแสดงผลเป็น OK และการเรียกใช้ GetSpace จะแสดงผลเป็น PERMISSION_DENIED ไม่มีบันทึกของพื้นที่ทำงานที่นำเข้าในเครื่องมือการจัดการพื้นที่ทำงาน แต่ระบบจะแสดงว่าพื้นที่ทำงานถูกลบในบันทึกการตรวจสอบ นำเข้าพื้นที่ทำงานสำเร็จ แต่มีการลบพื้นที่ทำงานดังกล่าวในภายหลัง สร้างพื้นที่ทำงานใหม่และเรียกใช้กระบวนการนําเข้าอีกครั้ง