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

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

ต่อไปนี้เป็นกระบวนการนำเข้าทั้งหมด

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

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

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

วางแผนตามจำนวนข้อมูลที่จะนำเข้า ทำความเข้าใจว่าโควต้าและขีดจำกัดการใช้งานส่งผลต่อกระบวนการนำเข้าอย่างไร และทราบประเภทพื้นที่ใน 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 หลังจากนำเข้าเสร็จสมบูรณ์แล้ว คุณจะเพิ่มผู้ใช้ภายนอกได้

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

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);
}

"""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

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

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

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

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

• EMAIL: อีเมลของบัญชีผู้ใช้ที่คุณ แอบอ้างโดยมีสิทธิ์ระดับโดเมน
• SPACE_NAME: ชื่อของพื้นที่ทำงานที่สร้างในโหมดการนำเข้า

รีแอ็กชัน

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

ไฟล์แนบ

แอป Chat สามารถ อัปโหลดไฟล์แนบ โดยใช้ Chat API ดูข้อมูลเกี่ยวกับวิธีการของทรัพยากรและ ประเภทการรองรับการตรวจสอบสิทธิ์ในพื้นที่โหมดการนำเข้าได้ที่หัวข้อ ให้สิทธิ์แอปใน Chat อย่างไรก็ตาม เราขอแนะนำให้คุณใช้ Google ไดรฟ์ 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 ว่ามีการเพิ่มหรือนำออก

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

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

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

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

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

คุณจะสร้างพื้นที่ทำงานภายนอกได้ในโหมดนำเข้าโดยใช้ข้อมูลเข้าสู่ระบบ ของผู้ใช้ภายในองค์กร 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 วันผ่านไป การเรียกใช้จะล้มเหลวเนื่องจากระบบจะลบพื้นที่โหมดการนำเข้าและแอป Chat จะเข้าถึงไม่ได้อีกต่อไป

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

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

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

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

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

• EMAIL: อีเมลของบัญชีผู้ใช้ที่คุณ แอบอ้างโดยมีสิทธิ์ระดับโดเมน
• SPACE_NAME: ชื่อของพื้นที่ทำงานที่สร้างในโหมดการนำเข้า

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

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

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

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

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

การแก้ปัญหา

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

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

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

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

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

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

ค้นหาพื้นที่ทำงานที่หายไป

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