共有ドライブ API と My Drive API の違い

共有ドライブは、異なる組織、共有、所有権に従う マイドライブから新しいモデルを作成できます。そのため、マイドライブの一部の操作は、 作成、変更、削除できます。このドキュメントでは、共有ドライブ固有の概要について説明します。 API の違い。

Files リソース

次のフィールドは、共有ドライブ内にあるファイルに対してのみ入力されます。

  • hasAugmentedPermissions - 任意のユーザーにファイルへのアクセス権を付与するかどうか 直接アップロードできます。
  • capabilities/canAddFolderFromAnotherDrive - 現在のユーザー 別のドライブ（別の共有ドライブまたはマイドライブ）からフォルダを このフォルダに移動します。
  • capabilities/canDeleteChildren - 現在のユーザーが削除できるかどうか 作成されます。
  • capabilities/canMoveChildrenOutOfDrive - 現在のユーザー はこのフォルダの子を共有ドライブ外に移動できます。
  • capabilities/canMoveChildrenWithinDrive - 現在のユーザー は、共有ドライブ内でこのフォルダの子を移動できます。
  • capabilities/canMoveItemWithinDrive - 現在のユーザーが以下の操作を許可するかどうか この共有ドライブ アイテムを共有ドライブ内で移動します。
  • capabilities/canReadDrive - 現在のユーザーが読書を終えたかどうか そのファイルが属する共有ドライブへのアクセス権。
  • capabilities/canTrashChildren - 現在のユーザーがゴミ箱に移動できるかどうか 作成されます。
  • driveId - ファイルが含まれる共有ドライブの ID できます。
  • trashingUser - ファイルが明示的にゴミ箱に移動されている場合、 ゴミ箱に移動しました。

  • trashedTime - アイテムがゴミ箱に移動した時刻。

共有ドライブ内にあるファイルの場合、以下の項目には値が入力されません。

  • permissions - 共有ドライブ ACL のサイズが大きくなる可能性があるため、権限 ファイルの一部として返されません。permissions.list メソッドを使用します。 これは、ページ分け、同じタブ内のファイルに対する権限を 共有ドライブ自体または共有ドライブに ファイルを割り当てたりできます
  • owners、ownerNames、ownedByMe - 共有ドライブ内のファイル: 共有ドライブに保持されるファイルです。
  • folderColorRgb - フォルダを個別に色付けできません
  • shared - 共有ドライブ内のすべてのアイテムが共有されます。
  • writersCanShare - 現在のところ、 ロールが必要です。

次のフィールドは、ユーザーにファイル アクセス権が付与されている場合にのみ設定されます アイテムの権限:

  • sharedWithMeDate
  • sharingUser

次のフィールドは、 共有ドライブ:

  • parents.isRoot - このフィールドは、マイドライブのルートフォルダに対してのみ true になります。 共有ドライブの最上位フォルダでは false になります。

  • parents - 親は、親リストに表示されません。 リクエストしているユーザーは共有ドライブのメンバーではなく、アクセス権も付与されていません 渡します。また、最上位フォルダを除き、 ファイルが できます。

  • capabilities/canRemoveChildren - capabilities/canDeleteChildren を使用 または capabilities/canTrashChildren。

Permissions リソース

permissionDetails フィールドは、次のフォルダ内にあるファイルに対してのみ入力されます。 できます。このフィールドは、特定のリソースに適用される 継承されている権限を確認できます。このフィールドは出力専用フィールドで、 共有ドライブのアイテムに対してのみ表示されます。加えて次の点にもご注意ください。

  • organizer と fileOrganizer の 2 つの新しいロールが定義されました。
  • permissions.list でページ分けがサポートされるようになりました。

Changes リソース

次の新しいフィールドが Changes リソースで利用可能になりました。 共有ドライブ:

  • changeType - 変更のタイプ。有効な値は file と drive。
  • driveId - この変更に関連付けられた共有ドライブの ID。
  • drive - 共有ドライブの更新状態。次の場合は表示: changeType さんは drive であり、ユーザーはまだ共有ドライブのメンバーです。

同期が必要なアプリケーションでは、追加の変更が必要になる場合があります 共有ドライブでコンテンツを管理したり、アクティビティを追跡したりできます。詳しくは、 ユーザーと共有ドライブの変更を追跡する。