Với Google Chat API, bạn có thể nhập dữ liệu từ các nền tảng nhắn tin khác vào Google Chat. Bạn có thể nhập các tin nhắn, tệp đính kèm, lượt thể hiện cảm xúc, tư cách thành viên và thực thể không gian hiện có từ các nền tảng nhắn tin khác vào tài nguyên Chat API tương ứng. Bạn có thể nhập dữ liệu này bằng cách tạo không gian Chat ở chế độ nhập và nhập dữ liệu vào các không gian đó. Sau khi quy trình này hoàn tất, các không gian này sẽ trở thành không gian Chat tiêu chuẩn.
Sau đây là quy trình nhập hoàn chỉnh:
- Lập kế hoạch nhập
- Định cấu hình chế độ uỷ quyền cho ứng dụng Chat
- Tạo không gian ở chế độ nhập
- Nhập tài nguyên
- Xác thực tài nguyên đã nhập
- Đối chiếu các điểm khác biệt về tài nguyên đã nhập từ dữ liệu nguồn
- Chế độ nhập hoàn chỉnh
- Cấp quyền truy cập vào không gian sau khi nhập ở chế độ
- Khắc phục sự cố
Điều kiện tiên quyết
Apps Script
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Tạo một dự án trên Google Cloud.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Tạo một dự án Apps Script độc lập và bật Dịch vụ Chat nâng cao.
- Ứng dụng Chat phải được uỷ quyền trên toàn miền trong mọi miền mà ứng dụng nhập nội dung, hãy xem phần Uỷ quyền cho ứng dụng Chat.
Python
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Tạo một dự án trên Google Cloud.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Python 3.6 trở lên
- Công cụ quản lý gói pip
- Ứng dụng Chat phải được uỷ quyền trên toàn miền trong mọi miền mà ứng dụng nhập nội dung, hãy xem phần Uỷ quyền cho ứng dụng Chat.
Lên kế hoạch nhập
Lập kế hoạch cho lượng dữ liệu cần nhập, tìm hiểu cách hạn mức sử dụng và hạn ngạch có thể ảnh hưởng đến quy trình nhập, đồng thời lưu ý các loại không gian Chat được hỗ trợ khi nhập vào một không gian mới. Nếu bạn là quản trị viên, hãy đọc bài viết Nhập dữ liệu tin nhắn vào Google Chat từ một dịch vụ khác và làm theo các bước một cách cẩn thận.
Xem hạn mức sử dụng API
Thời gian cần thiết để nhập dữ liệu vào Chat có thể khác nhau đáng kể tuỳ thuộc vào số lượng tài nguyên Chat cần nhập. Xem xét hạn mức sử dụng của ứng dụng Chat và lượng dữ liệu dự kiến nhập từ nền tảng nhắn tin nguồn để xác định mốc thời gian ước tính.
Khi nhập tin nhắn vào một không gian, bạn nên phân tán các lệnh gọi đến phương thức messages.create()
trên nhiều luồng tin nhắn.
Xác định những không gian được hỗ trợ để nhập
Chế độ nhập chỉ hỗ trợ SpaceType
của SPACE
và GROUP_CHAT
. Thiết bị này không hỗ trợ DIRECT_MESSAGE
.
Hãy xem tài liệu dành cho SpaceType
để biết thêm thông tin.
Tạo không gian ở chế độ nhập
Để tạo một không gian ở chế độ nhập, hãy gọi phương thức create
trên tài nguyên Space
rồi đặt importMode
thành true
.
Khi bạn tạo không gian ở chế độ nhập, hãy lưu ý những điều sau.
- Ngày và giờ – Xin lưu ý rằng bạn phải hoàn tất chế độ nhập trong vòng 90 ngày. Nếu không gian vẫn ở chế độ nhập sau 90 ngày kể từ thời điểm phương thức
spaces.create()
được gọi, thì không gian đó sẽ tự động bị xoá và không thể truy cập cũng như khôi phục.- Sử dụng giá trị của trường
importModeExpireTime
để theo dõi thời gian hết hạn của khung thời gian 90 ngày. - Không sử dụng giá trị của trường
createTime
để theo dõi thời gian hết hạn của khung thời gian 90 ngày. Điều này không phải lúc nào cũng giống như khi bạn gọi phương thứcspaces.create()
. Khi sử dụng chế độ nhập, bạn có thể đặt trườngcreateTime
thành dấu thời gian trong quá khứ mà tại đó không gian được tạo trong nguồn để giữ nguyên thời gian tạo ban đầu.
- Sử dụng giá trị của trường
- Tên tài nguyên của không gian (
name
) – Giá trị nhận dạng riêng biệt dùng để truy xuất thông tin về không gian cụ thể và được tham chiếu trong các bước sau khi nhập nội dung vào không gian.
Để giữ nguyên thời gian tạo của thực thể không gian tương đương từ nền tảng nhắn tin nguồn, bạn có thể đặt createTime
của không gian. createTime
này phải được đặt thành một giá trị trong khoảng thời gian từ ngày 1 tháng 1 năm 2000 đến thời điểm hiện tại.
Để tạo một không gian bên ngoài ở chế độ nhập, hãy đặt externalUserAllowed
thành true
.
Sau khi nhập thành công, bạn có thể thêm người dùng bên ngoài.
Ví dụ sau đây cho thấy cách tạo một không gian ở chế độ nhập:
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)
Thay thế nội dung sau:
EMAIL
: địa chỉ email của tài khoản người dùng mà bạn đang mạo danh bằng quyền trên toàn miền.DISPLAY_NAME
: tên của không gian được tạo ở chế độ nhập. Đây phải là một tên riêng biệt cho không gian mà người dùng Chat nhìn thấy. Bạn nên sử dụng cùng tên hiển thị với tên của không gian mà bạn đang nhập dữ liệu.
Nhập tài nguyên
Để nhập tài nguyên từ các nền tảng nhắn tin khác, bạn tạo tài nguyên Google Chat (chẳng hạn như tin nhắn, lượt thể hiện cảm xúc, tệp đính kèm) trong không gian ở chế độ nhập. Khi tạo một tài nguyên trong không gian, bạn chỉ định dữ liệu từ tài nguyên có liên quan trên nền tảng nhắn tin mà bạn đang di chuyển.
Tin nhắn
Các ứng dụng Chat có thể nhập tin nhắn bằng quyền riêng của mình hoặc thay mặt cho người dùng thông qua tính năng mạo danh. Tác giả của thư được đặt thành tài khoản người dùng được mạo danh. Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho các ứng dụng trong Chat.
Để nhập một thông báo vào không gian ở chế độ nhập, hãy gọi phương thức create
trên tài nguyên Message
.
Để giữ nguyên thời gian tạo của thư gốc trên nền tảng nhắn tin nguồn, bạn có thể đặt createTime
của thư. Bạn phải đặt createTime
này thành một giá trị nằm trong khoảng thời gian tạo không gian mà bạn đã đặt trước đó và thời gian hiện tại.
Các tin nhắn trong cùng một không gian không thể chứa cùng một createTime
, ngay cả khi các tin nhắn trước đó có thời gian đó đã bị xoá.
Những tin nhắn chứa URL của bên thứ ba trong các không gian ở chế độ nhập không thể hiển thị bản xem trước đường liên kết trong Google Chat.
Khi bạn tạo tin nhắn ở chế độ nhập, các không gian sẽ không thông báo hoặc gửi email cho bất kỳ người dùng nào, kể cả những tin nhắn có chứa lượt đề cập đến người dùng.
Ví dụ sau đây cho thấy cách tạo một thông báo trong không gian ở chế độ nhập:
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)
Thay thế nội dung sau:
EMAIL
: địa chỉ email của tài khoản người dùng mà bạn đang mạo danh bằng quyền trên toàn miền.SPACE_NAME
: tên của khoảng trống được tạo ở chế độ nhập.
Lượt thể hiện cảm xúc
Ứng dụng Chat của bạn có thể nhập phản ứng đối với tin nhắn bằng cách sử dụng API Chat. Để biết thông tin về các phương thức tài nguyên và các loại xác thực được hỗ trợ trong không gian ở chế độ nhập, hãy xem bài viết Uỷ quyền cho ứng dụng Chat.
Phần đính kèm:
Ứng dụng Chat của bạn có thể tải tệp đính kèm lên bằng API Chat. Để biết thông tin về các phương thức tài nguyên và các loại xác thực được hỗ trợ trong không gian ở chế độ nhập, hãy xem bài viết Uỷ quyền cho ứng dụng Chat. Tuy nhiên, bạn nên sử dụng Google Drive API để tải tệp đính kèm lên dưới dạng tệp trên Google Drive và liên kết URI tệp với các thông báo tương ứng trong không gian ở chế độ nhập để nhập tệp đính kèm từ các nền tảng nhắn tin khác nhằm tránh vượt quá giới hạn nội bộ của Google Chat đối với việc tải tệp đính kèm lên.
Tư cách thành viên trước đây
Thành viên cũ là những thành viên được tạo cho người dùng đã rời khỏi thực thể không gian ban đầu trên nền tảng nhắn tin nguồn, nhưng bạn muốn giữ lại dữ liệu của họ trong Chat. Để biết thông tin về cách thêm thành viên mới sau khi không gian không còn ở chế độ nhập, hãy xem phần Tạo tài nguyên thành viên.
Trong nhiều trường hợp, khi những thành viên cũ đó phải tuân thủ chính sách giữ lại dữ liệu của Google, bạn nên giữ lại dữ liệu (chẳng hạn như tin nhắn và lượt thể hiện cảm xúc) do các thành viên cũ tạo trong một không gian trước khi nhập dữ liệu đó vào Chat.
Khi không gian ở chế độ nhập, bạn có thể nhập những thành viên cũ đó vào không gian bằng cách sử dụng phương thức create
trên tài nguyên Membership
.
Để giữ lại thời gian rời khỏi gói thành viên cũ, bạn phải đặt deleteTime
cho gói thành viên đó. Thời gian rời đi này phải chính xác vì nó ảnh hưởng đến dữ liệu cần giữ lại cho những thành viên đó. Ngoài ra, deleteTime
này phải sau dấu thời gian tạo không gian và không được là dấu thời gian trong tương lai.
Ngoài deleteTime
, bạn cũng có thể đặt createTime
để giữ nguyên thời gian tham gia ban đầu của gói hội viên cũ. Không giống như deleteTime
, createTime
là không bắt buộc. Nếu bạn không đặt, createTime
sẽ được tự động tính bằng cách trừ 1 micro giây từ deleteTime
. Nếu được đặt, createTime
phải đứng trước deleteTime
và phải diễn ra vào hoặc sau thời gian tạo không gian. createTime
Thông tin này không được dùng để xác định thời gian lưu giữ dữ liệu và không xuất hiện trong các công cụ dành cho quản trị viên như Bảng điều khiển dành cho quản trị viên của Google và Google Vault.
Mặc dù người dùng có thể tham gia và rời khỏi một không gian theo nhiều cách trong nền tảng nhắn tin nguồn (thông qua lời mời, tự tham gia, được người dùng khác thêm), nhưng trong Chat, tất cả những hành động đó đều được thể hiện bằng các trường tư cách thành viên trong quá khứ createTime
và deleteTime
là được thêm hoặc bị xoá.
Ví dụ sau đây cho thấy cách tạo một thành viên cũ trong không gian ở chế độ nhập:
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)
Thay thế nội dung sau:
EMAIL
: địa chỉ email của tài khoản người dùng mà bạn đang mạo danh bằng quyền trên toàn miền.SPACE_NAME
: tên của khoảng trống được tạo ở chế độ nhập.USER_ID
: mã nhận dạng duy nhất cho người dùng.
Nhập tài nguyên trong một không gian bên ngoài
Bạn chỉ có thể tạo không gian bên ngoài ở chế độ nhập bằng thông tin đăng nhập thuộc về người dùng trong tổ chức Workspace của bạn. Điều này chỉ áp dụng khi không gian ở chế độ nhập. Sau khi không gian hoàn tất chế độ nhập, người dùng bên ngoài có thể được mời tham gia các không gian đã nhập (xem phần quyền truy cập) và thông tin đăng nhập của họ có thể được dùng để gọi Chat API.
Xác thực tài nguyên đã nhập
Ứng dụng Chat có thể đọc lại và xác thực nội dung của một không gian ở chế độ nhập bằng cách gọi phương thức list
trên tài nguyên Message
.
Bạn có thể đọc các tài nguyên Reaction
và Attachment
từ các trường emojiReactionSummaries
và attachment
của mọi thông báo được trả về. Các ứng dụng trò chuyện chỉ có thể gọi phương thức này thay mặt cho người dùng thông qua tính năng mạo danh. Để biết thêm thông tin, hãy xem phần Uỷ quyền cho các ứng dụng Chat.
Ứng dụng trò chuyện của bạn cũng có thể đọc từng tin nhắn để xác thực bằng cách gọi phương thức get
trên tài nguyên Message
.
Các ứng dụng trò chuyện chỉ có thể gọi phương thức này để đọc tin nhắn của chính mình bằng cách sử dụng quyền của chính mình. Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho các ứng dụng trong Chat.
Các ứng dụng trò chuyện cũng có thể liệt kê các thành viên trước đây bằng cách gọi phương thức list
trên tài nguyên Membership
.
Sau khi không gian thoát khỏi chế độ nhập, phương thức list
sẽ không hiển thị tư cách thành viên trước đây nữa. Các ứng dụng trò chuyện chỉ có thể gọi phương thức này thay cho người dùng thông qua tính năng mạo danh. Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho các ứng dụng trong Chat.
Bạn có thể đọc các thuộc tính của không gian chế độ nhập bằng cách gọi phương thức get
trên tài nguyên Space
. Phản hồi cũng sẽ có importModeExpireTime
được điền sẵn, vì vậy, bạn có thể theo dõi đúng khung thời gian để hoàn tất quy trình nhập.
Các ứng dụng trò chuyện chỉ có thể gọi phương thức này bằng quyền của riêng mình.
Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho các ứng dụng trong Chat.
Đối chiếu sự khác biệt về tài nguyên đã nhập với dữ liệu nguồn
Nếu có tài nguyên đã nhập không còn khớp với thực thể ban đầu từ nền tảng nhắn tin nguồn do các thay đổi trong thực thể ban đầu trong quá trình nhập, thì Các ứng dụng trò chuyện có thể gọi Chat API để sửa đổi tài nguyên trò chuyện đã nhập. Ví dụ: nếu người dùng chỉnh sửa một tin nhắn trong nền tảng nhắn tin nguồn sau khi tin nhắn đó được tạo trong Chat, thì các ứng dụng Chat có thể cập nhật tin nhắn đã nhập để phản ánh nội dung hiện tại của tin nhắn gốc.
Tin nhắn
Để cập nhật các trường được hỗ trợ trên một tin nhắn trong không gian ở chế độ nhập, hãy gọi phương thức update
trên tài nguyên Message
.
Các ứng dụng trò chuyện chỉ có thể gọi phương thức này bằng cùng một quyền mà ứng dụng đã dùng trong quá trình tạo tin nhắn ban đầu. Nếu bạn sử dụng tính năng mạo danh người dùng trong quá trình tạo thông báo ban đầu, thì bạn phải sử dụng cùng một người dùng bị mạo danh để cập nhật thông báo đó.
Để xoá một tin nhắn trong không gian ở chế độ nhập, hãy gọi phương thức delete
trên tài nguyên Message
.
Người tạo tin nhắn ban đầu không cần xoá tin nhắn trong không gian ở chế độ nhập và có thể xoá bằng cách mạo danh bất kỳ người dùng nào trong miền.
Ứng dụng nhắn tin chỉ có thể xoá tin nhắn của chính mình bằng quyền của riêng mình. Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho các ứng dụng trong Chat.
Lượt thể hiện cảm xúc
Để xoá một lượt thể hiện cảm xúc cho một tin nhắn trong không gian ở chế độ nhập, hãy sử dụng phương thức delete
trên tài nguyên reactions
. Để biết thông tin về các phương thức tài nguyên và các loại xác thực được hỗ trợ trong không gian ở chế độ nhập, hãy xem bài viết Uỷ quyền cho ứng dụng Chat.
Phần đính kèm:
Để cập nhật tệp đính kèm cho một tin nhắn trong không gian ở chế độ nhập, hãy sử dụng phương thức upload
trên tài nguyên media
. Để biết thông tin về các phương thức tài nguyên và các loại xác thực được hỗ trợ trong không gian ở chế độ nhập, hãy xem phần Uỷ quyền cho ứng dụng Chat.
Tư cách thành viên trước đây
Để xoá một thành viên cũ trong không gian ở chế độ nhập, hãy sử dụng phương thức delete
trên tài nguyên Membership
. Sau khi một không gian thoát khỏi chế độ nhập, phương thức delete
sẽ không cho phép bạn xoá tư cách thành viên trong quá khứ nữa.
Bạn không thể cập nhật thông tin thành viên cũ trong không gian ở chế độ nhập. Nếu muốn sửa một thông tin thành viên cũ được nhập không chính xác, trước tiên, bạn cần xoá thông tin đó rồi tạo lại khi không gian vẫn ở chế độ nhập.
Không gian
Để cập nhật các trường được hỗ trợ trong một không gian ở chế độ nhập, hãy sử dụng phương thức patch
trên tài nguyên spaces
.
Để xoá một không gian ở chế độ nhập, hãy dùng phương thức delete
trên tài nguyên spaces
.
Để biết thông tin về các phương thức tài nguyên và các loại xác thực được hỗ trợ trong không gian ở chế độ nhập, hãy xem phần Uỷ quyền cho ứng dụng Chat.
Chế độ nhập hoàn chỉnh
Trước khi gọi phương thức completeImport
, bạn phải đảm bảo rằng quá trình xác thực và điều chỉnh sự khác biệt về tài nguyên đã hoàn tất. Việc thoát khỏi không gian ở chế độ nhập là một quy trình không thể đảo ngược và sẽ chuyển không gian ở chế độ nhập thành không gian thông thường. Không có chỉ báo nào trong Chat cho biết những không gian này là do nhập dữ liệu.
Ghi lại ngày và giờ bạn gọi completeImport
, tên tài nguyên của người dùng đã thực hiện cuộc gọi và phản hồi được trả về. Điều này có thể hữu ích nếu bạn gặp phải bất kỳ vấn đề nào và phải điều tra các vấn đề đó.
Để hoàn tất chế độ nhập và giúp người dùng truy cập vào không gian, ứng dụng Chat có thể gọi phương thức completeImport
trên tài nguyên Space
.
Các ứng dụng trò chuyện chỉ có thể gọi phương thức này thay mặt cho người dùng thông qua tính năng mạo danh. Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho các ứng dụng trong Chat.
Người dùng được mạo danh sẽ được thêm vào không gian dưới vai trò người quản lý không gian sau khi phương thức này hoàn tất. Bạn phải gọi phương thức này trong vòng 90 ngày kể từ lần gọi phương thức create.space
ban đầu. Nếu bạn cố gắng gọi phương thức này sau khi khoảng thời gian 90 ngày trôi qua, lệnh gọi sẽ dẫn đến lỗi vì không gian chế độ nhập đã bị xoá và không còn truy cập được vào ứng dụng Chat nữa.
Người dùng được mạo danh trong phương thức completeImport
không cần phải là người tạo không gian.
Đừng gọi completeImport
quá gần importModeExpireTime
, vì chúng tôi không thể đảm bảo rằng yêu cầu sẽ đến trước importModeExpireTime
và có thể xảy ra xung đột với quá trình xử lý dữ liệu trong các hệ thống được kích hoạt tại thời điểm hết hạn.
Bạn nên gọi đến số completeImport
ít nhất 30 phút trước importModeExpireTime
.
Ví dụ sau đây cho thấy cách hoàn tất chế độ nhập:
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)
Thay thế nội dung sau:
EMAIL
: địa chỉ email của tài khoản người dùng mà bạn đang mạo danh bằng quyền trên toàn miền.SPACE_NAME
: tên của khoảng trống được tạo ở chế độ nhập.
Cấp quyền truy cập vào không gian sau khi nhập ở chế độ
Để cấp cho người dùng Chat quyền truy cập vào không gian vừa nhập, các ứng dụng Chat có thể tiếp tục sử dụng phạm vi chat.import
và tính năng mạo danh người dùng trong vòng 90 ngày kể từ lệnh gọi phương thức create.space()
ban đầu để thực hiện những việc sau:
- Thêm thành viên vào không gian: Gọi phương thức
create()
trên tài nguyênMembership
. Bạn nên tạo các tài nguyênMembership
ngay sau khi quá trình nhập không gian hoàn tất để các ứng dụng Chat có thể tiếp tục sử dụng phạm vichat.import
và đảm bảo rằng tất cả thành viên được nhập đều có quyền truy cập vào không gian. Bạn nên ưu tiên thêm những thành viên có thể phải tuân theo chính sách giữ lại dữ liệu trên Vault. Chính sách này cho phép lưu giữ các thư đã nhập ngay cả khi chúng nằm ngoài thời gian lưu giữ. - Đặt đối tượng mục tiêu: Gọi phương thức
update()
trên tài nguyênSpace
. Để tìm hiểu cách tạo và thêm đối tượng mục tiêu, hãy xem bài viết Cho phép một số người dùng cụ thể trong tổ chức Google Workspace tìm thấy không gian trong Google Chat.
Để sử dụng các phương thức này với phạm vi chat.import
, người dùng được mạo danh phải là người quản lý không gian.
Đối với không gian bên ngoài, phương thức create()
thành viên cũng cho phép mời người dùng bên ngoài tổ chức Workspace của bạn. Đảm bảo rằng bạn hiểu rõ tất cả các hạn chế đã biết đối với người dùng bên ngoài.
Khắc phục sự cố
Nếu bạn gặp vấn đề khi nhập phòng Chat, hãy xem xét các vấn đề sau để được trợ giúp. Nếu bạn gặp phải một phản hồi lỗi, hãy ghi lại phản hồi đó (sao chép/dán văn bản vào một tài liệu hoặc lưu ảnh chụp màn hình) để tham khảo và khắc phục sự cố sau này.
Khi một không gian được nhập thành công, CompleteImportSpace
sẽ hoàn tất với trạng thái OK
.
Chưa hoàn tất quá trình nhập trước khi hết khoảng thời gian 90 ngày
Như đã mô tả trước đó trong phần Tạo không gian ở chế độ nhập, nếu không gian vẫn ở chế độ nhập sau 90 ngày kể từ thời điểm phương thức tạo được gọi, thì không gian đó sẽ tự động bị xoá và không thể truy cập cũng như khôi phục.
Rất tiếc, không gian đã xoá không còn tồn tại hoặc không thể khôi phục được và bạn phải bắt đầu lại quy trình nhập.
Nếu không gian không được nhập vì có quá nhiều dữ liệu cần nhập trong khoảng thời gian 90 ngày với giới hạn sử dụng hiện tại, hãy chia không gian đó thành hai hoặc nhiều không gian nhỏ hơn để lưu trữ, rồi bắt đầu lại quy trình nhập.
Tìm không gian bị thiếu
Nếu bạn không tìm thấy không gian Chat mới, hãy xem bảng sau đây để biết phản hồi mà bạn nhận được từ CompleteImportSpace
, cũng như nội dung giải thích và cách giải quyết.
Đã nhận được phản hồi | Các bước điều tra | Giải thích | Độ phân giải |
---|---|---|---|
CompleteImportSpace sẽ tạo ra một ngoại lệ và lệnh gọi GetSpace sẽ trả về PERMISSION_DENIED . |
Kiểm tra hồ sơ để biết thời điểm không gian được tạo và nếu không gian đó đã được tạo hơn 90 ngày, thì không gian đó sẽ tự động bị xoá. Ngoài ra, không có bản ghi nào về không gian đã nhập trong công cụ quản lý không gian hoặc nhật ký kiểm tra. | Đã quá 90 ngày kể từ khi quá trình nhập bắt đầu và không gian không thoát khỏi quá trình di chuyển thành công. | Tạo một không gian mới rồi chạy lại quy trình nhập. |
CompleteImportSpace trả về OK và gọi GetSpace trả về PERMISSION_DENIED . |
Không có bản ghi nào về không gian đã nhập trong công cụ quản lý không gian, nhưng không gian đó được hiển thị là đã bị xoá trong nhật ký kiểm tra. | Không gian đã được nhập thành công nhưng sau đó bị xoá. | Tạo một không gian mới rồi chạy lại quy trình nhập. |