เมื่อใช้ Google Chat API คุณจะนำเข้าข้อมูลจากแพลตฟอร์มการรับส่งข้อความอื่นๆ ได้ ไปยัง Google Chat คุณสามารถนำเข้าข้อความ ไฟล์แนบ รีแอ็กชัน การเป็นสมาชิก และเอนทิตีพื้นที่ทำงานจากแพลตฟอร์มการรับส่งข้อความอื่นๆ ไปยัง ตรงกัน แหล่งข้อมูลเกี่ยวกับ Chat API คุณสามารถนำเข้าข้อมูลนี้ได้โดยการสร้างพื้นที่ใน Chat ใน โหมดการนำเข้า และนำเข้าข้อมูลไปยังพื้นที่ทำงานเหล่านั้น หลังจากกระบวนการเสร็จสมบูรณ์แล้ว พื้นที่ทำงานดังกล่าวจะกลายเป็นพื้นที่มาตรฐานใน Chat
กระบวนการนำเข้าที่สมบูรณ์มีดังนี้
- วางแผนการนำเข้า
- กำหนดค่าการให้สิทธิ์สำหรับแอป Chat
- สร้างพื้นที่ทำงานในโหมดการนำเข้า
- นำเข้าทรัพยากร
- ตรวจสอบทรัพยากรที่นําเข้า
- ปรับความแตกต่างของทรัพยากรที่นำเข้ากับข้อมูลต้นทาง
- โหมดการนำเข้าเสร็จสมบูรณ์
- ให้สิทธิ์เข้าถึงพื้นที่ทำงานหลังโหมดการนำเข้า
- การแก้ปัญหา
ข้อกำหนดเบื้องต้น
Apps Script
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- สร้างโปรเจ็กต์ Google Cloud
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat ของคุณ
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน แล้วเปิดบริการ Chat ขั้นสูง
- แอป Chat ต้องได้รับมอบสิทธิ์ทั่วทั้งโดเมน สิทธิ์ในโดเมนทั้งหมดที่แอปนำเข้าเนื้อหา โปรดดู ให้สิทธิ์แอปใน Chat
Python
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- สร้างโปรเจ็กต์ Google Cloud
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat ของคุณ
- Python 3.6 ขึ้นไป
- เครื่องมือจัดการแพ็กเกจ pip
- แอป 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)
แทนที่ค่าต่อไปนี้
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
: รหัสที่ไม่ซ้ำกันสำหรับ user
นำเข้าทรัพยากรในพื้นที่ทำงานภายนอก
คุณสร้างพื้นที่ทำงานภายนอกได้ด้วยโหมดการนำเข้าเท่านั้นโดยใช้ข้อมูลเข้าสู่ระบบ ที่เป็นของผู้ใช้ภายในองค์กร 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)
แทนที่ค่าต่อไปนี้
EMAIL
: อีเมลของบัญชีผู้ใช้ที่คุณ แอบอ้างเป็นหน่วยงานที่มีอำนาจทั่วทั้งโดเมนSPACE_NAME
: ชื่อสำหรับพื้นที่ทำงานที่สร้างในโหมดการนำเข้า
ให้สิทธิ์เข้าถึงพื้นที่ทำงานหลังโหมดการนำเข้า
วิธีให้สิทธิ์ผู้ใช้ Chat เข้าถึงพื้นที่ทำงานที่นำเข้าล่าสุด
แอป Chat จะใช้ขอบเขต chat.import
และผู้ใช้ต่อไปได้
การแอบอ้างเป็นบุคคลอื่นภายใน 30 วันนับจากการเรียกเมธอด create.space()
ครั้งแรก
ดังต่อไปนี้
- เพิ่มสมาชิกไปยังพื้นที่ทำงาน: เรียกใช้เมธอด
create()
ในทรัพยากรMembership
เราขอแนะนำให้แอปใน Chat สร้างทรัพยากรMembership
รายการทันทีหลังจากการนำเข้าพื้นที่ทำงาน เพื่อให้แอปใน Chat สามารถใช้chat.import
ขอบเขต และตรวจสอบว่าสมาชิกที่นำเข้าทั้งหมดมีสิทธิ์เข้าถึง พื้นที่ทำงาน - กำหนดกลุ่มเป้าหมาย: เรียกใช้
เมธอด
update()
ในทรัพยากรSpace
หากต้องการดูวิธีสร้างและเพิ่มกลุ่มเป้าหมาย โปรดดู ทำให้ผู้ใช้ที่เฉพาะเจาะจงค้นพบพื้นที่ใน Google Chat ได้ใน องค์กรที่ใช้ Google Workspace
หากต้องการใช้วิธีการเหล่านี้กับขอบเขต chat.import
ผู้ใช้ที่ถูกแอบอ้างจะต้อง
ให้เป็นผู้จัดการพื้นที่ทำงาน
สำหรับพื้นที่ทำงานภายนอก การเป็นสมาชิก
create()
วิธี
ที่อนุญาตให้เชิญผู้ใช้ภายนอกองค์กร Workspace ได้ ตรวจสอบว่า
คุณเข้าใจ
ข้อจำกัดที่ทราบสำหรับ
ผู้ใช้ภายนอก
การแก้ปัญหา
หากพบปัญหาในการนำเข้าพื้นที่ใน Chat โปรดตรวจสอบ ปัญหาต่อไปนี้เพื่อขอความช่วยเหลือ หากคุณพบการตอบกลับที่ผิดพลาด โปรดทำดังนี้ บันทึกเก็บไว้ (คัดลอก/วางข้อความลงในเอกสารหรือบันทึกภาพหน้าจอ) เพื่อ ข้อมูลอ้างอิงและการแก้ปัญหาในอนาคต
เมื่อนำเข้าพื้นที่ทำงานเรียบร้อยแล้ว CompleteImportSpace
จะทำงานด้วย
สถานะ OK
ไม่ได้นำเข้าให้เสร็จสมบูรณ์ก่อนกรอบเวลา 30 วันจะสิ้นสุดลง
ตามที่อธิบายไว้ในหัวข้อสร้างพื้นที่ทำงานในโหมดการนําเข้า หาก พื้นที่ทำงานยังคงอยู่ในโหมดการนำเข้าหลังจากผ่านไป 30 วันนับจากเวลาที่สร้าง ถูกเรียก ส่วนขยายจะถูกลบโดยอัตโนมัติและไม่สามารถเข้าถึงได้ ที่กู้คืนไม่ได้
ขออภัย พื้นที่ทำงานที่ถูกลบไม่สามารถใช้ได้หรือกู้คืนไม่ได้อีกต่อไป และ กระบวนการนำเข้าจะต้องเริ่มต้นใหม่อีกครั้ง
ค้นหาพื้นที่ทำงานที่หายไป
หากไม่พบพื้นที่ใน Chat ใหม่ โปรดตรวจสอบ
ตารางต่อไปนี้สำหรับการตอบกลับที่คุณได้รับจาก CompleteImportSpace
ถึง
ดูคำอธิบายและวิธีแก้ไข
ได้รับคำตอบแล้ว | ขั้นตอนการตรวจสอบ | คำอธิบาย | ความละเอียด |
---|---|---|---|
CompleteImportSpace ส่งข้อยกเว้นและการโทร
GetSpace แสดงผล PERMISSION_DENIED |
ตรวจสอบระเบียนว่าสร้างพื้นที่ทำงานเมื่อใดและเก่ากว่านั้นหรือไม่ เกิน 30 วัน ข้อมูลก็ถูกลบโดยอัตโนมัติ นอกจากนี้จะไม่มี ระเบียนของพื้นที่ที่นำเข้าใน เครื่องมือการจัดการพื้นที่ทำงาน หรือบันทึกการตรวจสอบ | การนำเข้ากระบวนการนำเข้าใช้เวลานานกว่า 30 วันแล้ว และพื้นที่ทำงานออกจากการย้ายข้อมูลไม่สำเร็จ | โปรดสร้างพื้นที่ทำงานใหม่และเรียกใช้กระบวนการนำเข้าอีกครั้ง |
CompleteImportSpace ส่งคืน OK และกำลังโทร
GetSpace แสดงผล PERMISSION_DENIED |
ไม่มีบันทึกของพื้นที่ทำงานที่นำเข้าใน เครื่องมือการจัดการพื้นที่ทำงาน แต่พื้นที่ทำงานถูกลบใน บันทึกการตรวจสอบ | นำเข้าพื้นที่ทำงานเรียบร้อยแล้ว แต่ต่อมาลบออก | โปรดสร้างพื้นที่ทำงานใหม่และเรียกใช้กระบวนการนำเข้าอีกครั้ง |