共有ドライブのサポートを実装する

共有ドライブは、異なる組織、共有、所有権に従う マイドライブから抽出できます共有ファイルでファイルを作成、管理する場合は、 アプリに共有ドライブのサポートを実装する必要があります。システムの複雑さ 実装はアプリの機能によって異なります。

まず、supportsAllDrives=true クエリ パラメータを 次の処理をアプリが実行したときにリクエストを受け取ることになります。

Drive API v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

supportsAllDrives=true パラメータは、 共有ドライブ上のファイルを処理できるように設計されています。

権限の読み取りや変更、変更の追跡を行うアプリ、または権限の読み取りや変更の必要があるアプリ 複数のコーパスにまたがる検索には、追加の共有ドライブ機能が必要です。 このドキュメントの残りの部分では、実行に必要な追加の変更について説明します。 できます。

共有ドライブのコンテンツを検索する

files.list メソッドを使用して、 できます。このセクションでは、Google Chat で files.list メソッドを使用します。共有ドライブを検索するには、 ファイルやフォルダを検索する

files.list メソッドには、次の共有ファイルが含まれます。 ドライブ固有のフィールドとクエリモード:

  • driveId - 検索する共有ドライブの ID。
  • includeItemsFromAllDrives - 共有ドライブのアイテムを含めるかどうか 表示されます。存在しないか false に設定されている場合、共有ドライブ内のアイテム 返されることはありません。

  • corpora — アイテムの本文(ファイル/ドキュメント) クエリが適用されますサポートされている本文は userdomaindriveallDrives。 効率を高めるために、allDrives よりも user または drive を優先します。

  • supportsAllDrives - リクエスト元のアプリがサポートしているかどうか マイドライブと共有ドライブの両方です。false の場合、共有ドライブのアイテムは 含まれるようになります。

次のクエリモードは、共有ドライブに固有のものです。

includeItemsFromAllDrives corpora クエリの説明
true user ユーザーがアクセスしたファイル(共有ドライブとマイドライブの両方のファイルを含む)に対してクエリを実行する。
true drive 指定した共有ドライブ内のすべてのアイテムをクエリします。リクエストでは driveId を指定する必要があります。
true allDrives ユーザーがアクセスしたファイルと、ユーザーが属しているすべての共有ドライブに対してクエリを実行します。レスポンスに incompleteSearch : true が含まれている場合があります。これは、このリクエストで検索されなかったコーパスがあることを示します。
true domain ドメイン内で共有されているファイル(共有ドライブとマイドライブの両方のファイルを含む)に対してクエリを実行します。

共有ドライブの変更を確認する

changes.list メソッドを使用して変更を追跡する 作成することもできます。このセクションでは、Google Chat で changes.list メソッドを使用します。詳細については、このモジュールの ユーザーと共有ドライブの変更を追跡するchanges.list メソッドには、次の共有ファイルが含まれます。 ドライブ固有のフィールドとクエリモード:

  • driveId - 変更を返す共有ドライブ。条件 指定された場合、変更 ID は共有ドライブ内の変更を参照します。 ユーザーに提示されたファイルに対する変更を反映します。特定の共有ドライブを参照する 共有ドライブ ID と変更 ID の両方を識別子として使用する必要があります。
  • supportsAllDrives - リクエスト元のアプリが共有をサポートするかどうか できます。false の場合、共有ドライブのアイテム(共有ドライブと ファイルは返却されません。
  • includeItemsFromAllDrives - 共有ドライブのファイルまたは変更の権限 変更のリストに含められます

次のクエリモードは、共有ドライブに固有のものです。

includeItemsFromAllDrives driveId クエリの説明
true いいえ 変更には、ユーザーがアクセスした共有ドライブ内外のファイルに対する変更と、ユーザーがメンバーになっている共有ドライブに対する変更が反映されます。
true 指定した共有ドライブとその共有ドライブ内のアイテムに対する変更が反映されます。

変更ログの動作について詳しくは、このモジュールの 変更履歴

ドライブの UI で共有ドライブのサポートを有効にする

ドライブの UI を使用して共有ドライブのコンテンツにアクセスするには、 "共有ドライブのサポート"の Google API Console: 詳しくは ドライブ UI の統合を構成する

共有ドライブでのファイル選択ツールの使用

ファイル選択ツールでは、共有ドライブ内のアイテムを選択できます。 共有ドライブのサポートの有効化と共有ドライブ ビューの追加に関する詳細 Google Picker API をご覧ください。

次のステップ

共有ドライブの管理に進む 共有ドライブの作成と共有ドライブの権限の管理に関するヘルプ。