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

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

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

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

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

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

Apps Script

• บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
• สร้างโปรเจ็กต์ Google Cloud
• เปิดใช้และกําหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
• สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการแชทขั้นสูง
• แอป Chat ต้องมีการมอบสิทธิ์ทั่วทั้งโดเมนในโดเมนที่แอปนำเข้าเนื้อหา โปรดดูให้สิทธิ์แอป Chat

Python

• บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
• สร้างโปรเจ็กต์ Google Cloud
• เปิดใช้และกําหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
• Python 3.6 ขึ้นไป
• เครื่องมือจัดการแพ็กเกจ pip
• แอป Chat ต้องได้รับการมอบสิทธิ์ทั่วทั้งโดเมนในโดเมนที่แอปนำเข้าเนื้อหา โปรดดูหัวข้อให้สิทธิ์แอปใน Chat

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

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

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

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

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

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

โหมดการนําเข้ารองรับเฉพาะ SpaceType ของ SPACE และ 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)

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

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

รีแอ็กชัน

แอป 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)

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

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

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

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

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

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

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

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

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

การแก้ปัญหา

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

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

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

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

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

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

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

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