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

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

กระบวนการนำเข้าที่สมบูรณ์มีดังนี้

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

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

Apps Script

  • Google Workspace บัญชีที่มีสิทธิ์เข้าถึง Google Chat
  • แอป Chat ที่เผยแพร่แล้ว วิธีสร้าง แอปแชท โปรดทำตามนี้ Quickstart

Python

  • Python 3.6 ขึ้นไป
  • PIP เครื่องมือจัดการแพ็กเกจ
  • ไลบรารีของไคลเอ็นต์ Google ล่าสุดสำหรับ Python หากต้องการติดตั้งหรืออัปเดต ให้เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

    pip3 install --upgrade google-api-python-client google-auth
    
  • แอป Chat ที่เผยแพร่แล้ว หากต้องการสร้างและเผยแพร่ แอปใน Chat สร้างแอป Google Chat

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ข้อความ

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

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

รีแอ็กชัน

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

ไฟล์แนบ

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

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

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

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

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

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

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

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

โหมดการนำเข้าเสร็จสมบูรณ์

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

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

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

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

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

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 และผู้ใช้ต่อไปได้ การแอบอ้างเป็นบุคคลอื่นภายใน 30 วันนับจากการเรียกเมธอด create.space() ครั้งแรก ดังต่อไปนี้

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

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

การแก้ปัญหา

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

เมื่อนำเข้าพื้นที่ทำงานเรียบร้อยแล้ว CompleteImportSpace จะทำงานด้วย สถานะ OK

ไม่ได้นำเข้าให้เสร็จสมบูรณ์ก่อนกรอบเวลา 30 วันจะสิ้นสุดลง

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

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

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

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

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