يمكنك استخدام واجهة برمجة تطبيقات Google Chat لاستيراد البيانات من منصات المراسلة الأخرى إلى Google Chat. يمكنك استيراد الرسائل والمرفقات والتفاعلات والعضويات وكيانات المساحات الحالية من منصات المراسلة الأخرى إلى موارد Chat API المقابلة. يمكنك استيراد هذه البيانات من خلال إنشاء مساحات Chat في وضع الاستيراد واستيراد البيانات إلى هذه المساحات. بعد اكتمال العملية بنجاح، تصبح هذه المساحات مساحات Chat عادية.
في ما يلي الخطوات الكاملة لعملية الاستيراد:
- التخطيط لعملية الاستيراد
- ضبط إعدادات التفويض لتطبيق محادثات
- إنشاء مساحة في وضع الاستيراد
- استيراد المراجع
- التحقّق من صحة الموارد المستورَدة
- تسوية الاختلافات بين الموارد المستورَدة وبيانات المصدر
- وضع الاستيراد الكامل
- منح الإذن بالوصول إلى المساحة بعد تفعيل وضع الاستيراد
- تحديد المشاكل وحلّها
المتطلبات الأساسية
برمجة التطبيقات
- حساب Google Workspace من إصدار Business أو Enterprise مع إذن الوصول إلى Google Chat
- أنشئ مشروعًا على Google Cloud.
- فعِّل واجهة Google Chat API وأعِدّها من خلال إضافة اسم ورمز ووصف لتطبيق محادثات.
- أنشئ مشروعًا مستقلاً في "برمجة تطبيقات Google"، وفعِّل خدمة Chat المتقدّمة.
- يجب منح تطبيق محادثات تفويضًا على مستوى النطاق في أي نطاقات يستورد التطبيق المحتوى منها، راجِع تفويض تطبيقات محادثات.
Python
- حساب Google Workspace من إصدار Business أو Enterprise مع إذن الوصول إلى Google Chat
- أنشئ مشروعًا على Google Cloud.
- فعِّل واجهة Google Chat API وأعِدّها من خلال إضافة اسم ورمز ووصف لتطبيق محادثات.
- الإصدار 3.6 أو الإصدارات الأحدث من Python
- أداة إدارة الحزم pip
- يجب منح تطبيق محادثات تفويضًا على مستوى النطاق في أي نطاقات يستورد التطبيق المحتوى منها، راجِع تفويض تطبيقات محادثات.
التخطيط لعملية الاستيراد
خطِّط بشكل مناسب لكمية البيانات التي سيتم استيرادها، وافهم كيف يمكن أن تؤثر حدود الاستخدام والحصص في عملية الاستيراد، واطّلِع على أنواع مساحات Chat المتوافقة عند الاستيراد إلى مساحة جديدة. إذا كنت مشرفًا، يُرجى قراءة مقالة استيراد بيانات الرسائل من خدمة خارجية إلى Google Chat واتّباع الخطوات بعناية.
مراجعة حدود استخدام واجهة برمجة التطبيقات
يمكن أن يختلف الوقت المطلوب لاستيراد البيانات إلى Chat بشكل كبير حسب كمية موارد Chat التي سيتم استيرادها. راجِع حدود الاستخدام في تطبيق Chat وكمية البيانات التي سيتم استيرادها من منصة المراسلة المصدر لتحديد جدول زمني تقديري.
عند استيراد الرسائل إلى مساحة، ننصحك بتوزيع طلبات البيانات من الطريقة messages.create() على سلاسل رسائل مختلفة.
تحديد المساحات المتوافقة التي يمكن استيرادها
يتيح وضع الاستيراد المساحات التي تتضمّن SpaceType بقيمتَي SPACE وGROUP_CHAT، ولكن ليس DIRECT_MESSAGE.
لاستيراد محادثات بين شخصين أو بين شخص وتطبيق Chat، استورِد المحادثة إلى مساحة تضم عضوين مع SpaceType من SPACE أو GROUP_CHAT.
إنشاء مساحة في "وضع الاستيراد"
لإنشاء مساحة في وضع الاستيراد، استدعِ طريقة create على مصدر Space واضبط importMode على true.
عند إنشاء المساحة في وضع الاستيراد، يُرجى مراعاة ما يلي:
- التاريخ والوقت: تذكَّر أنّه يجب إكمال وضع الاستيراد في غضون 90 يومًا. إذا كانت المساحة لا تزال في وضع الاستيراد بعد مرور 90 يومًا من وقت استدعاء طريقة
spaces.create()، سيتم حذفها تلقائيًا ولن يكون من الممكن الوصول إليها أو استردادها.- استخدِم قيمة الحقل
importModeExpireTimeلتتبُّع انتهاء الإطار الزمني البالغ 90 يومًا. - لا تستخدِم قيمة الحقل
createTimeلتتبُّع انتهاء الإطار الزمني البالغ 90 يومًا. ولا يكون هذا الإجراء مماثلاً دائمًا لما يحدث عند استدعاء الطريقةspaces.create(). عند استخدام وضع الاستيراد، يمكن ضبط الحقلcreateTimeعلى الطابع الزمني السابق الذي تم فيه إنشاء المساحة في المصدر من أجل الحفاظ على وقت الإنشاء الأصلي.
- استخدِم قيمة الحقل
- اسم مورد المساحة (
name): المعرّف الفريد المستخدَم لاسترداد معلومات حول المساحة المحدّدة، ويتم الرجوع إليه في الخطوات اللاحقة عند استيراد المحتوى إلى المساحة.
للحفاظ على وقت إنشاء كيان المساحة المكافئ من منصة المراسلة المصدر، يمكنك ضبط createTime للمساحة. يجب ضبط قيمة createTime على قيمة تتراوح بين 1 يناير 2000 والوقت الحالي.
لإنشاء مساحة خارجية في وضع الاستيراد، اضبط externalUserAllowed على true.
بعد اكتمال عملية الاستيراد بنجاح، يمكنك إضافة مستخدمين خارجيين.
يوضّح المثال التالي كيفية إنشاء مساحة في وضع الاستيراد:
برمجة التطبيقات
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 API. للحصول على معلومات حول طرق الموارد وأنواع المصادقة المتوافقة في المساحات التي تستخدم وضع الاستيراد، يُرجى الاطّلاع على تفويض تطبيقات Chat.
المرفقات
يمكن لتطبيق محادثاتك تحميل المرفقات باستخدام Chat API. للحصول على معلومات حول طرق الموارد وأنواع المصادقة المتوافقة في المساحات التي تستخدم وضع الاستيراد، يُرجى الاطّلاع على تفويض تطبيقات Chat. ومع ذلك، ننصحك بشدة باستخدام Google Drive API لتحميل المرفقات كملفات في Google Drive وربط معرّفات الموارد المنتظمة (URI) للملفات بالرسائل المعنية في مساحات وضع الاستيراد لاستيراد المرفقات من منصات المراسلة الأخرى لتجنُّب تجاوز الحد الداخلي الذي يفرضه Google Chat على تحميل المرفقات.
العضويات السابقة
العضويات السابقة هي عضويات تم إنشاؤها للمستخدمين الذين سبق لهم مغادرة كيان المساحة الأصلي من منصة المراسلة المصدر، ولكنك تريد الاحتفاظ ببياناتهم في Chat. للحصول على معلومات حول إضافة أعضاء جدد بعد أن تتوقف المساحة عن العمل في وضع الاستيراد، يُرجى الاطّلاع على إنشاء مورد عضوية.
في كثير من الحالات، عندما يخضع هؤلاء الأعضاء السابقون
لسياسة الاحتفاظ بالبيانات في Google،
عليك الاحتفاظ بالبيانات (مثل الرسائل والتفاعلات) التي تم إنشاؤها
من خلال العضويات السابقة في مساحة قبل استيرادها إلى Chat.
أثناء تفعيل وضع الاستيراد في المساحة، يمكنك استيراد عضوياتك السابقة إلى المساحة باستخدام طريقة create في المورد Membership.
للحفاظ على وقت المغادرة في الاشتراك السابق، يجب ضبط deleteTime للاشتراك. يجب أن يكون وقت المغادرة هذا دقيقًا لأنّه يؤثّر في البيانات التي سيتم الاحتفاظ بها لهذه العضويات. بالإضافة إلى ذلك، يجب أن يكون هذا الطابع الزمني deleteTime
بعد الطابع الزمني لإنشاء المساحة وألّا يكون طابعًا زمنيًا مستقبليًا.
بالإضافة إلى deleteTime، يمكنك أيضًا ضبط createTime للحفاظ على وقت الانضمام الأصلي للعضوية السابقة. على عكس deleteTime، يكون createTime اختياريًا. في حال عدم ضبطها، يتم احتساب createTime تلقائيًا عن طريق طرح ميكروثانية واحدة من deleteTime. في حال ضبطها، يجب أن يكون createTime قبل deleteTime ويجب أن يكون في وقت إنشاء المساحة أو بعده. لا يتم استخدام هذه المعلومات لتحديد مدة الاحتفاظ بالبيانات، ولا تظهر في أدوات المشرفين، مثل "وحدة تحكّم المشرف في Google" وGoogle Vault.createTime
على الرغم من أنّه قد تتوفّر عدة طرق يمكن للمستخدم من خلالها الانضمام إلى مساحة ومغادرتها في منصة المراسلة المصدر (من خلال الدعوات أو الانضمام بنفسه أو إضافته من قِبل مستخدم آخر)، يتم تمثيل كل هذه الإجراءات في 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.
التحقّق من صحة المراجع المستورَدة
يمكن لتطبيق محادثاتك قراءة محتوى مساحة وضع الاستيراد والتحقّق من صحته من خلال استدعاء طريقة list في مورد Message.
يمكنك قراءة موارد Reaction وAttachment من حقلَي emojiReactionSummaries وattachment في أي رسالة تم إرجاعها. يمكن لتطبيقات المحادثات استدعاء هذا الإجراء نيابةً عن مستخدم من خلال انتحال الهوية فقط. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
يمكن لتطبيق Chat أيضًا قراءة الرسائل الفردية للتحقّق من صحتها من خلال استدعاء طريقة get على مورد Message.
يمكن لتطبيقات المحادثة استدعاء هذه الطريقة لقراءة رسائلها فقط باستخدام إذنها الخاص. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
يمكن لتطبيقات المحادثة أيضًا عرض العضويات السابقة من خلال استدعاء طريقة list في مورد Membership.
بعد خروج المساحة من وضع الاستيراد، لن تعرض طريقة list العضويات السابقة. لا يمكن لتطبيقات المحادثات استدعاء هذه الطريقة إلا نيابةً عن مستخدم من خلال انتحال الهوية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
يمكنك قراءة خصائص مساحة وضع الاستيراد من خلال استدعاء طريقة get على المورد Space. سيتضمّن الردّ أيضًا
importModeExpireTime
الذي تم ملؤه، ما يتيح لك تتبُّع الإطار الزمني اللازم لإكمال عملية الاستيراد بشكل صحيح.
لا يمكن لتطبيقات المحادثة استدعاء هذه الطريقة إلا باستخدام إذنها الخاص.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
تسوية اختلافات الموارد المستوردة من بيانات المصدر
إذا لم يعُد أي مرجع مستورَد مطابقًا للكيان الأصلي من منصة المراسلة المصدر بسبب تغييرات في الكيان الأصلي أثناء الاستيراد، يمكن لتطبيقات Chat استدعاء Chat API لتعديل مرجع المحادثة المستورَد. على سبيل المثال، إذا عدّل مستخدم رسالة في منصة المراسلة المصدر بعد إنشاء هذه الرسالة في Chat، يمكن لتطبيقات Chat تعديل الرسالة المستوردة لتعكس المحتوى الحالي للرسالة الأصلية.
الرسائل
لتعديل
الحقول المتوافقة
في رسالة ضمن مساحة وضع الاستيراد، استدعِ طريقة
update
في المورد
Message.
لا يمكن لتطبيقات المحادثة استدعاء هذه الطريقة إلا باستخدام الإذن نفسه الذي تم استخدامه أثناء إنشاء الرسالة الأولية. إذا استخدمت ميزة تسجيل الدخول باسم مستخدم آخر أثناء إنشاء الرسالة الأوّلية، عليك استخدام المستخدم نفسه الذي تم تسجيل الدخول باسمه لتعديل تلك الرسالة.
لحذف رسالة في مساحة في وضع الاستيراد، استخدِم طريقة
delete
في المورد
Message.
لا يحتاج منشئ الرسالة الأصلي إلى حذف الرسائل في مساحة وضع الاستيراد، ويمكن حذفها من خلال انتحال هوية أي مستخدم في النطاق.
يمكن لتطبيقات المحادثة حذف رسائلها فقط باستخدام سلطتها الخاصة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
التفاعلات
لحذف تفاعل على رسالة في مساحة في وضع الاستيراد، استخدِم طريقة
delete
في المورد reactions. للحصول على معلومات حول طرق الموارد وأنواع المصادقة المتوافقة في المساحات التي تستخدم وضع الاستيراد، يُرجى الاطّلاع على تفويض تطبيقات Chat.
المرفقات
لتعديل المرفقات لرسالة في مساحة وضع الاستيراد، استخدِم الطريقة upload في المورد media. للحصول على معلومات حول طرق الموارد وأنواع المصادقة المتوافقة في المساحات التي تستخدم وضع الاستيراد، يُرجى الاطّلاع على تفويض تطبيقات Chat.
العضويات السابقة
لحذف عضوية سابقة في مساحة وضع الاستيراد، استخدِم طريقة
delete
في
Membership. بعد خروج مساحة من وضع الاستيراد، لن تتيح لك الطريقة delete حذف العضويات السابقة.
لا يمكنك تعديل عضوية سابقة في مساحة في وضع الاستيراد. إذا أردت تصحيح عضوية سابقة تم استيرادها بشكل غير صحيح، عليك حذفها أولاً ثم إعادة إنشائها بينما تكون المساحة لا تزال في وضع الاستيراد.
Spaces
لتعديل
الحقول المتوافقة في
مساحة وضع الاستيراد، استخدِم
طريقة patch
في المورد spaces.
لحذف مساحة وضع الاستيراد، استخدِم طريقة delete على مورد spaces.
للحصول على معلومات حول طرق الموارد وأنواع المصادقة المتوافقة في المساحات التي تستخدم وضع الاستيراد، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
وضع الاستيراد الكامل
قبل استدعاء طريقة completeImport،
عليك التأكّد من إكمال التحقّق من الصحة وتسوية الاختلافات في الموارد. إنّ الخروج من مساحة في وضع الاستيراد هو عملية لا يمكن التراجع عنها، ويؤدي إلى تحويل مساحة وضع الاستيراد إلى مساحة عادية. لا يتوفّر مؤشر في Chat يربط هذه المساحات بعملية استيراد بيانات.
دوِّن تاريخ ووقت الاتصال بـ completeImport واسم المورد الخاص بالمستخدم الذي أجرى الاتصال والرد الذي تم إرجاعه. يمكن أن يكون ذلك مفيدًا
إذا واجهت أي مشاكل وكان عليك التحقيق فيها.
لإكمال وضع الاستيراد وإتاحة المساحة للمستخدمين، يمكن لتطبيق محادثات استدعاء طريقة completeImport على Space المورد.
لا يمكن لتطبيقات المحادثات استدعاء هذه الطريقة نيابةً عن مستخدم إلا من خلال
انتحال الهوية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
تتم إضافة المستخدم الذي تم انتحال هويته إلى المساحة
كمدير للمساحة
بعد اكتمال هذه الطريقة. يجب استدعاء هذه الطريقة في غضون 90 يومًا من طلب الإجراء الأولي create.space. إذا حاولت استدعاء هذه الطريقة بعد انقضاء مدة الـ 90 يومًا، ستؤدي عملية الاستدعاء إلى حدوث أخطاء لأنّه يتم حذف المساحة في وضع الاستيراد ولن يعود بإمكان تطبيق محادثات الوصول إليها.
لا يشترط أن يكون المستخدم الذي يتم انتحال هويته في طريقة completeImport هو من أنشأ المساحة.
لا تتصل بالرقم completeImport قبل importModeExpireTime بوقت قصير جدًا، لأنّه لا يمكننا ضمان وصول الطلب قبل importModeExpireTime، وقد تحدث تعارضات مع معالجة البيانات في الأنظمة التي يتم تشغيلها في وقت انتهاء الصلاحية.
ننصحك بالاتصال على الرقم completeImport قبل importModeExpireTime بـ 30 دقيقة على الأقل.
يوضّح المثال التالي كيفية إكمال عملية الاستيراد:
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 وانتحال هوية المستخدم في غضون 90 يومًا من أول طلب إجراء create.space() لإجراء ما يلي:
- إضافة أعضاء إلى المساحة: استدعِ طريقة
create()في الموردMembership. ننصح بأن تنشئ تطبيقات Chat مواردMembershipفور اكتمال عملية استيراد المساحة، حتى تتمكّن تطبيقات Chat من مواصلة استخدام النطاقchat.import، والتأكّد من أنّ جميع الأعضاء الذين تم استيرادهم يمكنهم الوصول إلى المساحة. يجب تحديد الأولوية لإضافة أعضاء قد يخضعون لسياسة التجميد في Vault، التي تسمح بالاحتفاظ بالرسائل المستوردة حتى إذا كانت خارج فترة الاحتفاظ بالبيانات. - تحديد جمهور مستهدَف: استخدِم طريقة
update()في الموردSpace. للتعرّف على كيفية إنشاء الجماهير المستهدفة وإضافتها، راجِع المقالة إتاحة إمكانية اكتشاف مساحة Google Chat لمستخدمين محدّدين في مؤسسة Google Workspace.
لاستخدام هذه الطرق مع النطاق chat.import، يجب أن يكون المستخدم الذي يتم انتحال هويته مدير مساحة.
بالنسبة إلى المساحات الخارجية، تتيح طريقةcreate() العضوية أيضًا دعوة مستخدمين من خارج مؤسسة Workspace. يُرجى التأكّد من فهمك لجميع القيود المعروفة للمستخدمين الخارجيين.
تحديد المشاكل وحلّها
إذا واجهت مشكلة عند استيراد مساحات Chat، راجِع المشاكل التالية للحصول على المساعدة. إذا تلقّيت ردًا يتضمّن خطأ، سجِّل ملاحظة عنه (انسخ النص والصقه في مستند أو احفظ لقطة شاشة) للرجوع إليه في المستقبل وتحديد المشاكل وحلّها.
عند استيراد مساحة بنجاح، يكتمل CompleteImportSpace بالحالة OK.
لم تُكمل عملية الاستيراد قبل انتهاء فترة السماح البالغة 90 يومًا
كما هو موضّح سابقًا في إنشاء مساحة في وضع الاستيراد، إذا كانت المساحة لا تزال في وضع الاستيراد بعد 90 يومًا من وقت استدعاء طريقة الإنشاء، سيتم حذفها تلقائيًا ولن يكون من الممكن الوصول إليها أو استردادها.
للأسف، لم تعُد المساحة المحذوفة متاحة أو قابلة للاسترداد، ويجب بدء عملية الاستيراد مرة أخرى.
إذا لم يتم استيراد المساحة لأنّها تتضمّن الكثير من البيانات التي لا يمكن استيرادها خلال فترة 90 يومًا مع حدود الاستخدام الحالية، قسِّم المساحة إلى مساحتين أو أكثر لأغراض الأرشفة، ثم ابدأ عملية الاستيراد مرة أخرى.
العثور على مساحات غير متوفّرة
إذا لم تتمكّن من العثور على مساحة Chat الجديدة، راجِع الجدول التالي للاطّلاع على الردّ الذي تلقّيته من CompleteImportSpace لمعرفة التفسير وكيفية حلّ المشكلة.
| تمّ تلقي الردّ. | خطوات التحقيق | الشرح | الدقة |
|---|---|---|---|
يطرح CompleteImportSpace استثناءً ويعرض استدعاء GetSpace القيمة PERMISSION_DENIED. |
راجِع سجلّاتك لمعرفة تاريخ إنشاء المساحة، وإذا كان تاريخ إنشائها أقدم من 90 يومًا، يعني ذلك أنّه تم حذفها تلقائيًا. بالإضافة إلى ذلك، لا يتوفّر سجلّ للمساحة المستورَدة في أداة إدارة المساحات أو سجلّ التدقيق. | مرّ أكثر من 90 يومًا منذ بدء عملية الاستيراد، وتعذّر إيقاف عملية نقل البيانات بنجاح. | أنشئ مساحة جديدة ونفِّذ عملية الاستيراد مرة أخرى. |
تعرض الدالة CompleteImportSpace القيمة OK، وتعرض الدالة GetSpace القيمة PERMISSION_DENIED. |
لا يتوفّر سجلّ للمساحة المستورَدة في أداة إدارة المساحات، ولكن يظهر أنّه تم حذف المساحة في سجلّ التدقيق. | تم استيراد المساحة بنجاح، ولكن تم حذفها لاحقًا. | أنشئ مساحة جديدة ونفِّذ عملية الاستيراد مرة أخرى. |