このページは Cloud Translation API によって翻訳されました。

Google Chat にデータをインポートする

Google Chat API を使って、他のメッセージングプラットフォームからデータをインポートできる直接移動することもできます。既存のメッセージ、添付ファイル、リアクション、他のメッセージングプラットフォームから対応する Chat API のリソース。このデータをインポートするには、インポートモードデータをインポートできます処理が正常に完了したらこれらのスペースは標準の Chat スペースになります。

インポートプロセス全体の概要は次のとおりです。

インポートを計画する
Chat 用アプリの認可を構成する
インポートモードでスペースを作成する
リソースをインポートする
インポートされたリソースを検証する
インポートされたリソースのソースデータとの差異を調整する
完全なインポートモード
インポートモード後にスペースへのアクセス権を付与する
トラブルシューティング

前提条件

Apps Script

Google Workspace アクセス権があるアカウント Google Chat。
公開されている Chat アプリ。独自の Chat アプリについては、クイックスタート。

Python

Python 3.6 以降
pip パッケージ管理ツール
最新の Python 用 Google クライアントライブラリ。インストールまたは更新するにはコマンドラインインターフェースで次のコマンドを実行します。
```
pip3 install --upgrade google-api-python-client google-auth
```
公開されている Chat アプリ。メッセージを作成して公開するには、 Chat アプリについては、 Google Chat アプリを作成します。
Chat 用アプリに認可が構成されました。「 Chat アプリにはドメイン全体の権限を委任する必要がありますアプリがコンテンツをインポートするすべてのドメインについては、以下をご覧ください。 Chat 用アプリを承認します。

インポートを計画する

インポートするデータの量に合わせて計画を立て、使用量上限と割り当てがインポートプロセスを行い、Chat スペースのタイプに注意し、サポートされません。

API の使用量上限を確認する

Chat にデータをインポートするのにかかる時間は、場合によって大きく異なるインポートする Chat リソースの数に応じて異なります。 Chat 用アプリの使用量上限と、スケジュールされているインポートし、タイムラインを見積もる。

スペースにメッセージをインポートする場合は、 messages.create() 宛メソッドを実行します。

インポートできるスペースを特定する

インポートモードでは、SPACE の SpaceType のみがサポートされます。 SpaceType / GROUP_CHAT または DIRECT_MESSAGE。詳しくは、 SpaceType のドキュメントをご覧ください。

インポートモードでスペースを作成する

インポートモードでスペースを作成するには、 create メソッド日付 Space リソース importMode を true に設定します。

インポートモードでスペースを作成する場合は、次の点に注意してください。

日時 - インポートモードは 30 時間以内に完了する必要があります。日かかります。30 日を過ぎてもスペースがインポートモードのままの場合 spaces.create() メソッドが呼び出されてからの日数が経過すると、自動的に削除され、アクセスも復元もできなくなります。
- 使用しないでください。 createTime フィールドを使用して 30 日間の有効期限を追跡できます。これは、これは、spaces.create() メソッドを呼び出す場合と常に同じです。日時インポートモードでは、createTime フィールドを過去のスペースが作成された時点のタイムスタンプを元の作成日時は保持されます。
スペースのリソース名（name） - ドメインに関する情報を取得するために使用されるこれは、後のステップでコンテンツをインポートする際に参照されます。できます。

ソースから同等のスペースエンティティの作成時刻を保持するスペースの createTime を設定できます。この createTime には 2000 年 1 月 1 日から現在までの値を設定する必要があります。

インポートモードで外部スペースを作成するには、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 用アプリを承認します。データソースをインポートするには、インポートモードのスペースでは、 create メソッド日付 Message リソース。ソースからの元のメッセージの作成時刻を保持するためメッセージングプラットフォームでは、メッセージの createTime を設定できます。この createTime は、スペース作成時刻から現在の時刻が表示されます。

たとえ、同じスペース内のメッセージに同じ createTime を含めることはできませんその時刻の以前のメッセージは削除されます。

インポートモードのスペースでサードパーティの 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: 作成するユーザーアカウントのメールアドレスドメイン全体の権限でなりすまします。
SPACE_NAME: インポートモードで作成されたスペースの名前。

リアクション

Chat 用アプリはメッセージのリアクション機能やり取りできますこのリソースのメソッドとインポートモードのスペースでサポートする認証のタイプについては、以下をご覧ください。 Chat 用アプリを承認します。

添付ファイル

Chat 用アプリは添付ファイルのアップロードやり取りできますこのリソースのメソッドとインポートモードのスペースでサポートする認証のタイプについては、以下をご覧ください。 Chat 用アプリを承認します。ただし、「新規顧客の獲得」目標を Google Drive API: 添付ファイルを Google ドライブファイルとしてアップロードし、ファイルの URI をインポートモードのスペースにそれぞれのメッセージを表示し、添付ファイルに関して Google Chat の内部的な上限に達しないようにするメッセージプラットフォーム選択します。

過去のメンバーシップ

過去のメンバーシップは、すでに退会したユーザーのために作成されたメンバーシップです。元のメッセージプラットフォームから元のスペースエンティティが Chat でのデータ保持の方法についてご説明します。スペースのインポートが終了した後に新しいメンバーを追加する方法については、メンバーシップリソースを作成するをご覧ください。

多くの場合、過去のメンバーは Google のデータ保持ポリシーユーザーが作成したデータ（メッセージやリアクションなど）を、 Chat にインポートする前にスペース内の過去のメンバーシップ履歴を確認できます。スペースがインポートモードのときに、過去のメンバーシップをインポートできます。スペースに追加することもできます。 create メソッド日付 Membership リソース。過去のメンバーシップの休暇期間を保持するには、メンバーシップの deleteTime。この休暇時間は正確である必要があります。メンバーシップで保持するデータに影響しますさらに、このdeleteTime スペース作成タイムスタンプより後でなければなりません。また、将来のタイムスタンプは指定できません。

deleteTime に加えて、createTime を設定して、元の結合時刻を返します。deleteTime とは異なり、 createTime は省略可能です。未設定の場合、createTime は次のように自動的に計算されます。 deleteTime から 1 マイクロ秒減算します。設定する場合は、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: 作成するユーザーアカウントのメールアドレスドメイン全体の権限でなりすまします。
SPACE_NAME: インポートモードで作成されたスペースの名前。
USER_ID: 一意の ID user。

外部スペースのリソースをインポートする

インポートモードで外部スペースを作成できるのは、認証情報のみですユーザーに付与します。適用されるのはインポートモードになりますスペースがインポートモードが完了したら、外部ユーザーはインポートされたスペースに参加するよう招待する（アクセスのセクションを参照）その認証情報を使用して Chat API を呼び出すことができます。

インポートされたリソースを検証する

Chat アプリはコンテンツを読み上げて検証できるインポートモードのスペースの次の list メソッド : Message リソース。返されたメッセージの Reaction リソースと Attachment リソースを読み取ることができます。 emojiReactionSummaries フィールドと attachment フィールド。Chat アプリはユーザーの代わりにこのメソッドを呼び出すには、権限を借用する必要があります。詳細情報詳しくは、 Chat 用アプリを承認します。

Chat アプリは、スペースに参加すると、検証を行うために、 get メソッド Message リソースに対する権限。 Chat アプリは、このメソッドを呼び出すことで自身のメッセージを独自の権限で制御できます。詳細については、次をご覧ください: Chat 用アプリを承認します。

また、Chat 用アプリで list メソッド日付 Membership リソース。スペースがインポートモードを終了すると、list メソッドは履歴を公開しません。メンバーシップを失います。Chat アプリは、なりすましによる被害をもたらします。詳細については、次をご覧ください: Chat 用アプリを承認します。

インポートモードのスペースのプロパティを読み取るには、 get メソッド日付 Space リソース。 Chat アプリは、独自の権限でのみこのメソッドを呼び出すことができます。詳細については、次をご覧ください: Chat 用アプリを承認します。

インポートされたリソースのソースデータとの差異を調整する

インポートされたリソースが、ソースの元のエンティティと一致しなくなった場合インポート中に元のエンティティが変更されたため、メッセージングプラットフォームに Chat アプリは Chat API を呼び出して、インポートされた確認しましょう。たとえば、ユーザーが元のメッセージのメッセージを編集し、 Google Chat でメッセージが作成された後に、インポートされたメッセージを Chat アプリで更新して、元のメッセージの現在の内容が表示されます。

メッセージ

更新方法サポートされているフィールドインポートモードのスペースでメッセージに表示するには、 update メソッド日付 Message リソース。 Chat アプリがこのメソッドを呼び出すには、が使用されました。ユーザーのなりすましを使用した場合最初のメッセージの作成時に、同じ権限を借用したユーザーをそのメッセージを更新します。

インポートモードのスペースでメッセージを削除するには、 delete メソッド日付 Message リソース。インポートモードのスペース内のメッセージは、元のドメイン内の任意のユーザーになりすまして削除できます。 Chat アプリは、自身のメッセージのみできます。詳細については、次をご覧ください: Chat 用アプリを承認します。

リアクション

インポートモードのスペースでメッセージに対するリアクションを削除するには、 delete メソッド reactions リソース。このリソースのメソッドとインポートモードのスペースでサポートする認証のタイプについては、以下をご覧ください。 Chat 用アプリを承認します。

添付ファイル

インポートモードのスペースでメッセージの添付ファイルを更新するには、 media の upload メソッドリソースです。リソースのメソッドと認証の種類については、スペースのサポートについては、以下をご覧ください。 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: 作成するユーザーアカウントのメールアドレスドメイン全体の権限でなりすまします。
SPACE_NAME: インポートモードで作成されたスペースの名前。

インポートモード後にスペースにアクセス権を付与する

最近インポートしたスペースに Chat ユーザーがアクセスできるようにするには、次の操作を行います。 Chat アプリでは、引き続き chat.import スコープとユーザーを使用できます権限借用を最初に create.space() メソッド呼び出しから 30 日以内に次のとおりです。

スペースにメンバーを追加する: create() メソッドを呼び出します。 Membership リソース。Chat 用アプリは、スペースのインポートが成功した直後に Membership リソースを作成する移行が完了し、Chat 用アプリで引き続き chat.import スコープを設定し、インポートされたすべてのメンバーが選択します。
対象グループを設定する: update() メソッド Space リソース。対象グループを作成して追加する方法については、以下をご覧ください。組織内の特定のユーザーのみが Google Chat スペースを検索できるようにする Google Workspace の組織。

これらのメソッドを chat.import スコープで使用するには、権限を借用したユーザーができます。

外部スペースの場合、 create() メソッド Workspace 組織外のユーザーを招待することもできます。確認事項理解できたでしょう既知の制限事項できます。

トラブルシューティング

Chat スペースのインポート中に問題が発生した場合は、お問い合わせくださいエラーレスポンスが発生した場合は、メモ（テキストをコピーしてドキュメントに貼り付けるか、スクリーンショットを保存）します。参照してトラブルシューティングできます

スペースが正常にインポートされると、次のメッセージとともに CompleteImportSpace が完了します。ステータスが OK の場合。

30 日間の期限が切れる前にインポートを完了しなかった

前述のインポートモードでスペースを作成するで説明したように、 create メソッドの作成から 30 日が経過してもスペースはインポートモードのまま自動的に削除されてアクセス不能になり、修復不可能です。

残念ながら、削除されたスペースは利用できなくなったり復元したりすることができず、インポートプロセスを再度開始する必要があります。

足りないスペースを探す

新しい Chat スペースが見つからない場合は、 CompleteImportSpace から受け取ったレスポンスを次の表に示します説明と解決方法をご覧ください

回答を受信しました	調査手順	説明	解決策
`CompleteImportSpace` が例外をスローし、 `GetSpace` は `PERMISSION_DENIED` を返します。	スペースが作成された日時とスペースが古いかどうかをレコードで確認します 30 日が経過すると、自動的に削除されます。また、Terraform がインポートされたスペースのスペース管理ツールまたは監査ログをご覧ください。	インポートプロセスを開始してから 30 日以上経過しているスペースは移行を正常に終了できませんでした。	新しいスペースを作成し、インポート処理を再度実行します。
`CompleteImportSpace` は `OK` を返し、次の呼び出しを行います。 `GetSpace` は `PERMISSION_DENIED` を返します。	インポートされたスペースの記録がスペース管理ツールスペースが削除されたことが示されます監査ログをご覧ください。	スペースは正常にインポートされましたが、その後削除されました。	新しいスペースを作成し、インポート処理を再度実行します。

Google Chat にデータをインポートする

前提条件

Apps Script

Python

インポートを計画する

API の使用量上限を確認する

インポートできるスペースを特定する

インポート モードでスペースを作成する

Apps Script

Python

リソースをインポートする

メッセージ

Python

リアクション

添付ファイル

過去のメンバーシップ

Python

外部スペースのリソースをインポートする

インポートされたリソースを検証する

インポートされたリソースのソースデータとの差異を調整する

メッセージ

リアクション

添付ファイル

過去のメンバーシップ

スペース

インポート モードを完了

Python

インポート モード後にスペースにアクセス権を付与する

トラブルシューティング

30 日間の期限が切れる前にインポートを完了しなかった

足りないスペースを探す

インポートモードでスペースを作成する

インポートモードを完了

インポートモード後にスペースにアクセス権を付与する