باستخدام Google Chat API، يمكنك استيراد البيانات من المنصات الأخرى للمراسلة إلى Google Chat. يمكنك استيراد الرسائل والمرفقات والتفاعلات والأعضاء والمساحات الحالية من منصات المراسلة الأخرى إلى موارد Chat API المقابلة. يمكنك استيراد هذه البيانات من خلال إنشاء مساحات Chat في وضع الاستيراد واستيراد البيانات إلى تلك المساحات. بعد اكتمال العملية بنجاح، تصبح هذه المساحات مساحات Chat عادية.
في ما يلي مخطّط عمليّة الاستيراد بالكامل:
- التخطيط للاستيراد
- ضبط التفويض لتطبيق Chat
- إنشاء مساحة في وضع الاستيراد
- استيراد الموارد
- التحقّق من صحة الموارد المستورَدة
- مطابقة الاختلافات في الموارد المستورَدة من البيانات المصدر
- إكمال وضع الاستيراد
- منح الإذن بالوصول إلى المساحة بعد وضع الاستيراد
- تحديد المشاكل وحلّها
المتطلبات الأساسية
برمجة تطبيقات
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- أنشِئ مشروعًا على Google Cloud.
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- أنشِئ مشروعًا مستقلاً لبرمجة التطبيقات، وفعِّل خدمة Chat المتقدّمة.
- يجب تفويض سلطة على مستوى النطاق لتطبيق Chat في أي نطاقات يستورد التطبيق المحتوى منها، راجِع مقالة تفويض تطبيقات Chat.
Python
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- أنشئ مشروعًا على Google Cloud.
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- الإصدار 3.6 من Python أو إصدار أحدث
- أداة إدارة حزم pip
- يجب تفويض سلطة على مستوى النطاق لتطبيق Chat في أي نطاقات يستورد التطبيق المحتوى منها، راجِع مقالة تفويض تطبيقات Chat.
التخطيط للاستيراد
خطط وفقًا لذلك لكمية البيانات التي سيتم استيرادها، وتعرَّف على كيفية تأثير حدود الاستخدام والحصص في عملية الاستيراد، وكن على دراية بأنواع مساحات Chat المتوافقة عند الاستيراد إلى مساحة جديدة.
مراجعة حدود استخدام واجهة برمجة التطبيقات
يمكن أن يختلف الوقت اللازم لاستيراد البيانات إلى 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
.
بعد اكتمال عملية الاستيراد بنجاح، يمكنك إضافة مستخدمين خارجيين.
يوضّح المثال التالي كيفية إنشاء مساحة في وضع الاستيراد:
برمجة تطبيقات
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
نفسه، حتى إذا تم حذف الرسائل السابقة في ذلك الوقت.
لا يمكن عرض معاينات روابط في Google Chat للرسائل التي تحتوي على عناوين URL تابعة لجهات خارجية في مساحات وضع الاستيراد.
عند إنشاء الرسائل في وضع الاستيراد، لا تُرسِل المساحات إشعارات أو رسائل إلكترونية إلى أي مستخدمين، بما في ذلك الرسائل التي تحتوي على إشارات إلى مستخدمين.
يوضّح المثال التالي كيفية إنشاء رسالة في مساحة وضع الاستيراد:
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
: عنوان البريد الإلكتروني لحساب المستخدم الذي تتم impersonatingه باستخدام إذن على مستوى النطاق SPACE_NAME
: اسم المساحة التي تم إنشاؤها في وضع الاستيراد.
التفاعلات
يمكن لتطبيق Chat استيراد التفاعلات مع الرسائل باستخدام Chat API. للحصول على معلومات عن طرق الموارد و أنواع المصادقة المتوافقة في مساحات وضع الاستيراد، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
المرفقات
يمكن لتطبيق Chat تحميل المرفقات باستخدام Chat API. للحصول على معلومات عن طرق الموارد وأنواع إتاحة المصادقة في مساحات وضع الاستيراد، يُرجى الاطّلاع على تفويض التطبيقات في Chat. ومع ذلك، ننصح بشدة باستخدام Google Drive API لتحميل المرفقات كملفات Google Drive وربط عناوين URL الخاصة بالملف بالرسائل المعنيّة في مساحات وضع الاستيراد لاستيراد المرفقات من منصات مراسلة أخرى لتجنّب تجاوز الحدّ الداخلي المسموح به في Google Chat لتحميل المرفقات.
العضويات السابقة
الاشتراكات السابقة هي اشتراكات تم إنشاؤها للمستخدمين الذين سبق لهم مغادرة كيان المساحة الأصلي من منصة المراسلة المصدر، ولكنك تريد الاحتفاظ ببياناتهم في Chat. للحصول على معلومات عن إضافة أعضاء جدد بعد إيقاف وضع استيراد المساحة، يُرجى الاطّلاع على إنشاء مرجع للعضوية.
في العديد من الحالات، عندما يخضع هؤلاء الأعضاء السابقون لسياسة الاحتفاظ بالبيانات في Google،
قد تحتاج إلى الاحتفاظ بالبيانات (مثل الرسائل والردود) التي تم إنشاؤها من خلال الاشتراكات السابقة في مساحة قبل استيرادها إلى Chat.
عندما تكون المساحة في وضع الاستيراد، يمكنك استيراد هذه العضويات السابقة
إلى المساحة باستخدام
طريقة create
في
مورد Membership
.
للحفاظ على وقت مغادرة الاشتراك السابق، عليك ضبط
deleteTime
الاشتراك. يجب أن يكون وقت الخروج هذا دقيقًا لأنّه
يؤثّر في البيانات التي يجب الاحتفاظ بها لهذه العضويات. بالإضافة إلى ذلك، يجب أن يكون هذا deleteTime
بعد الطابع الزمني لإنشاء المساحة وألّا يكون طابعًا زمنيًا مستقبليًا.
بالإضافة إلى deleteTime
، يمكنك أيضًا ضبط createTime
للحفاظ على
وقت الانضمام الأصلي للاشتراك السابق. على عكس deleteTime
، يكون
createTime
اختياريًا. في حال عدم ضبط القيمة، يتم احتساب createTime
تلقائيًا من خلال
طرح 1 ميكرو ثانية من deleteTime
. في حال ضبط هذه السياسة، يجب أن يكون createTime
قبل
deleteTime
وأن يتم تفعيله في وقت إنشاء المساحة أو بعده. لا يتم استخدام معلومات createTime
هذه لتحديد الاحتفاظ بالبيانات ولا تظهر في أدوات المشرفين، مثل "وحدة تحكّم المشرف في Google" وGoogle Vault.
على الرغم من أنّه قد تكون هناك طرق متعدّدة يمكن للمستخدم من خلالها الانضمام إلى مساحة ومغادرتها في منصّة المراسلة المصدر (من خلال الدعوات أو الانضمام بأنفسهم أو الإضافة
من قِبل مستخدم آخر)، يتم تمثيل كل هذه الإجراءات في 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
: عنوان البريد الإلكتروني لحساب المستخدم الذي تتم impersonatingه باستخدام إذن على مستوى النطاق SPACE_NAME
: اسم المساحة التي تم إنشاؤها في وضع الاستيراد.USER_ID
: المعرّف الفريد ل المستخدِم.
استيراد الموارد في مساحة خارجية
لا يمكنك إنشاء مساحة خارجية إلا باستخدام وضع الاستيراد باستخدام بيانات الاعتماد الخاصة بالمستخدمين داخل مؤسستك على Workspace. لا ينطبق ذلك إلا عندما تكون المساحة في وضع الاستيراد. بعد أن تتم عملية إكمال وضع الاستيراد في المساحة، يمكن دعوة مستخدمين خارجيين للانضمام إلى المساحات التي تم استيرادها (راجِع قسم الوصول)، ويمكن استخدام بيانات اعتمادهم للاتصال بواجهة برمجة تطبيقات Chat.
التحقّق من صحة الموارد المستورَدة
يمكن لتطبيق Chat قراءة محتوى مساحة وضع الاستيراد والتحقّق من محتواه من خلال استدعاء
طريقة list
على
مورد Message
.
يمكنك قراءة موارد Reaction
وAttachment
من حقلَي
emojiReactionSummaries
وattachment
في أي رسالة تم إرجاعها. لا يمكن لتطبيقات المحادثة
استدعاء هذه الطريقة إلا نيابةً عن مستخدم من خلال انتحال الهوية. لمزيد من
المعلومات، يُرجى الاطّلاع على مقالة
تفويض تطبيقات Chat.
يمكن لتطبيق Chat أيضًا قراءة الرسائل الفردية للتحقّق من صحتها من خلال استدعاء get
method
في Message
resource.
لا يمكن لتطبيقات Chat استدعاء هذه الطريقة لقراءة رسائلها إلا باستخدام تفويضاتها الخاصة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
يمكن لتطبيقات المحادثة أيضًا إدراج العضويات السابقة من خلال استدعاء list
في Membership
.
بعد خروج المساحة من وضع الاستيراد، لا تعرض طريقة list
الاشتراكات السابقة
بعد الآن. لا يمكن لتطبيقات Chat استدعاء هذه الطريقة إلا
بالنيابة عن مستخدم من خلال انتحال الهوية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
يمكنك قراءة سمات مساحة وضع الاستيراد من خلال استدعاء طريقةget
في موردSpace
.
لا يمكن لتطبيقات المحادثة استدعاء هذه الطريقة إلا باستخدام سلطتها الخاصة.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
توفُّر بيانات المصدر التي تتطابق مع بيانات المرجع المستورَد
إذا لم يعُد أي مورد مستورد يتطابق مع الكيان الأصلي من منصة المراسلة المصدر بسبب التغييرات في الكيان الأصلي أثناء الاستيراد، يمكن لتطبيقات Chat استدعاء Chat API لتعديل مورد المحادثة الذي تم استيراده. على سبيل المثال، إذا عدّل مستخدم رسالة في منصة المراسلة المصدر بعد إنشاء تلك الرسالة في Chat، يمكن لتطبيقات Chat تعديل الرسالة المستورَدة بحيث تعرض المحتوى الحالي للرسالة الأصلية.
الرسائل
لتعديل
الحقول المتوافقة
في رسالة في مساحة وضع الاستيراد، استخدِم update
في
Message
resource.
لا يمكن لتطبيقات Chat استدعاء هذه الطريقة إلا باستخدام المرجع نفسه الذي
تم استخدامه أثناء إنشاء الرسالة الأولية. إذا استخدمت انتحال هوية مستخدم أثناء إنشاء الرسالة الأولية، يجب استخدام المستخدم نفسه الذي انتحلت هويته لتعديل تلك الرسالة.
لحذف رسالة في مساحة وضع الاستيراد، يمكنك طلب طريقة delete
في مورد Message
.
لا يحتاج منشئ الرسالة الأصلي إلى حذف الرسائل في مساحة وضع الاستيراد، ويمكن حذفها من خلال انتحال هوية أي مستخدم في النطاق.
لا يمكن لتطبيقات المحادثات حذف رسائلها إلا باستخدام
سلطتها الخاصة. لمزيد من المعلومات، يُرجى الاطّلاع على
تفويض التطبيقات في Chat.
التفاعلات
لحذف تفاعل مع رسالة في مساحة وضع الاستيراد، استخدِم
delete
method
في مورد reactions
. للحصول على معلومات عن طرق الموارد وأنواع إتاحة المصادقة في مساحات وضع الاستيراد، يُرجى الاطّلاع على
تفويض التطبيقات في Chat.
المرفقات
لتعديل مرفقات رسالة في مساحة وضع الاستيراد، استخدِم upload
method في مورد media
. للحصول على معلومات عن طرق الموارد وأنواع مصادقة
الدعم في مساحات وضع الاستيراد، يُرجى الاطّلاع على مقالة
تفويض تطبيقات Chat.
العضويات السابقة
لحذف اشتراك سابق في مساحة وضع الاستيراد، استخدِم
الطريقة delete
في
مورد Membership
. بعد خروج
مساحة من وضع الاستيراد، لن تسمح لك طريقة delete
بحذف الاشتراكات
السابقة بعد الآن.
لا يمكنك تعديل اشتراك سابق في مساحة وضع الاستيراد. إذا أردت تصحيح عضوية سابقة تمّ استيرادها بشكل غير صحيح، عليك حذفها أولاً ثم إعادة إنشائها مع إبقاء المساحة في وضع الاستيراد.
المساحات
لتعديل
الحقول المتوافقة في مساحة وضع الاستيراد، استخدِم
طريقة patch
على مورد spaces
.
لحذف مساحة وضع الاستيراد، استخدِم
طريقة delete
على مورد spaces
.
للحصول على معلومات عن طرق الموارد وأنواع المصادقة المتوافقة في مساحات وضع الاستيراد، يُرجى الاطّلاع على مقالة تفويض تطبيقات Chat.
إكمال وضع الاستيراد
قبل استدعاء الطريقة completeImport
، عليك التأكّد من اكتمال التحقّق والتوفيق بين الاختلافات في الموارد. لا يمكن التراجع عن الخروج من مساحة خارج وضع الاستيراد
وتحويل مساحة وضع الاستيراد إلى مساحة عادية. ما مِن مؤشر في Chat ينسب هذه المساحات إلى عملية استيراد بيانات.
دوِّن تاريخ ووقت الاتصال بـ completeImport
، واسم المرجع
للمستخدم الذي أجرى المكالمة، والردّ الذي تم إرجاعه. قد يكون هذا مفيدًا إذا كان لا بد من مواجهة أي مشكلات وعليك التحقيق فيها.
لإكمال وضع الاستيراد وإتاحة المساحة للمستخدمين، يمكن لتطبيق
Chat استدعاء طريقة completeImport
في
مورد Space
.
لا يمكن لتطبيقات Chat استدعاء هذه الطريقة إلا نيابةً عن مستخدم من خلال
انتحال الهوية. لمزيد من المعلومات، يُرجى الاطّلاع على
تفويض التطبيقات في 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
: عنوان البريد الإلكتروني لحساب المستخدم الذي تتم impersonatingه باستخدام إذن على مستوى النطاق 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 عند الاتصال. |
لا يتوفّر سجلّ للمساحة التي تم استيرادها في أداة إدارة المساحة، ولكن يظهر أنّه تم حذف المساحة في سجلّ التدقيق. | تم استيراد المساحة بنجاح، ولكن تم حذفها لاحقًا. | أنشئ مساحة جديدة وشغِّل عملية الاستيراد مرة أخرى. |