Google Chat में डेटा इंपोर्ट करना

Google Chat API की मदद से, अन्य मैसेजिंग प्लैटफ़ॉर्म से डेटा को Google Chat में इंपोर्ट किया जा सकता है. मैसेजिंग की सुविधा देने वाले अन्य प्लैटफ़ॉर्म से, मौजूदा मैसेज, अटैचमेंट, प्रतिक्रियाएं, सदस्यताएं, और स्पेस की इकाइयां, Chat API के संसाधनों में इंपोर्ट की जा सकती हैं. इस डेटा को इंपोर्ट करने के लिए, Chat में स्पेस बनाए जा सकते हैं. इसके लिए, इंपोर्ट मोड का इस्तेमाल करें. इसके बाद, उन स्पेस में डेटा इंपोर्ट करें. प्रोसेस पूरी होने के बाद, ये स्पेस स्टैंडर्ड Chat स्पेस बन जाते हैं.

इंपोर्ट करने की पूरी प्रोसेस यहां दी गई है:

  1. इंपोर्ट करने की योजना बनाना
  2. Chat ऐप्लिकेशन के लिए अनुमति देने की सुविधा कॉन्फ़िगर करना
  3. इंपोर्ट मोड में कोई स्पेस बनाना
  4. इंपोर्ट करने के संसाधन
  5. इंपोर्ट किए गए संसाधनों की पुष्टि करना
  6. सोर्स डेटा से इंपोर्ट किए गए संसाधन के अंतर का मिलान करना
  7. पूरा इंपोर्ट मोड
  8. इंपोर्ट मोड के बाद स्पेस का ऐक्सेस देना
  9. समस्या का हल

ज़रूरी शर्तें

Apps Script

Python

इंपोर्ट करने की योजना बनाना

इंपोर्ट किए जाने वाले डेटा की मात्रा के हिसाब से प्लान बनाएं. साथ ही, यह समझें कि इस्तेमाल की सीमाएं और कोटा, इंपोर्ट करने की प्रोसेस पर कैसे असर डाल सकते हैं. इसके अलावा, यह भी जानें कि नए स्पेस में इंपोर्ट करते समय, Chat के किस तरह के स्पेस काम करते हैं. अगर आप एडमिन हैं, तो किसी दूसरी सेवा से Google Chat में मैसेज का डेटा इंपोर्ट करना लेख पढ़ें और दिए गए निर्देशों का पालन करें.

एपीआई के इस्तेमाल से जुड़ी सीमाओं की समीक्षा करना

Chat में डेटा इंपोर्ट करने में लगने वाला समय, इंपोर्ट किए जाने वाले Chat संसाधनों की संख्या के हिसाब से अलग-अलग हो सकता है. Chat ऐप्लिकेशन के इस्तेमाल की सीमाएं और सोर्स मैसेजिंग प्लैटफ़ॉर्म से इंपोर्ट किए जाने वाले डेटा की मात्रा देखें. इससे आपको अनुमानित समयसीमा का पता चलेगा.

किसी स्पेस में मैसेज इंपोर्ट करते समय, हमारा सुझाव है कि आप अलग-अलग मैसेज थ्रेड में messages.create() तरीके से कॉल फैलाएं.

इंपोर्ट किए जा सकने वाले स्पेस की पहचान करना

इंपोर्ट मोड में, SPACE और GROUP_CHAT के SpaceType वाले स्पेस इस्तेमाल किए जा सकते हैं. हालांकि, DIRECT_MESSAGE वाले स्पेस इस्तेमाल नहीं किए जा सकते.

दो लोगों या किसी व्यक्ति और Chat ऐप्लिकेशन के बीच हुई बातचीत को इंपोर्ट करने के लिए, बातचीत को दो सदस्यों वाले स्पेस में इंपोर्ट करें. इसके लिए, SpaceType SPACE या GROUP_CHAT का इस्तेमाल करें.

इंपोर्ट मोड में स्पेस बनाना

इंपोर्ट मोड में स्पेस बनाने के लिए, Space संसाधन पर create तरीके को कॉल करें और importMode को true पर सेट करें.

इंपोर्ट मोड में स्पेस बनाते समय, इन बातों का ध्यान रखें.

  • तारीख और समय - ध्यान रखें कि इंपोर्ट मोड को 90 दिनों के अंदर पूरा करना ज़रूरी है. अगर spaces.create() तरीके को कॉल करने के 90 दिनों बाद भी स्पेस इंपोर्ट मोड में रहता है, तो उसे अपने-आप मिटा दिया जाता है. इसके बाद, उसे ऐक्सेस नहीं किया जा सकता और न ही वापस लाया जा सकता है.
    • 90 दिनों की समयसीमा खत्म होने पर नज़र रखने के लिए, importModeExpireTime फ़ील्ड की वैल्यू का इस्तेमाल करें.
    • 90 दिनों की समयसीमा खत्म होने की जानकारी को ट्रैक करने के लिए, createTime फ़ील्ड की वैल्यू का इस्तेमाल न करें. यह हमेशा 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 ऐप्लिकेशन को अनुमति देना लेख पढ़ें. इंपोर्ट मोड वाले स्पेस में मैसेज इंपोर्ट करने के लिए, Message रिसोर्स पर create तरीके को कॉल करें. सोर्स मैसेजिंग प्लैटफ़ॉर्म से मिले ओरिजनल मैसेज के क्रिएशन टाइम को बनाए रखने के लिए, मैसेज का createTime सेट किया जा सकता है. इस createTime को, स्पेस बनाने के समय और मौजूदा समय के बीच की किसी वैल्यू पर सेट किया जाना चाहिए.

एक ही स्पेस में मौजूद मैसेज में एक ही createTime नहीं हो सकता. भले ही, उस समय के पिछले मैसेज मिटा दिए गए हों.

इंपोर्ट मोड वाले स्पेसेज़ में, तीसरे पक्ष के यूआरएल वाले मैसेज में 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)

इनकी जगह ये डालें:

प्रतिक्रियाएं

Chat API का इस्तेमाल करके, आपका Chat ऐप्लिकेशन मैसेज के लिए प्रतिक्रियाएं इंपोर्ट कर सकता है. इंपोर्ट मोड वाले स्पेस में, संसाधन के तरीकों और पुष्टि करने के तरीकों के बारे में जानने के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

अटैचमेंट

Chat API का इस्तेमाल करके, आपका Chat ऐप्लिकेशन अटैचमेंट अपलोड कर सकता है. इंपोर्ट मोड वाले स्पेस में, संसाधन के तरीकों और पुष्टि करने के तरीकों के बारे में जानने के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें. हालांकि, हमारा सुझाव है कि अटैचमेंट को Google Drive फ़ाइलों के तौर पर अपलोड करने के लिए, Google Drive API का इस्तेमाल करें. साथ ही, फ़ाइल यूआरआई को इंपोर्ट मोड वाले स्पेस में मौजूद मैसेज से लिंक करें, ताकि अन्य मैसेजिंग प्लैटफ़ॉर्म से अटैचमेंट इंपोर्ट किए जा सकें. इससे, अटैचमेंट अपलोड करने के लिए Google Chat की तय सीमा को पूरा नहीं करना पड़ेगा.

पुरानी सदस्यताएं

पिछली सदस्यताएं उन उपयोगकर्ताओं के लिए बनाई जाती हैं जो सोर्स मैसेजिंग प्लैटफ़ॉर्म से ओरिजनल स्पेस एंटिटी छोड़ चुके हैं. हालांकि, आपको उनका डेटा Chat में बनाए रखना है. स्पेस को इंपोर्ट मोड से हटाने के बाद, नए सदस्यों को जोड़ने के बारे में जानकारी पाने के लिए, सदस्यता संसाधन बनाना लेख पढ़ें.

कई मामलों में, जब पुराने सदस्यों पर Google की डेटा के रखरखाव की नीति लागू होती है, तो आपको Chat में स्पेस इंपोर्ट करने से पहले, स्पेस में पुराने सदस्यों के बनाए गए डेटा (जैसे कि मैसेज और प्रतिक्रियाएं) को सेव रखना होता है. स्पेस को इंपोर्ट मोड में रखते हुए, उन पुरानी सदस्यताओं को स्पेस में इंपोर्ट किया जा सकता है. इसके लिए, Membership रिसॉर्स पर create तरीके का इस्तेमाल करें. सदस्यता छोड़ने के समय को बनाए रखने के लिए, आपको सदस्यता के deleteTime को सेट करना होगा. छुट्टी पर जाने का समय सटीक होना चाहिए, क्योंकि इससे यह तय होता है कि उन सदस्यताओं के लिए कौनसा डेटा बनाए रखना है. इसके अलावा, यह deleteTime स्पेस बनाए जाने के टाइमस्टैंप के बाद का होना चाहिए और आने वाले समय का टाइमस्टैंप नहीं होना चाहिए.

deleteTime के अलावा, createTime को भी सेट किया जा सकता है, ताकि सदस्यता लेने के मूल समय को सुरक्षित रखा जा सके. deleteTime के उलट, createTime का इस्तेमाल करना ज़रूरी नहीं है. अगर इसे सेट नहीं किया जाता है, तो createTime की वैल्यू, deleteTime की वैल्यू में से एक माइक्रोसेकंड घटाकर अपने-आप कैलकुलेट हो जाती है. अगर सेट किया गया है, तो createTime, deleteTime से पहले का होना चाहिए. साथ ही, यह स्पेस बनाने के समय या उसके बाद का होना चाहिए. इस createTime जानकारी का इस्तेमाल, डेटा को बनाए रखने की अवधि तय करने के लिए नहीं किया जाता. साथ ही, यह Google Admin console और 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)

इनकी जगह ये डालें:

संगठन से बाहर के स्पेस में संसाधन इंपोर्ट करना

इंपोर्ट मोड का इस्तेमाल करके, सिर्फ़ Workspace संगठन के उपयोगकर्ताओं के क्रेडेंशियल से बाहरी स्पेस बनाया जा सकता है. यह सिर्फ़ तब लागू होता है, जब स्पेस इंपोर्ट मोड में हो. स्पेस के इंपोर्ट मोड पूरा होने के बाद, बाहरी उपयोगकर्ताओं को इंपोर्ट किए गए स्पेस में शामिल होने का न्योता भेजा जा सकता है. इसके लिए, ऐक्सेस सेक्शन देखें. साथ ही, उनके क्रेडेंशियल का इस्तेमाल Chat API को कॉल करने के लिए किया जा सकता है.

इंपोर्ट किए गए संसाधनों की पुष्टि करना

आपका Chat ऐप्लिकेशन, इंपोर्ट मोड वाले स्पेस के कॉन्टेंट को पढ़कर उसकी पुष्टि कर सकता है. इसके लिए, उसे Message रिसॉर्स पर list तरीके का इस्तेमाल करना होगा. वापस लाए गए किसी भी मैसेज के emojiReactionSummaries और attachment फ़ील्ड से, Reaction और Attachment संसाधन पढ़े जा सकते हैं. चैट ऐप्लिकेशन, किसी उपयोगकर्ता की पहचान चुराकर ही उसकी ओर से इस तरीके को कॉल कर सकते हैं. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

आपका Chat ऐप्लिकेशन, पुष्टि करने के लिए अलग-अलग मैसेज भी पढ़ सकता है. इसके लिए, उसे Message संसाधन पर get तरीके को कॉल करना होगा. Chat ऐप्लिकेशन, इस तरीके का इस्तेमाल करके सिर्फ़ अपने मैसेज पढ़ सकते हैं. इसके लिए, उन्हें अपनी अनुमति का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

चैट ऐप्लिकेशन, Membership संसाधन पर list तरीके को कॉल करके, सदस्यता का इतिहास भी दिखा सकते हैं. स्पेस के इंपोर्ट मोड से बाहर निकलने के बाद, list तरीके से पुरानी मेंबरशिप की जानकारी नहीं मिलती. चैट ऐप्लिकेशन, उपयोगकर्ता की ओर से इस तरीके को सिर्फ़ तब कॉल कर सकते हैं, जब वे उपयोगकर्ता की पहचान छिपाकर काम कर रहे हों. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

इंपोर्ट मोड वाले स्पेस की प्रॉपर्टी को पढ़ने के लिए, Space संसाधन पर get तरीके को कॉल करें. जवाब में importModeExpireTime भी दिखेगा, ताकि इंपोर्ट की प्रोसेस पूरी होने में लगने वाले समय को सही तरीके से ट्रैक किया जा सके. चैट ऐप्लिकेशन, इस तरीके को सिर्फ़ अपनी अनुमति से कॉल कर सकते हैं. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

सोर्स डेटा से इंपोर्ट किए गए संसाधन के अंतर को मिलाना

अगर इंपोर्ट की गई कोई संसाधन, सोर्स मैसेजिंग प्लैटफ़ॉर्म की ओरिजनल इकाई से मेल नहीं खाता है, तो Chat ऐप्लिकेशन, Chat API को कॉल करके इंपोर्ट किए गए चैट संसाधन में बदलाव कर सकते हैं. ऐसा तब होता है, जब इंपोर्ट करने के दौरान ओरिजनल इकाई में बदलाव किए गए हों. उदाहरण के लिए, अगर कोई उपयोगकर्ता सोर्स मैसेजिंग प्लैटफ़ॉर्म में किसी मैसेज में बदलाव करता है, तो Chat ऐप्लिकेशन उस मैसेज को अपडेट कर सकते हैं. इससे, मैसेज में मूल मैसेज का मौजूदा कॉन्टेंट दिखेगा.

मैसेज

इंपोर्ट मोड वाले स्पेस में किसी मैसेज के लिए, साथ काम करने वाले फ़ील्ड अपडेट करने के लिए, Message रिसॉर्स पर update तरीके को कॉल करें. Chat ऐप्लिकेशन, इस तरीके को सिर्फ़ उसी अथॉरिटी का इस्तेमाल करके कॉल कर सकते हैं जिसका इस्तेमाल शुरुआती मैसेज बनाने के दौरान किया गया था. अगर आपने मैसेज बनाते समय, उपयोगकर्ता के तौर पर काम करने की सुविधा का इस्तेमाल किया था, तो आपको उस मैसेज को अपडेट करने के लिए, उसी उपयोगकर्ता के तौर पर काम करना होगा.

इंपोर्ट मोड वाले स्पेस में मौजूद किसी मैसेज को मिटाने के लिए, Message रिसॉर्स पर delete तरीके को कॉल करें. इंपोर्ट मोड वाले स्पेस में मौजूद मैसेज को मिटाने के लिए, मैसेज बनाने वाले व्यक्ति की ज़रूरत नहीं होती. डोमेन में मौजूद किसी भी उपयोगकर्ता के तौर पर काम करके, मैसेज मिटाया जा सकता है. Chat ऐप्लिकेशन, सिर्फ़ अपने मैसेज मिटा सकते हैं. इसके लिए, उन्हें अपनी अनुमति का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

प्रतिक्रियाएं

इंपोर्ट मोड वाले स्पेस में किसी मैसेज पर दी गई प्रतिक्रिया को मिटाने के लिए, reactions रिसॉर्स पर delete तरीके का इस्तेमाल करें. इंपोर्ट मोड वाले स्पेस में, संसाधन के तरीकों और पुष्टि करने के तरीकों के बारे में जानने के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

अटैचमेंट

इंपोर्ट मोड स्पेस में किसी मैसेज के अटैचमेंट अपडेट करने के लिए, media रिसोर्स पर upload तरीके का इस्तेमाल करें. इंपोर्ट मोड वाले स्पेस में, संसाधन के तरीकों और पुष्टि करने के टाइप के बारे में जानने के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें.

पुरानी सदस्यताएं

इंपोर्ट मोड वाले स्पेस में, सदस्यता का पुराना डेटा मिटाने के लिए, Membership संसाधन पर delete तरीके का इस्तेमाल करें. स्पेस के इंपोर्ट मोड से बाहर निकलने के बाद, delete तरीके से पुरानी सदस्यताओं को मिटाने की सुविधा नहीं मिलती.

इंपोर्ट मोड वाले स्पेस में, पुरानी सदस्यता को अपडेट नहीं किया जा सकता. अगर आपको सदस्यता के इतिहास की गलत तरीके से इंपोर्ट की गई जानकारी को ठीक करना है, तो आपको पहले उसे मिटाना होगा. इसके बाद, स्पेस के इंपोर्ट मोड में रहते हुए उसे फिर से बनाना होगा.

Spaces

इंपोर्ट मोड वाले स्पेस में साथ काम करने वाले फ़ील्ड अपडेट करने के लिए, spaces रिसॉर्स पर patch तरीके का इस्तेमाल करें.

इंपोर्ट मोड वाले स्पेस को मिटाने के लिए, spaces रिसॉर्स पर delete तरीके का इस्तेमाल करें.

इंपोर्ट मोड वाले स्पेस में, संसाधन के तरीकों और पुष्टि करने के टाइप के बारे में जानकारी पाने के लिए, Chat ऐप्लिकेशन को अनुमति दें पर जाएं.

पूरा इंपोर्ट मोड

completeImport तरीके को कॉल करने से पहले, आपको यह पक्का करना होगा कि पुष्टि और संसाधन में अंतर का मिलान पूरा हो गया हो. इंपोर्ट मोड से बाहर निकलने की प्रोसेस को पहले जैसा नहीं किया जा सकता. इससे इंपोर्ट मोड वाला स्पेस, सामान्य स्पेस में बदल जाता है. Chat में ऐसा कोई इंडिकेटर नहीं है जो इन स्पेस को डेटा इंपोर्ट से जोड़ता हो.

completeImport को कॉल करने की तारीख और समय, कॉल करने वाले उपयोगकर्ता का संसाधन नाम, और मिले जवाब को नोट करें. अगर आपको कोई समस्या आ रही है और आपको उसकी जांच करनी है, तो यह जानकारी आपके काम आ सकती है.

इंपोर्ट मोड पूरा करने और उपयोगकर्ताओं को स्पेस का ऐक्सेस देने के लिए, Chat ऐप्लिकेशन Space संसाधन पर completeImport तरीके को कॉल कर सकता है. चैट ऐप्लिकेशन, किसी उपयोगकर्ता की ओर से इस तरीके को सिर्फ़ तब कॉल कर सकते हैं, जब वे उपयोगकर्ता के तौर पर काम कर रहे हों. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को अनुमति देना लेख पढ़ें. इस तरीके के पूरा होने के बाद, जिस उपयोगकर्ता के नाम पर कार्रवाई की गई है उसे स्पेस में स्पेस मैनेजर के तौर पर जोड़ दिया जाता है. इस तरीके को, create.space तरीके के शुरुआती कॉल के 90 दिनों के अंदर कॉल किया जाना चाहिए. अगर 90 दिनों की अवधि खत्म होने के बाद, इस तरीके को कॉल करने की कोशिश की जाती है, तो कॉल पूरा नहीं होगा. ऐसा इसलिए, क्योंकि इंपोर्ट मोड वाला स्पेस मिटा दिया जाता है और अब Chat ऐप्लिकेशन के लिए उपलब्ध नहीं होता.

completeImport तरीके में, उपयोगकर्ता के तौर पर काम करने वाले व्यक्ति का स्पेस क्रिएटर होना ज़रूरी नहीं है.

completeImport को importModeExpireTime के बहुत करीब न रखें, क्योंकि हम इस बात की गारंटी नहीं दे सकते कि अनुरोध importModeExpireTime से पहले पहुंच जाएगा. साथ ही, ऐसा हो सकता है कि सिस्टम में डेटा प्रोसेसिंग के दौरान, समयसीमा खत्म होने पर ट्रिगर होने वाले सिस्टम के साथ टकराव हो. हमारा सुझाव है कि completeImport से कम से कम 30 मिनट पहले importModeExpireTime पर कॉल करें.

यहां दिए गए उदाहरण में, इंपोर्ट मोड को पूरा करने का तरीका बताया गया है:

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)

इनकी जगह ये डालें:

इंपोर्ट मोड के बाद स्पेस का ऐक्सेस देना

Chat उपयोगकर्ताओं को हाल ही में इंपोर्ट किए गए स्पेस का ऐक्सेस देने के लिए, Chat ऐप्लिकेशन chat.import स्कोप और उपयोगकर्ता के नाम पर कार्रवाई करने की सुविधा का इस्तेमाल कर सकते हैं. ऐसा, create.space() वाले तरीके से पहली बार कॉल करने के 90 दिनों के अंदर किया जा सकता है. इससे ये काम किए जा सकते हैं:

  • स्पेस में सदस्यों को जोड़ें: Membership रिसॉर्स पर create() तरीके को कॉल करें. हमारा सुझाव है कि स्पेस इंपोर्ट होने के तुरंत बाद, Chat ऐप्लिकेशन Membership संसाधन बनाएं. इससे Chat ऐप्लिकेशन, chat.import स्कोप का इस्तेमाल जारी रख पाएंगे. साथ ही, यह पक्का कर पाएंगे कि इंपोर्ट किए गए सभी सदस्यों के पास स्पेस का ऐक्सेस हो. आपको उन सदस्यों को जोड़ने को प्राथमिकता देनी चाहिए जिन पर Vault में निजी डेटा के रखरखाव की नीति लागू हो सकती है. इससे इंपोर्ट किए गए मैसेज को सुरक्षित रखा जा सकता है. भले ही, वे निजी डेटा के रखरखाव की अवधि से बाहर हों.
  • टारगेट ऑडियंस सेट करना: Space रिसोर्स पर update() तरीके को कॉल करें. टारगेट ऑडियंस बनाने और उन्हें जोड़ने का तरीका जानने के लिए, Google Workspace संगठन के कुछ उपयोगकर्ताओं के लिए, Google Chat स्पेस को खोजने की सुविधा चालू करना लेख पढ़ें.

chat.import स्कोप के साथ इन तरीकों का इस्तेमाल करने के लिए, जिस उपयोगकर्ता के नाम पर अनुरोध किया जा रहा है उसके पास स्पेस मैनेजर की भूमिका होनी चाहिए.

बाहरी स्पेस के लिए, create()सदस्यता लेने के तरीके से भी, Workspace संगठन से बाहर के उपयोगकर्ताओं को न्योता भेजा जा सकता है. पक्का करें कि आपको बाहरी उपयोगकर्ताओं के लिए, ज्ञात सीमाओं के बारे में पता हो.

समस्या का हल

अगर आपको Chat स्पेस इंपोर्ट करते समय कोई समस्या आ रही है, तो मदद पाने के लिए यहां दी गई समस्याएं देखें. अगर आपको गड़बड़ी का कोई जवाब मिलता है, तो उसे नोट कर लें. इसके लिए, टेक्स्ट को किसी दस्तावेज़ में कॉपी/चिपकाएं या स्क्रीनशॉट सेव करें. इससे आपको बाद में समस्या हल करने में मदद मिलेगी.

स्पेस को इंपोर्ट करने की प्रोसेस पूरी होने पर, CompleteImportSpace के बगल में OK का स्टेटस दिखता है.

90 दिनों की विंडो खत्म होने से पहले इंपोर्ट पूरा नहीं किया गया

इंपोर्ट मोड में स्पेस बनाना लेख में पहले ही बताया जा चुका है कि अगर स्पेस को बनाने के लिए create तरीके का इस्तेमाल किया गया है और 90 दिनों के बाद भी वह इंपोर्ट मोड में है, तो उसे अपने-आप मिटा दिया जाता है. इसके बाद, उसे ऐक्सेस नहीं किया जा सकता और न ही वापस लाया जा सकता है.

माफ़ करें, मिटाया गया स्पेस अब उपलब्ध नहीं है. साथ ही, उसे वापस भी नहीं लाया जा सकता. इसलिए, आपको इंपोर्ट करने की प्रोसेस फिर से शुरू करनी होगी.

अगर स्पेस इंपोर्ट नहीं हुआ है, तो हो सकता है कि उसमें इतना डेटा हो कि उसे 90 दिनों की समयावधि में इंपोर्ट न किया जा सके. ऐसा मौजूदा इस्तेमाल की सीमाओं की वजह से हो सकता है. ऐसे में, स्पेस को दो या उससे ज़्यादा छोटे स्पेस में बांटें, ताकि उन्हें संग्रहित किया जा सके. इसके बाद, इंपोर्ट करने की प्रोसेस फिर से शुरू करें.

ऐसे स्पेस ढूंढना जो मौजूद नहीं हैं

अगर आपको नया Chat स्पेस नहीं मिल रहा है, तो CompleteImportSpace से मिले जवाब के लिए, यहां दी गई टेबल देखें. इसमें समस्या के बारे में बताया गया है और उसे हल करने का तरीका भी बताया गया है.

जवाब मिल गया जांच के चरण जानकारी रिज़ॉल्यूशन
CompleteImportSpace एक अपवाद दिखाता है और GetSpace को कॉल करने पर PERMISSION_DENIED मिलता है. अपने रिकॉर्ड देखें कि स्पेस कब बनाया गया था. अगर उसे बनाए हुए 90 दिन से ज़्यादा हो गए हैं, तो वह अपने-आप मिट गया होगा. इसके अलावा, इंपोर्ट किए गए स्पेस का कोई रिकॉर्ड स्पेस मैनेजमेंट टूल या ऑडिट लॉग में नहीं है. इंपोर्ट की प्रोसेस शुरू हुए 90 दिन से ज़्यादा हो गए हैं और स्पेस को माइग्रेट नहीं किया जा सका. नया स्पेस बनाएं और इंपोर्ट करने की प्रोसेस को फिर से शुरू करें.
CompleteImportSpace से OK और कॉलिंग GetSpace से PERMISSION_DENIED मिलता है. स्पेस मैनेज करने वाले टूल में, इंपोर्ट किए गए स्पेस का कोई रिकॉर्ड नहीं है. हालांकि, ऑडिट लॉग में स्पेस को मिटाए गए के तौर पर दिखाया गया है. स्पेस को इंपोर्ट कर लिया गया था, लेकिन बाद में उसे मिटा दिया गया. नया स्पेस बनाएं और इंपोर्ट करने की प्रोसेस को फिर से शुरू करें.