این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

داده‌ها را به چت Google وارد کنید

با استفاده از Google Chat API، می‌توانید داده‌ها را از دیگر پلتفرم‌های پیام‌رسانی خود به Google Chat وارد کنید. می‌توانید پیام‌ها، پیوست‌ها، واکنش‌ها، عضویت‌ها و موجودیت‌های فضایی موجود را از دیگر پلتفرم‌های پیام‌رسانی خود به منابع Chat API مربوطه وارد کنید. می توانید این داده ها را با ایجاد فضاهای چت در حالت واردات و وارد کردن داده ها به آن فضاها وارد کنید. پس از اتمام موفقیت آمیز فرآیند، این فضاها به فضاهای چت استاندارد تبدیل می شوند.

در زیر مراحل کامل واردات توضیح داده شده است:

واردات خود را برنامه ریزی کنید
مجوز را برای برنامه چت پیکربندی کنید
ایجاد یک فاصله در حالت واردات
منابع وارداتی
اعتبار سنجی منابع وارداتی
تطبیق تفاوت های منابع وارد شده با داده های منبع
حالت واردات کامل
اجازه دسترسی به فضا پس از حالت واردات
عیب یابی

پیش نیازها

اسکریپت برنامه ها

یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
یک پروژه Google Cloud ایجاد کنید .
Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
یک پروژه Apps Script مستقل ایجاد کنید و سرویس گفتگوی پیشرفته را روشن کنید.
برنامه گپ باید در دامنه‌هایی که برنامه محتوا را در آن وارد می‌کند، اختیارات دامنه‌ای به آن تفویض شود، به مجوز برنامه‌های گپ مراجعه کنید.

پایتون

یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
یک پروژه Google Cloud ایجاد کنید .
Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
پایتون 3.6 یا بالاتر
ابزار مدیریت بسته پیپ
برنامه گپ باید در دامنه‌هایی که برنامه محتوا را در آن وارد می‌کند، اختیارات دامنه‌ای به آن تفویض شود، به مجوز برنامه‌های گپ مراجعه کنید.

واردات خود را برنامه ریزی کنید

بر این اساس برای مقدار داده‌ای که باید وارد شود برنامه‌ریزی کنید، درک کنید که محدودیت‌ها و سهمیه‌های استفاده چگونه می‌توانند بر فرآیند واردات تأثیر بگذارند، و از انواع فضاهای چت پشتیبانی‌شده هنگام وارد کردن به فضای جدید آگاه باشید. اگر سرپرست هستید، وارد کردن داده پیام به Google Chat از سرویس دیگری را بخوانید و مراحل را به دقت دنبال کنید.

محدودیت های استفاده از API را مرور کنید

زمان مورد نیاز برای وارد کردن داده ها به چت بسته به تعداد منابع چت برای وارد کردن می تواند بسیار متفاوت باشد. محدودیت‌های استفاده برنامه گپ و مقدار داده‌های برنامه‌ریزی‌شده برای وارد کردن از پلت فرم پیام‌رسانی مبدأ را مرور کنید تا یک جدول زمانی تخمینی تعیین کنید.

هنگام وارد کردن پیام‌ها به یک فضا، توصیه می‌کنیم که تماس‌ها را به متد messages.create() در رشته‌های پیام مختلف پخش کنید.

فضاهای پشتیبانی شده برای وارد کردن را شناسایی کنید

حالت واردات فقط از SpaceType SPACE و GROUP_CHAT پشتیبانی می کند. از DIRECT_MESSAGE پشتیبانی نمی کند. برای اطلاعات بیشتر به مستندات SpaceType مراجعه کنید.

ایجاد یک فاصله در حالت واردات

برای ایجاد فاصله در حالت import، متد create را در منبع Space فراخوانی کنید و importMode روی true تنظیم کنید.

هنگامی که فضا را در حالت واردات ایجاد می کنید، به موارد زیر توجه کنید.

تاریخ و زمان - به یاد داشته باشید، حالت واردات باید ظرف 90 روز تکمیل شود. اگر پس از 90 روز از زمان فراخوانی متد spaces.create() همچنان در حالت import باشد، به طور خودکار حذف می شود و غیرقابل دسترسی و غیرقابل بازیابی می شود.
- از مقدار فیلد importModeExpireTime برای پیگیری انقضای بازه زمانی 90 روزه استفاده کنید.
- از مقدار فیلد createTime برای پیگیری انقضای بازه زمانی 90 روزه استفاده نکنید. این همیشه مانند زمانی نیست که متد spaces.create() را فراخوانی می کنید. هنگام استفاده از حالت واردات، قسمت createTime را می توان روی مهر زمانی تاریخی که در آن فضا در منبع ایجاد شده است تنظیم کرد تا زمان ایجاد اصلی حفظ شود.
نام منبع فضا ( name ) - شناسه منحصر به فردی که برای بازیابی اطلاعات مربوط به فضای خاص استفاده می شود و در مراحل بعدی هنگام وارد کردن محتوا به فضا به آن ارجاع داده می شود.

برای حفظ زمان ایجاد موجودیت فضایی معادل از پلت فرم پیام منبع، می توانید createTime فضا را تنظیم کنید. این createTime باید روی مقداری بین 1 ژانویه 2000 و زمان حال تنظیم شود.

برای ایجاد فضای خارجی در حالت import، externalUserAllowed را روی true تنظیم کنید. پس از اینکه وارد کردن با موفقیت انجام شد، می توانید کاربران خارجی اضافه کنید.

مثال زیر نحوه ایجاد فاصله در حالت import را نشان می دهد:

اسکریپت برنامه ها

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);
}

پایتون

"""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 : نام فضای ایجاد شده در حالت واردات. این باید یک نام منحصر به فرد برای فضایی باشد که به کاربران چت نمایش داده می شود. توصیه می‌کنیم از همان نام نمایشی فضایی که داده‌ها را از آن وارد می‌کنید استفاده کنید.

منابع وارداتی

برای وارد کردن منابع از دیگر پلتفرم‌های پیام‌رسان، منابع چت Google (مانند پیام‌ها، واکنش‌ها، پیوست‌ها) را در فضای حالت واردات ایجاد می‌کنید. وقتی منبعی را در فضا ایجاد می‌کنید، داده‌هایی را از منبع مرتبط از پلتفرم پیام که از آن مهاجرت می‌کنید مشخص می‌کنید.

پیام ها

برنامه‌های گپ شما می‌توانند پیام‌ها را با استفاده از اختیارات خودشان یا از طرف یک کاربر از طریق جعل هویت وارد کنند. نویسنده پیام روی حساب کاربری جعل شده تنظیم شده است. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید. برای وارد کردن یک پیام در فضای حالت واردات، روش create را در منبع Message فراخوانی کنید. به منظور حفظ زمان ایجاد پیام اصلی از پلت فرم پیام منبع، می‌توانید createTime پیام را تنظیم کنید. این createTime باید روی مقداری بین زمان ایجاد فضایی که قبلاً تنظیم کرده‌اید و زمان فعلی تنظیم شود.

پیام‌های موجود در یک فضا نمی‌توانند حاوی همان createTime باشند، حتی اگر پیام‌های قبلی با آن زمان حذف شوند.

پیام‌های حاوی نشانی‌های وب شخص ثالث در فضاهای حالت واردات نمی‌توانند پیش‌نمایش پیوند را در چت Google ارائه دهند.

وقتی پیام‌ها را در حالت واردات ایجاد می‌کنید، فضاها به هیچ کاربری اطلاع نمی‌دهند یا ایمیل ارسال نمی‌کنند، از جمله پیام‌هایی که حاوی ذکر کاربر هستند.

مثال زیر نحوه ایجاد یک پیام در فضای حالت واردات را نشان می دهد:

پایتون

"""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 API آپلود کند . برای اطلاعات در مورد روش‌های منبع و انواع پشتیبانی احراز هویت در فضاهای حالت واردات، به مجوز برنامه‌های گپ مراجعه کنید. با این حال، ما به شدت توصیه می‌کنیم که از Google Drive API برای آپلود پیوست‌ها به‌عنوان فایل‌های Google Drive استفاده کنید و URI فایل‌ها را به پیام‌های مربوطه در فضاهای حالت واردات پیوند دهید تا پیوست‌ها را از دیگر پلت‌فرم‌های پیام‌رسان وارد کنید تا از محدودیت داخلی Google Chat برای آپلود پیوست جلوگیری کنید.

عضویت های تاریخی

عضویت‌های تاریخی عضویت‌هایی هستند که برای کاربرانی ایجاد شده‌اند که قبلاً موجودیت فضای اصلی را از پلتفرم پیام‌رسانی مبدأ ترک کرده‌اند، اما شما می‌خواهید داده‌های آن‌ها را در Chat حفظ کنید . برای اطلاعات در مورد افزودن اعضای جدید پس از اینکه فضا دیگر در حالت واردات نیست، به ایجاد منبع عضویت مراجعه کنید.

در بسیاری از موارد، زمانی که آن اعضای تاریخی مشمول خط‌مشی حفظ داده در Google هستند، می‌خواهید داده‌ها (مانند پیام‌ها و واکنش‌ها) ایجاد شده توسط عضویت‌های تاریخی را قبل از وارد کردن آنها به گپ در یک فضا حفظ کنید. در حالی که فضا در حالت واردات است، می‌توانید آن عضویت‌های تاریخی را با استفاده از روش create در منبع Membership وارد فضا کنید. برای حفظ زمان مرخصی عضویت تاریخی، باید deleteTime عضویت را تنظیم کنید. این زمان مرخصی باید دقیق باشد زیرا روی داده‌هایی که برای آن عضویت‌ها حفظ شود تأثیر می‌گذارد. علاوه بر این، این deleteTime باید بعد از مهر زمانی ایجاد فضا باشد و نباید مهر زمانی آینده باشد.

علاوه بر deleteTime ، می‌توانید createTime نیز تنظیم کنید تا زمان عضویت اصلی عضویت تاریخی حفظ شود. برخلاف deleteTime ، createTime اختیاری است. اگر تنظیم نشود، createTime به طور خودکار با کم کردن 1 میکروثانیه از deleteTime محاسبه می‌شود. در صورت تنظیم، createTime باید قبل از deleteTime باشد و باید در زمان ایجاد فضا یا بعد از آن باشد. این اطلاعات createTime برای تعیین حفظ داده ها استفاده نمی شود و در ابزارهای سرپرست مانند کنسول Google Admin و Google Vault قابل مشاهده نیست.

در حالی که ممکن است چندین راه وجود داشته باشد که کاربر بتواند به پلتفرم پیام‌رسانی مبدأ بپیوندد و یک فضای خالی بگذارد (از طریق دعوت، پیوستن توسط خود، اضافه شدن توسط کاربر دیگری)، در Chat، این اقدامات همه با فیلدهای عضویت تاریخی createTime و deleteTime نشان داده می‌شوند. به عنوان اضافه یا حذف شده است.

مثال زیر نحوه ایجاد یک عضویت تاریخی در فضای حالت import را نشان می دهد:

پایتون

"""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 بخوانید. برنامه‌های چت فقط می‌توانند این روش را از طرف کاربر از طریق جعل هویت فراخوانی کنند. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید.

برنامه چت شما همچنین می‌تواند با فراخوانی روش get در منبع Message ، پیام‌های جداگانه را برای تأیید اعتبار بخواند. برنامه‌های چت فقط می‌توانند با استفاده از اختیارات خود با این روش تماس بگیرند تا پیام‌های خود را بخوانند. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید.

برنامه‌های گپ همچنین می‌توانند با فراخوانی روش list در منبع Membership ، عضویت‌های تاریخی را فهرست کنند. پس از خروج فضا از حالت واردات، روش list دیگر عضویت های تاریخی را نشان نمی دهد. برنامه‌های چت فقط می‌توانند این روش را از طرف کاربر از طریق جعل هویت فراخوانی کنند. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید.

با فراخوانی متد get در منبع Space می‌توانید ویژگی‌های فضای حالت واردات را بخوانید. پاسخ همچنین دارای importModeExpireTime خواهد بود، بنابراین شما می توانید به درستی بازه زمانی را برای تکمیل فرآیند واردات دنبال کنید. برنامه‌های چت فقط می‌توانند با استفاده از اختیارات خود این روش را فراخوانی کنند. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید.

تطبیق تفاوت های منابع وارد شده با داده های منبع

اگر به دلیل تغییرات در موجودیت اصلی در حین وارد کردن، هر منبع وارد شده دیگر با موجودیت اصلی از پلتفرم پیام‌رسانی منبع مطابقت ندارد، برنامه‌های چت می‌توانند با Chat API تماس بگیرند تا منبع چت وارد شده را تغییر دهند. به عنوان مثال، اگر کاربر پس از ایجاد آن پیام در چت، پیامی را در بستر پیام‌رسانی مبدأ ویرایش کند، برنامه‌های چت می‌توانند پیام وارد شده را به‌روزرسانی کنند تا محتوای فعلی پیام اصلی را منعکس کند.

پیام ها

برای به‌روزرسانی فیلدهای پشتیبانی شده در یک پیام در فضای حالت واردات، روش update را در منبع Message فراخوانی کنید. برنامه‌های چت فقط می‌توانند با استفاده از همان مرجعی که در هنگام ایجاد پیام اولیه استفاده شده بود، این روش را فراخوانی کنند. اگر در طول ایجاد پیام اولیه از جعل هویت کاربر استفاده کرده اید، باید از همان کاربر جعل شده برای به روز رسانی آن پیام استفاده کنید.

برای حذف یک پیام در فضای حالت واردات، روش delete را در منبع Message فراخوانی کنید. پیام‌های موجود در فضای حالت واردات نیازی به حذف توسط سازنده پیام اصلی ندارند و می‌توانند با جعل هویت هر کاربر در دامنه حذف شوند. برنامه‌های چت فقط می‌توانند پیام‌های خود را با استفاده از اختیارات خود حذف کنند. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید.

واکنش ها

برای حذف یک واکنش برای یک پیام در فضای حالت واردات، از روش delete در منبع reactions استفاده کنید. برای اطلاعات در مورد روش‌های منبع و انواع پشتیبانی احراز هویت در فضاهای حالت واردات، به مجوز برنامه‌های گپ مراجعه کنید.

پیوست ها

برای به‌روزرسانی پیوست‌ها برای یک پیام در فضای حالت واردات، از روش upload در منبع media استفاده کنید. برای اطلاعات در مورد روش‌های منبع و انواع پشتیبانی احراز هویت در فضاهای حالت واردات، به مجوز برنامه‌های گپ مراجعه کنید.

عضویت های تاریخی

برای حذف یک عضویت تاریخی در فضای حالت واردات، از روش delete در منبع Membership استفاده کنید. پس از خروج فضا از حالت واردات، روش delete دیگر به شما اجازه نمی‌دهد عضویت‌های تاریخی را حذف کنید.

نمی‌توانید عضویت تاریخی را در فضای حالت واردات به‌روزرسانی کنید. اگر می‌خواهید یک عضویت تاریخی وارد شده اشتباه را تصحیح کنید، باید ابتدا آن را حذف کنید و سپس در حالی که فضا هنوز در حالت واردات است، آن را دوباره ایجاد کنید.

فضاها

برای به روز رسانی فیلدهای پشتیبانی شده در فضای حالت واردات، از روش patch در منبع spaces استفاده کنید.

برای حذف فضای حالت واردات، از روش delete در منبع spaces استفاده کنید.

برای کسب اطلاعات در مورد روش‌های منابع و انواع پشتیبانی احراز هویت در فضاهای حالت واردات، و به مجوز برنامه‌های گپ مراجعه کنید.

حالت واردات کامل

قبل از فراخوانی روش completeImport ، باید اطمینان حاصل کنید که اعتبارسنجی و تطبیق تفاوت‌های منابع تکمیل شده است. خروج از یک فضای خارج از حالت واردات یک فرآیند غیرقابل برگشت است و فضای حالت واردات را به یک فضای معمولی تبدیل می کند. هیچ نشانگری در Chat وجود ندارد که این فضاها را به وارد کردن داده نسبت دهد.

تاریخ و ساعتی را که با completeImport تماس می‌گیرید، نام منبع کاربری که تماس برقرار کرده است و پاسخ برگشتی را یادداشت کنید. اگر باید با هر مشکلی مواجه شوید و باید آنها را بررسی کنید، این می تواند مفید باشد.

برای تکمیل حالت وارد کردن و در دسترس قرار دادن فضا برای کاربران، برنامه Chat می‌تواند روش completeImport را در منبع Space فراخوانی کند. برنامه‌های چت فقط می‌توانند این روش را از طرف کاربر از طریق جعل هویت فراخوانی کنند. برای اطلاعات بیشتر، به مجوز برنامه‌های گپ مراجعه کنید. کاربر جعل هویت پس از تکمیل این روش به عنوان مدیر فضا به فضا اضافه می شود. این متد باید ظرف 90 روز از فراخوانی اولیه متد create.space فراخوانی شود. اگر بعد از سپری شدن مدت 90 روز سعی کنید با این روش تماس بگیرید، تماس با شکست مواجه می شود زیرا فضای حالت واردات حذف شده و دیگر برای برنامه چت قابل دسترسی نیست.

لازم نیست کاربر جعل هویت در روش completeImport خالق فضا باشد.

completeImport خیلی نزدیک به importModeExpireTime صدا نکنید، زیرا نمی‌توانیم تضمین کنیم که درخواست قبل از importModeExpireTime می‌رسد و ممکن است با پردازش داده‌ها در سیستم‌هایی که در زمان انقضا راه‌اندازی می‌شوند تداخل داشته باشند. توصیه می کنیم حداقل 30 دقیقه قبل از importModeExpireTime completeImport تماس بگیرید.

مثال زیر نحوه تکمیل حالت واردات را نشان می دهد:

پایتون

"""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.import و جعل هویت کاربر در عرض 90 روز از فراخوانی اولیه متد create.space() برای انجام کارهای زیر ادامه دهند:

افزودن اعضا به فضا : متد create() را در منبع Membership فراخوانی کنید. توصیه می‌کنیم برنامه‌های چت بلافاصله پس از تکمیل وارد کردن فضا، منابع Membership ایجاد کنند تا برنامه‌های چت بتوانند به استفاده از محدوده chat.import ادامه دهند و اطمینان حاصل کنند که همه اعضای وارد شده به فضا دسترسی دارند. شما باید اضافه کردن اعضایی را که ممکن است مشمول خط‌مشی نگهداری خرک باشند، در اولویت قرار دهید .
تعیین مخاطب هدف : متد update() را در منبع Space فراخوانی کنید. برای آشنایی با نحوه ایجاد و افزودن مخاطبان هدف، به ایجاد فضای گپ Google قابل شناسایی برای کاربران خاص در سازمان Google Workspace مراجعه کنید.

برای استفاده از این روش‌ها با محدوده chat.import ، کاربر جعل هویت باید مدیر فضا باشد.

برای فضاهای خارجی، متد create() عضویت نیز اجازه می دهد تا کاربران خارج از سازمان Workspace خود را دعوت کنید. مطمئن شوید که تمام محدودیت های شناخته شده برای کاربران خارجی را درک کرده اید.

عیب یابی

اگر هنگام وارد کردن فضاهای چت با مشکل مواجه شدید، مسائل زیر را برای راهنمایی بررسی کنید. اگر با پاسخ خطایی مواجه شدید، آن را یادداشت کنید (متن را در یک سند کپی/پیست کنید یا یک اسکرین شات ذخیره کنید) برای مراجعات بعدی و عیب یابی.

وقتی فضایی با موفقیت وارد شد، CompleteImportSpace با وضعیت OK تکمیل می‌شود.

قبل از انقضای پنجره 90 روزه وارد نشد

همانطور که قبلا در Create a space in import mode توضیح داده شد، اگر پس از گذشت 90 روز از زمان فراخوانی روش ایجاد، فضا همچنان در حالت import باشد، به طور خودکار حذف می شود و غیرقابل دسترسی و غیرقابل بازیابی می شود.

متأسفانه فضای حذف شده دیگر در دسترس یا قابل بازیابی نیست و فرآیند واردات باید دوباره آغاز شود.

فضاهای گمشده را پیدا کنید

اگر نمی‌توانید فضای گپ جدید را پیدا کنید، جدول زیر را برای پاسخی که از CompleteImportSpace دریافت کرده‌اید بررسی کنید تا توضیح و نحوه حل آن را ببینید.

پاسخ دریافت شد	مراحل تحقیق	توضیح	قطعنامه
`CompleteImportSpace` یک استثنا ایجاد می کند و با فراخوانی `GetSpace` `PERMISSION_DENIED` برمی گردد.	سوابق خود را بررسی کنید که چه زمانی فضا ایجاد شده است و اگر بیشتر از 90 روز باشد، به طور خودکار حذف شده است. علاوه بر این، هیچ سابقه ای از فضای وارد شده در ابزار مدیریت فضا یا گزارش حسابرسی وجود ندارد.	بیش از 90 روز از شروع فرآیند واردات می گذرد و فضا نتوانست با موفقیت از مهاجرت خارج شود.	یک فضای جدید ایجاد کنید و دوباره فرآیند import را اجرا کنید.
`CompleteImportSpace` `OK` را برمی‌گرداند و تماس گرفتن با `GetSpace` `PERMISSION_DENIED` را برمی‌گرداند.	هیچ سابقه ای از فضای وارد شده در ابزار مدیریت فضا وجود ندارد، اما نشان داده شده است که فضا در گزارش حسابرسی حذف شده است.	فضا با موفقیت وارد شد، اما متعاقبا حذف شد.	یک فضای جدید ایجاد کنید و دوباره فرآیند import را اجرا کنید.

در زیر مراحل کامل واردات توضیح داده شده است:

واردات خود را برنامه ریزی کنید
مجوز را برای برنامه چت پیکربندی کنید
ایجاد یک فاصله در حالت واردات
منابع وارداتی
اعتبار سنجی منابع وارداتی
تطبیق تفاوت های منابع وارد شده با داده های منبع
حالت واردات کامل
اجازه دسترسی به فضا پس از حالت واردات
عیب یابی

پیش نیازها

اسکریپت برنامه ها

یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
یک پروژه Google Cloud ایجاد کنید .
Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
یک پروژه Apps Script مستقل ایجاد کنید و سرویس گفتگوی پیشرفته را روشن کنید.
برنامه گپ باید در دامنه‌هایی که برنامه محتوا را در آن وارد می‌کند، اختیارات دامنه‌ای به آن تفویض شود، به مجوز برنامه‌های گپ مراجعه کنید.

پایتون

یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
یک پروژه Google Cloud ایجاد کنید .
Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
پایتون 3.6 یا بالاتر
ابزار مدیریت بسته پیپ
برنامه گپ باید در دامنه‌هایی که برنامه محتوا را در آن وارد می‌کند، اختیارات دامنه‌ای به آن تفویض شود، به مجوز برنامه‌های گپ مراجعه کنید.

واردات خود را برنامه ریزی کنید

محدودیت های استفاده از API را مرور کنید

فضاهای پشتیبانی شده برای وارد کردن را شناسایی کنید

ایجاد یک فاصله در حالت واردات

برای ایجاد فاصله در حالت import، متد create را در منبع Space فراخوانی کنید و importMode روی true تنظیم کنید.

هنگامی که فضا را در حالت واردات ایجاد می کنید، به موارد زیر توجه کنید.

تاریخ و زمان - به یاد داشته باشید، حالت واردات باید ظرف 90 روز تکمیل شود. اگر پس از 90 روز از زمان فراخوانی متد spaces.create() همچنان در حالت import باشد، به طور خودکار حذف می شود و غیرقابل دسترسی و غیرقابل بازیابی می شود.
- از مقدار فیلد importModeExpireTime برای پیگیری انقضای بازه زمانی 90 روزه استفاده کنید.
- از مقدار فیلد createTime برای پیگیری انقضای بازه زمانی 90 روزه استفاده نکنید. این همیشه مانند زمانی نیست که متد spaces.create() را فراخوانی می کنید. هنگام استفاده از حالت واردات، قسمت createTime را می توان روی مهر زمانی تاریخی که در آن فضا در منبع ایجاد شده است تنظیم کرد تا زمان ایجاد اصلی حفظ شود.
نام منبع فضا ( name ) - شناسه منحصر به فردی که برای بازیابی اطلاعات مربوط به فضای خاص استفاده می شود و در مراحل بعدی هنگام وارد کردن محتوا به فضا به آن ارجاع داده می شود.

مثال زیر نحوه ایجاد فاصله در حالت import را نشان می دهد:

اسکریپت برنامه ها

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);
}

پایتون

"""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 : نام فضای ایجاد شده در حالت واردات. این باید یک نام منحصر به فرد برای فضایی باشد که به کاربران چت نمایش داده می شود. توصیه می‌کنیم از همان نام نمایشی فضایی که داده‌ها را از آن وارد می‌کنید استفاده کنید.

منابع وارداتی

پیام ها

پیام‌های موجود در یک فضا نمی‌توانند حاوی همان createTime باشند، حتی اگر پیام‌های قبلی با آن زمان حذف شوند.

مثال زیر نحوه ایجاد یک پیام در فضای حالت واردات را نشان می دهد:

پایتون

"""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 : نام فضای ایجاد شده در حالت واردات .

واکنش ها

پیوست ها

عضویت های تاریخی

علاوه بر deleteTime ، می‌توانید createTime نیز تنظیم کنید تا زمان عضویت اصلی عضویت تاریخی حفظ شود. برخلاف deleteTime ، createTime اختیاری است. اگر تنظیم نشود، createTime به طور خودکار با کم کردن 1 میکروثانیه از deleteTime محاسبه می‌شود. اگر تنظیم شود، createTime باید قبل از deleteTime باشد و باید در یا بعد از زمان ایجاد فضا باشد. این اطلاعات createTime برای تعیین حفظ داده ها استفاده نمی شود و در ابزارهای سرپرست مانند کنسول Google Admin و Google Vault قابل مشاهده نیست.

مثال زیر نحوه ایجاد یک عضویت تاریخی در فضای حالت import را نشان می دهد:

پایتون

"""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 : شناسه منحصر به فرد کاربر .

واردات منابع در فضای خارجی

اعتبار سنجی منابع وارداتی

تطبیق تفاوت های منابع وارد شده با داده های منبع

پیام ها

واکنش ها

پیوست ها

عضویت های تاریخی

فضاها

برای به روز رسانی فیلدهای پشتیبانی شده در فضای حالت واردات، از روش patch در منبع spaces استفاده کنید.

برای حذف فضای حالت واردات، از روش delete در منبع spaces استفاده کنید.

حالت واردات کامل

قبل از فراخوانی روش completeImport ، باید اطمینان حاصل کنید که اعتبارسنجی و آشتی اختلاف منابع به پایان رسیده است. خروج از فضای خارج از حالت واردات یک فرآیند برگشت ناپذیر است و فضای حالت واردات را به یک فضای منظم تبدیل می کند. هیچ شاخصی در گپ وجود ندارد که این فضاها را به واردات داده نسبت دهد.

به تاریخ و زمانی که با completeImport ، نام منابع کاربر که تماس را برقرار کرده اید ، یادداشت کنید و پاسخ برگشت. اگر باید با هر مشکلی روبرو شوید و باید در مورد آنها تحقیق کنید ، این می تواند مفید باشد.

برای تکمیل حالت واردات و در دسترس بودن فضا برای کاربران ، برنامه گپ می تواند با روش completeImport در منبع Space تماس بگیرد. برنامه های چت فقط می توانند از طریق جعل هویت این روش را به نمایندگی از کاربر فراخوانی کنند. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید. پس از اتمام این روش ، کاربر جعلی به عنوان مدیر فضا به فضا اضافه می شود. این روش باید ظرف 90 روز از زمان اولیه create.space ایجاد شود. اگر پس از گذشت مدت زمان 90 روز ، سعی در تماس با این روش دارید ، تماس منجر به خرابی می شود زیرا فضای حالت واردات حذف شده و دیگر در دسترس برنامه گپ نیست.

کاربر جعلی در روش completeImport نیازی به خالق فضایی ندارد.

با completeImport خیلی نزدیک به importModeExpireTime تماس نگیرید ، زیرا ما نمی توانیم تضمین کنیم که این درخواست قبل از importModeExpireTime وارد خواهد شد ، و می تواند با پردازش داده ها در سیستم های ایجاد شده در زمان منقضی شده باشد. توصیه می کنیم حداقل 30 دقیقه قبل از importModeExpireTime completeImport تماس بگیرید.

مثال زیر نحوه تکمیل حالت واردات را نشان می دهد:

پایتون

"""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 : نام فضای ایجاد شده در حالت واردات .

بعد از حالت واردات به فضا دسترسی پیدا کنید

برای دسترسی کاربران گپ به فضای اخیراً وارد شده ، برنامه های گپ می توانند در طی 90 روز از زمان اولیه create.space() chat.import استفاده کنند.

اعضای را به فضا اضافه کنید : با روش create() در منبع Membership تماس بگیرید. توصیه می کنیم برنامه های چت بلافاصله پس از اتمام واردات فضا ، منابع Membership ایجاد کنند ، به طوری که برنامه های گپ می توانند به استفاده از دامنه chat.import ادامه دهند. شما باید اضافه کردن اعضای اضافه شده که ممکن است مشمول خط مشی Vault Hold باشند ، این امکان را برای حفظ پیام های وارداتی فراهم می کند ، حتی اگر آنها از بازپرداخت خارج باشند.
مخاطب هدف را تنظیم کنید : با روش update() در منبع Space تماس بگیرید. برای یادگیری نحوه ایجاد و افزودن مخاطبان هدف ، به یک فضای چت Google برای کاربران خاص در یک سازمان فضای کاری Google کشف کنید .

برای استفاده از این روش ها با دامنه chat.import ، کاربر جعلی باید یک مدیر فضایی باشد.

برای فضاهای خارجی ، روش عضویت create() همچنین امکان دعوت کاربران خارج از سازمان فضای کاری شما را فراهم می کند. اطمینان حاصل کنید که تمام محدودیت های شناخته شده برای کاربران خارجی را درک کرده اید.

عیب یابی

اگر هنگام وارد کردن فضاهای چت مشکلی را تجربه می کنید ، برای کمک به موارد زیر مرور کنید. اگر با یک پاسخ خطا روبرو شدید ، برای مرجع و عیب یابی در آینده به آن توجه کنید (متن را در یک سند کپی/چسباندن تصویر کنید).

هنگامی که یک فضا با موفقیت وارد می شود ، CompleteImportSpace با وضعیت OK تکمیل می شود.

واردات قبل از انقضا پنجره 90 روزه کامل نشد

همانطور که قبلاً در ایجاد فضایی در حالت واردات توضیح داده شده بود ، اگر فضا پس از 90 روز از زمان فراخوانی روش ایجاد ، هنوز در حالت واردات باشد ، به طور خودکار حذف می شود و غیرقابل دسترسی و غیرقابل دسترسی می شود.

متأسفانه ، فضای حذف شده دیگر در دسترس یا قابل بازیابی نیست و روند واردات باید دوباره آغاز شود.

فضاهای گمشده را پیدا کنید

اگر قادر به یافتن فضای چت جدید نیستید ، جدول زیر را برای پاسخی که از CompleteImportSpace دریافت کرده اید ، برای دیدن توضیحات و نحوه حل آن ، مرور کنید.

پاسخ دریافت کرد	مراحل تحقیق	توضیح	قطعنامه
`CompleteImportSpace` یک استثنا را پرتاب می کند و تماس `GetSpace` اجازه می دهد `PERMISSION_DENIED` .	سوابق خود را بررسی کنید که فضا ایجاد شده است و اگر قدیمی تر از 90 روز باشد ، به طور خودکار حذف شد. علاوه بر این ، هیچ سابقه ای از فضای وارداتی در ابزار مدیریت فضا یا ورود به سیستم حسابرسی وجود ندارد.	بیش از 90 روز از زمان شروع فرآیند واردات می گذرد و فضا نتوانست با موفقیت از مهاجرت خارج شود.	یک فضای جدید ایجاد کرده و روند واردات را دوباره اجرا کنید.
`CompleteImportSpace` `OK` باز می گردد و با `GetSpace` تماس می گیرد `PERMISSION_DENIED` باز می گرداند.	هیچ سابقه ای از فضای وارداتی در ابزار مدیریت فضا وجود ندارد ، اما نشان می دهد که این فضا در پرونده حسابرسی حذف می شود.	این فضا با موفقیت وارد شد ، اما متعاقباً حذف شد.	یک فضای جدید ایجاد کرده و روند واردات را دوباره اجرا کنید.

با استفاده از Google Chat API ، می توانید داده ها را از سایر سیستم عامل های پیام رسانی خود در Google Chat وارد کنید. شما می توانید پیام ها ، پیوست ها ، واکنش ها ، عضویت ها و اشخاص فضایی موجود را از سایر سیستم عامل های پیام رسانی خود به منابع API چت مربوطه وارد کنید. شما می توانید این داده ها را با ایجاد فضاهای چت در حالت واردات و وارد کردن داده ها در آن فضاها وارد کنید. پس از اتمام روند موفقیت آمیز ، این فضاها به فضاهای گپ استاندارد تبدیل می شوند.

موارد زیر روند کامل واردات را تشریح می کند:

واردات خود را برنامه ریزی کنید
مجوز را برای برنامه چت پیکربندی کنید
در حالت واردات فضایی ایجاد کنید
منابع واردات
منابع وارداتی را تأیید کنید
اختلاف منابع وارداتی را از داده های منبع آشتی دهید
حالت واردات کامل
بعد از حالت واردات به فضا دسترسی پیدا کنید
عیب یابی

پیش نیازها

اسکریپت برنامه ها

یک حساب کاربری Google Business یا شرکت Google با دسترسی به Google Chat .
یک پروژه Google Cloud ایجاد کنید .
Google Chat API را با یک نام ، نماد و توضیحات برای برنامه گپ خود فعال و پیکربندی کنید .
یک پروژه اسکریپت برنامه مستقل ایجاد کنید و سرویس چت پیشرفته را روشن کنید.
برنامه گپ باید در هر حوزه ای که برنامه در آن محتوا وارد می کند ، به مقامات گسترده دامنه واگذار شود ، به برنامه های گپ اجازه دهید .

پایتون

یک حساب کاربری Google Business یا شرکت Google با دسترسی به Google Chat .
یک پروژه Google Cloud ایجاد کنید .
Google Chat API را با یک نام ، نماد و توضیحات برای برنامه گپ خود فعال و پیکربندی کنید .
پایتون 3.6 یا بیشتر
ابزار مدیریت بسته PIP
برنامه گپ باید در هر حوزه ای که برنامه در آن محتوا وارد می کند ، به مقامات گسترده دامنه واگذار شود ، به برنامه های گپ اجازه دهید .

واردات خود را برنامه ریزی کنید

بر این اساس برنامه ریزی کنید تا میزان داده های وارداتی داده شود ، درک کنید که چگونه محدودیت های استفاده و سهمیه می تواند بر روند واردات تأثیر بگذارد و از انواع فضاهای چت پشتیبانی شده هنگام واردات به یک فضای جدید آگاه باشد. اگر مدیر هستید ، داده های پیام را از طریق سرویس دیگر به Google Chat وارد کنید و مراحل را با دقت دنبال کنید.

محدودیت های استفاده API را مرور کنید

زمان لازم برای وارد کردن داده ها به چت بسته به مقدار منابع چت برای واردات می تواند بسیار متفاوت باشد. محدودیت های استفاده از برنامه چت خود و میزان داده های برنامه ریزی شده برای واردات از پلت فرم پیام رسانی منبع را برای تعیین جدول زمانی تخمینی مرور کنید.

هنگام وارد کردن پیام ها به یک فضا ، توصیه می کنیم که تماس ها را به messages.create() در موضوعات مختلف پیام.

فضاهای پشتیبانی شده را برای واردات شناسایی کنید

حالت واردات فقط از SpaceType SPACE و GROUP_CHAT پشتیبانی می کند. از DIRECT_MESSAGE پشتیبانی نمی کند. برای اطلاعات بیشتر به اسناد مربوط به SpaceType مراجعه کنید.

در حالت واردات فضایی ایجاد کنید

برای ایجاد فضایی در حالت واردات ، با روش create در منبع Space تماس بگیرید و importMode بر روی true تنظیم کنید.

هنگامی که فضای موجود در حالت واردات را ایجاد می کنید ، موارد زیر را یادداشت کنید.

تاریخ و زمان - به یاد داشته باشید ، حالت واردات باید طی 90 روز تکمیل شود. اگر فضا پس از 90 روز از زمان فراخواندن spaces.create() ، هنوز در حالت واردات باشد.
- برای ردیابی انقضاء بازه زمانی 90 روزه از ارزش قسمت importModeExpireTime استفاده کنید.
- برای ردیابی انقضاء بازه زمانی 90 روزه از مقدار قسمت createTime استفاده نکنید. این همیشه به همان اندازه نیست که وقتی با 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);
}

پایتون

"""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 : نام فضای ایجاد شده در حالت واردات. این باید یک نام منحصر به فرد برای فضایی باشد که برای کاربران گپ نمایش داده می شود. توصیه می کنیم از همان نام نمایشگر به عنوان فضایی که در حال وارد کردن داده ها هستید استفاده کنید.

منابع واردات

برای وارد کردن منابع از سایر سیستم عامل های پیام رسانی ، شما در فضای حالت واردات ، منابع چت Google (مانند پیام ها ، واکنش ها ، پیوست ها) ایجاد می کنید. هنگامی که یک منبع در فضا ایجاد می کنید ، داده های مربوط به منبع مربوطه را از بستر پیام که از آن مهاجرت می کنید ، مشخص می کنید.

پیام ها

برنامه های گپ شما می توانند پیام ها را با استفاده از اقتدار خود یا از طرف کاربر از طریق جعل هویت وارد کنند. نویسنده پیام روی حساب کاربری جعلی تنظیم شده است. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید. برای وارد کردن یک پیام در فضای حالت واردات ، با روش create در منبع Message تماس بگیرید. به منظور حفظ زمان ایجاد پیام اصلی از پلت فرم پیام رسانی منبع ، می توانید createTime پیام را تنظیم کنید. این createTime باید بین زمان ایجاد فضایی که قبلاً تنظیم کرده اید و زمان فعلی را تعیین کنید.

پیام ها در همان فضا نمی توانند شامل همان createTime باشند ، حتی اگر پیام های قبلی با آن زمان حذف شوند.

پیام های حاوی URL های شخص ثالث در فضاهای حالت واردات نمی توانند پیش نمایش های پیوند را در Google Chat ارائه دهند.

هنگامی که پیام ها را در حالت واردات ایجاد می کنید ، Spaces برای هر کاربر ، از جمله پیام هایی که حاوی ذکر شده است ، ایمیل یا ارسال ایمیل نمی کنند.

مثال زیر نحوه ایجاد پیام را در فضای حالت واردات نشان می دهد:

پایتون

"""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 : نام فضای ایجاد شده در حالت واردات .

واکنش ها

برنامه چت شما می تواند با استفاده از API چت واکنش ها را برای پیام ها وارد کند. برای کسب اطلاعات در مورد روش های منابع و انواع پشتیبانی تأیید اعتبار در فضاهای حالت واردات ، به برنامه های چت مجوز مراجعه کنید.

پیوست ها

برنامه چت شما می تواند پیوست ها را با استفاده از API چت بارگذاری کند . برای کسب اطلاعات در مورد روش های منابع و انواع پشتیبانی تأیید اعتبار در فضاهای حالت واردات ، به برنامه های چت مجوز مراجعه کنید. با این حال ، ما به شدت توصیه کردیم که از Google Drive API برای بارگذاری پیوست ها به عنوان فایل های Drive Google استفاده کنید و URI های پرونده را به پیام های مربوطه در فضاهای حالت واردات پیوند دهید تا اتصالات را از سایر سیستم عامل های پیام رسانی وارد کنید تا از ضربات داخلی Google Chat برای بارگذاری پیوست جلوگیری کنید.

عضویت تاریخی

عضویت های تاریخی عضویت هایی است که برای کاربرانی ایجاد شده است که قبلاً نهاد فضایی اصلی را از پلت فرم پیام رسانی منبع خارج کرده بودند ، اما شما می خواهید داده های آنها را در گپ حفظ کنید . برای کسب اطلاعات در مورد اضافه کردن اعضای جدید پس از فضای دیگر در حالت واردات ، به ایجاد منابع عضویت مراجعه کنید.

در بسیاری از موارد ، هنگامی که آن اعضای تاریخی مشمول سیاست حفظ داده در گوگل هستند ، می خواهید داده ها (مانند پیام ها و واکنش ها) ایجاد شده توسط عضویت های تاریخی در یک فضا را قبل از وارد کردن آنها به گپ حفظ کنید. در حالی که فضا در حالت واردات است ، می توانید با استفاده از روش create در منابع Membership ، آن عضویت های تاریخی را به فضا وارد کنید. برای حفظ زمان مرخصی عضویت تاریخی ، باید deleteTime عضویت را تعیین کنید. این زمان مرخصی باید دقیق باشد زیرا تأثیر می گذارد که داده ها برای آن عضویت ها حفظ می شوند. علاوه بر این ، این deleteTime باید بعد از زمان سنجی ایجاد فضا باشد و نباید یک جدول زمانی آینده باشد.

علاوه بر deleteTime ، می توانید createTime برای حفظ زمان اصلی عضویت تاریخی تنظیم کنید. برخلاف deleteTime ، createTime اختیاری است. در صورت عدم استفاده ، createTime به طور خودکار با کم کردن 1 میکرو ثانیه از deleteTime محاسبه می شود. در صورت تنظیم ، createTime باید قبل از deleteTime باشد و باید در زمان ایجاد فضا باشد یا بعد از آن باشد. این اطلاعات createTime برای تعیین حفظ داده ها استفاده نمی شود و در ابزارهای سرپرست مانند کنسول Google Admin و Google Vault قابل مشاهده نیست.

در حالی که ممکن است روش های مختلفی وجود داشته باشد که کاربر بتواند به آن بپیوندد و فضایی را در بستر پیام رسانی منبع (از طریق دعوت ها ، پیوستن به خودشان ، اضافه شدن توسط کاربر دیگر) قرار دهد ، در گپ این اقدامات همه توسط قسمت های تاریخی createTime و deleteTime Fields نشان داده شده است به عنوان اضافه یا حذف شده.

مثال زیر نحوه ایجاد عضویت تاریخی را در فضای حالت واردات نشان می دهد:

پایتون

"""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 : شناسه منحصر به فرد برای کاربر .

وارد کردن منابع در یک فضای خارجی

شما فقط می توانید با استفاده از اعتبارنامه های متعلق به کاربران در سازمان فضای کاری خود ، یک فضای خارجی با حالت واردات ایجاد کنید. این فقط در حالی اعمال می شود که فضا در حالت واردات است. پس از اتمام حالت واردات ، کاربران خارجی می توانند برای پیوستن به فضاهای وارداتی دعوت شوند (به بخش دسترسی مراجعه کنید) و از اعتبار آنها می توان برای تماس با API چت استفاده کرد.

منابع وارداتی را تأیید کنید

برنامه گپ شما می تواند با فراخوانی روش list در منبع Message ، محتوای فضای حالت واردات را بخواند و اعتبار دهد. شما می توانید منابع Reaction و Attachment از هر پیام emojiReactionSummaries و زمینه های attachment پیام های برگشتی بخوانید. برنامه های چت فقط می توانند از طریق جعل هویت این روش را به نمایندگی از کاربر فراخوانی کنند. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید.

برنامه گپ شما همچنین می تواند با تماس با روش get در منبع Message ، پیام های فردی را برای اعتبارسنجی بخوانید. برنامه های چت فقط می توانند با استفاده از اقتدار خود ، این روش را بخوانند تا پیام های خود را بخوانند. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید.

برنامه های گپ همچنین می توانند با فراخوانی روش list در منبع Membership ، عضویت های تاریخی را لیست کنند. پس از خروج فضا از حالت واردات ، روش list دیگر عضویت های تاریخی را در معرض نمایش قرار نمی دهد. برنامه های چت فقط می توانند از طریق جعل هویت این روش را به نمایندگی از کاربر فراخوانی کنند. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید.

با فراخوانی روش get در منبع Space می توانید ویژگی های فضای واردات را بخوانید. این پاسخ همچنین دارای importModeExpireTime پرجمعیت خواهد بود ، بنابراین می توانید بازه زمانی را به درستی ردیابی کنید تا روند واردات را تکمیل کند. برنامه های چت فقط می توانند با استفاده از اقتدار خود این روش را فراخوانی کنند. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید.

اختلاف منابع وارداتی را از داده های منبع آشتی دهید

اگر هر منبع وارداتی دیگر به دلیل تغییر در نهاد اصلی در هنگام واردات ، با موجودیت اصلی از بستر پیام رسانی منبع مطابقت نداشته باشد ، برنامه های گپ می توانند با API چت تماس بگیرند تا منبع چت وارداتی را تغییر دهند. به عنوان مثال ، اگر کاربر پس از ایجاد آن پیام در گپ ، پیام را در بستر پیام رسانی منبع ویرایش کند ، برنامه های گپ می توانند پیام وارداتی را به روز کنند تا محتوای فعلی پیام اصلی را منعکس کند.

پیام ها

برای به روزرسانی فیلدهای پشتیبانی شده در یک پیام در یک فضای واردات ، با روش update در منبع Message تماس بگیرید. برنامه های گپ فقط می توانند با استفاده از همان اقتدار مورد استفاده در زمان ایجاد پیام اولیه ، این روش را فراخوانی کنند. اگر در هنگام ایجاد پیام اولیه از جعل هویت کاربر استفاده کرده اید ، باید از همان کاربر جعلی برای به روزرسانی آن پیام استفاده کنید.

برای حذف یک پیام در فضای حالت واردات ، با روش delete در منبع Message تماس بگیرید. پیام های موجود در یک فضای واردات نیازی به حذف توسط خالق پیام اصلی ندارند و با جعل هویت هر کاربر در دامنه می توان حذف کرد. برنامه های چت فقط می توانند پیام های خود را با استفاده از اقتدار خود حذف کنند. برای اطلاعات بیشتر ، به برنامه های مجوز چت مراجعه کنید.

واکنش ها

برای حذف واکنشی برای یک پیام در فضای حالت واردات ، از روش delete در منبع reactions استفاده کنید. برای کسب اطلاعات در مورد روش های منابع و انواع پشتیبانی تأیید اعتبار در فضاهای حالت واردات ، به برنامه های چت مجوز مراجعه کنید.

پیوست ها

برای به روزرسانی پیوست ها برای یک پیام در یک فضای واردات ، از روش upload در منبع media استفاده کنید. برای کسب اطلاعات در مورد روش های منابع و انواع پشتیبانی تأیید اعتبار در فضاهای حالت واردات ، به برنامه های چت مجوز مراجعه کنید.

عضویت تاریخی

برای حذف عضویت تاریخی در فضای واردات ، از روش delete در منبع Membership استفاده کنید. پس از خروج از حالت واردات ، روش delete به شما امکان نمی دهد عضویت های تاریخی را حذف کنید.

شما نمی توانید عضویت تاریخی را در فضای حالت واردات به روز کنید. اگر می خواهید یک عضویت تاریخی نادرست وارداتی را اصلاح کنید ، ابتدا باید آن را حذف کنید و سپس آن را دوباره ایجاد کنید در حالی که فضای هنوز در حالت واردات است.

فضاها

برای به روزرسانی زمینه های پشتیبانی شده در فضای حالت واردات ، از روش patch در منبع spaces استفاده کنید.

برای حذف فضای حالت واردات ، از روش delete در منبع spaces استفاده کنید.

برای کسب اطلاعات در مورد روش های منابع و انواع پشتیبانی احراز هویت در فضاهای حالت واردات ، و به برنامه های مجوز چت مراجعه کنید.

حالت واردات کامل

کاربر جعلی در روش completeImport نیازی به خالق فضایی ندارد.

مثال زیر نحوه تکمیل حالت واردات را نشان می دهد:

پایتون

"""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 تماس بگیرید. توصیه می کنیم برنامه های چت بلافاصله پس از اتمام واردات فضا ، منابع Membership ایجاد کنند ، به طوری که برنامه های گپ می توانند به استفاده از دامنه chat.import ادامه دهند. شما باید اضافه کردن اعضای اضافه شده که ممکن است مشمول خط مشی Vault Hold باشند ، این امکان را برای حفظ پیام های وارداتی فراهم می کند ، حتی اگر آنها از بازپرداخت خارج باشند.
مخاطب هدف را تنظیم کنید : با روش update() در منبع Space تماس بگیرید. برای یادگیری نحوه ایجاد و افزودن مخاطبان هدف ، به یک فضای چت Google برای کاربران خاص در یک سازمان فضای کاری Google کشف کنید .

برای استفاده از این روش ها با دامنه chat.import ، کاربر جعلی باید یک مدیر فضایی باشد.

عیب یابی

هنگامی که یک فضا با موفقیت وارد می شود ، CompleteImportSpace با وضعیت OK تکمیل می شود.

واردات قبل از انقضا پنجره 90 روزه کامل نشد

متأسفانه ، فضای حذف شده دیگر در دسترس یا قابل بازیابی نیست و روند واردات باید دوباره آغاز شود.

فضاهای گمشده را پیدا کنید

پاسخ دریافت کرد	مراحل تحقیق	توضیح	قطعنامه
`CompleteImportSpace` یک استثنا را پرتاب می کند و تماس `GetSpace` اجازه می دهد `PERMISSION_DENIED` .	سوابق خود را بررسی کنید که فضا ایجاد شده است و اگر قدیمی تر از 90 روز باشد ، به طور خودکار حذف شد. علاوه بر این ، هیچ سابقه ای از فضای وارداتی در ابزار مدیریت فضا یا ورود به سیستم حسابرسی وجود ندارد.	بیش از 90 روز از زمان شروع فرآیند واردات می گذرد و فضا نتوانست با موفقیت از مهاجرت خارج شود.	یک فضای جدید ایجاد کرده و روند واردات را دوباره اجرا کنید.
`CompleteImportSpace` `OK` باز می گردد و با `GetSpace` تماس می گیرد `PERMISSION_DENIED` باز می گرداند.	هیچ سابقه ای از فضای وارداتی در ابزار مدیریت فضا وجود ندارد ، اما نشان می دهد که این فضا در پرونده حسابرسی حذف می شود.	این فضا با موفقیت وارد شد ، اما متعاقباً حذف شد.	یک فضای جدید ایجاد کنید و دوباره روند واردات را اجرا کنید.