เมื่อใช้ Google Chat API คุณจะนำเข้าข้อมูลจากแพลตฟอร์มการรับส่งข้อความอื่นๆ ไปยัง Google Chat ได้ คุณสามารถนำเข้าข้อความ ไฟล์แนบ รีแอ็กชัน การเป็นสมาชิก และเอนทิตีพื้นที่ทำงานที่มีอยู่จากแพลตฟอร์มการรับส่งข้อความอื่นๆ ไปยังทรัพยากรของ Chat API ที่เกี่ยวข้องได้ คุณสามารถนำเข้าข้อมูลนี้ได้โดยการสร้างพื้นที่ใน Chat ในโหมดการนำเข้า แล้วนำเข้าข้อมูลไปยังพื้นที่ทำงานเหล่านั้น หลังจากที่ดำเนินการเสร็จสมบูรณ์ พื้นที่ทำงานเหล่านี้จะกลายเป็นพื้นที่มาตรฐานใน Chat
- ตรวจสอบขีดจำกัดการใช้งาน API และวางแผนล่วงหน้า
- กำหนดค่าการให้สิทธิ์สำหรับแอป Chat
- สร้างพื้นที่ทำงานในโหมดการนำเข้า
- นำเข้าทรัพยากร
- ตรวจสอบทรัพยากรที่นำเข้า
- ปรับความแตกต่างของทรัพยากรที่นำเข้ากับข้อมูลต้นทาง
- โหมดการนำเข้าเสร็จสมบูรณ์
- สร้างทรัพยากรการเป็นสมาชิก
สิ่งที่ต้องดำเนินการก่อน
Apps Script
- บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- แอป 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
ตรวจสอบขีดจำกัดการใช้งาน API และวางแผนล่วงหน้า
เวลาที่ใช้ในการนำเข้าข้อมูลไปยัง Chat อาจแตกต่างกันไปอย่างมากโดยขึ้นอยู่กับจำนวนทรัพยากรของ Chat ที่จะนำเข้า วางแผนล่วงหน้าโดยตรวจสอบขีดจำกัดการใช้งานของแอป Chat และปริมาณข้อมูลที่กำหนดเวลาไว้สำหรับการนำเข้าจากแพลตฟอร์มการรับส่งข้อความต้นทางเพื่อระบุลำดับเวลาโดยประมาณ
สร้างพื้นที่ทำงานในโหมดการนำเข้า
หากต้องการสร้างพื้นที่ทำงานในโหมดการนำเข้า ให้เรียกใช้เมธอด create
ในทรัพยากร Space
และตั้งค่า importMode
เป็น true
หากต้องการรักษาเวลาที่สร้างเอนทิตีพื้นที่ทำงานที่เทียบเท่าจากแพลตฟอร์มการรับส่งข้อความต้นทาง คุณจะตั้งค่า createTime
ของพื้นที่ทำงานได้ createTime
นี้ต้องตั้งค่าเป็นค่าระหว่าง 1 มกราคม 2000 ถึงเวลาปัจจุบัน
จด name
ของพื้นที่ทำงานที่คุณสร้างเพื่อให้อ้างอิงได้ในขั้นตอนถัดไปเมื่อนำเข้าเนื้อหาไปยังพื้นที่ทำงาน
นับตั้งแต่ที่มีการเรียกใช้เมธอด create
แอปใน Chat จะมีเวลา
30 วันในการ
นำเข้าทรัพยากร
ไปยังพื้นที่ทำงานเพื่อ
โหมดการนำเข้าให้เสร็จสมบูรณ์
และ
สร้างทรัพยากรการเป็นสมาชิกโดยใช้
chat.import
ขอบเขต แอปใน Chat จะยังสร้างการเป็นสมาชิกได้หลังจาก 30 วันด้วยขอบเขตการเป็นสมาชิกของ Chat API แบบมาตรฐาน
หลังจากผ่านไป 30 วัน หากพื้นที่ทำงานยังคงอยู่ในโหมดการนำเข้า ระบบจะลบพื้นที่ทำงานดังกล่าวโดยอัตโนมัติและจะเข้าถึงไม่ได้และกู้คืนไม่ได้ วางแผนล่วงหน้าโดยตรวจสอบขีดจำกัดการใช้งานของแอป Chat เพื่อให้แน่ใจว่าทรัพยากรที่กำหนดเวลาไว้ทั้งหมดจะสามารถนำเข้าไปยัง Chat ภายในกรอบเวลานี้ได้
ตัวอย่างต่อไปนี้แสดงวิธีสร้างพื้นที่ทำงานในโหมดการนำเข้า
Apps Script
function createSpaceInImportMode() {
const space = Chat.Spaces.create({
spaceType: 'SPACE',
displayName: 'Import Mode Space',
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': 'Import Mode Space',
'importMode': True,
'createTime': f'{datetime.datetime(2000, 1, 1).isoformat()}Z',
}
)
.execute()
)
print(result)
แทนที่ค่าต่อไปนี้
EMAIL
: อีเมลของบัญชีผู้ใช้ที่คุณแอบอ้างว่ามีสิทธิ์ทั่วทั้งโดเมน
นำเข้าทรัพยากร
หากต้องการนำเข้าทรัพยากรจากแพลตฟอร์มการรับส่งข้อความอื่นๆ คุณต้องสร้างทรัพยากร 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
: รหัสที่ไม่ซ้ำกันสำหรับผู้ใช้
ตรวจสอบทรัพยากรที่นําเข้า
แอป 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 ที่ระบุว่าพื้นที่ทำงานเหล่านี้มาจากการนำเข้าข้อมูล
หากต้องการดำเนินการในโหมดการนำเข้าให้เสร็จสมบูรณ์และทำให้ผู้ใช้เข้าถึงพื้นที่ทำงานได้ แอป 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
: ชื่อของพื้นที่ทำงานที่สร้างในโหมดการนำเข้า
สร้างแหล่งข้อมูลการเป็นสมาชิก
หากต้องการเพิ่มการเป็นสมาชิกของผู้ใช้สำหรับพื้นที่ทำงานที่เสร็จสิ้นโหมดการนำเข้าแล้ว ให้เรียกใช้เมธอด create
ในทรัพยากร Membership
แอปแชทจะยังคงใช้ขอบเขต chat.import
และการสวมบทบาทเป็นผู้ใช้เพื่อเรียกใช้เมธอดนี้ภายใน 30 วันนับจากที่เรียกใช้เมธอด create.space
ครั้งแรก ผู้ใช้ที่สวมบทบาทต้องเป็นผู้จัดการพื้นที่ทำงาน
หลังจากพ้นระยะเวลา 30 วันแล้ว แอป Chat ต้องใช้ขอบเขตการเป็นสมาชิกเพิ่มเติมเพื่อเรียกใช้วิธีการนี้
เราขอแนะนำให้แอปใน Chat สร้างทรัพยากรการเป็นสมาชิกทันทีหลังจากการนำเข้าเสร็จสมบูรณ์ เพื่อให้แอป Chat สามารถใช้ขอบเขต chat.import
ต่อไปในการสร้างการเป็นสมาชิก และให้สิทธิ์สมาชิกทุกคนในการเข้าถึงพื้นที่ทำงานที่นำเข้า