このガイドでは、Google ドライブ API を使用して共有ドライブを作成する、メンバーと権限を管理するなど、共有ドライブの管理に関連するタスクについて説明します。
レスポンスで返すフィールドを指定する場合は、
fields system
parameter
を drives リソースの任意のメソッドで設定します。fields
パラメータを指定しない場合、サーバーはメソッド固有のデフォルトのフィールド セットを返します。たとえば、
list メソッドは、各共有ドライブの kind、id、
および name フィールドのみを返します。詳細については、特定のフィールドを返すをご覧ください。
共有ドライブのフォルダの制限について詳しくは、共有ドライブのフォルダ の制限をご覧ください。
共有ドライブを作成する
共有ドライブを作成するには、create
リソースで
requestIdパラメータを指定してdrivesメソッドを使用します。
requestId パラメータは、共有ドライブのべき等作成の論理的な試行を識別します。リクエストがタイムアウトした場合や、不明なバックエンド
エラーが返された場合は、同じリクエストを繰り返しても重複は作成されません。リクエストの requestId と本文は同じにする必要があります。
次のコードサンプルは、共有ドライブを作成する方法を示しています。
Java
Python
Node.js
PHP
.NET
create メソッドの呼び出しは
べき等です。
前のリクエストで共有ドライブが正常に作成された場合、または再試行によって共有ドライブが正常に作成された場合、メソッドは drives
リソースのインスタンスを返します。長時間経過した場合や、リクエストの本文が変更された場合など、409 エラーが返され、requestId
を破棄する必要があることを示すことがあります。
共有ドライブを取得する
共有ドライブのメタデータを取得するには、
get リソースで driveId パス パラメータを指定して drives メソッドを使用します。ドライブ ID がわからない場合は、
すべての共有ドライブを一覧表示
するには、list メソッドを使用します。
get メソッドは、共有ドライブを drives リソースのインスタンスとして返します。
ドメイン管理者としてリクエストを発行するには、useDomainAdminAccess クエリ パラメータを true
に設定します。詳細については、ドメイン管理者として
共有ドライブを管理するをご覧ください。
共有ドライブを一覧表示する
ユーザーの共有ドライブを一覧表示するには、list
メソッドをdrivesリソースで使用します。このメソッドは、共有ドライブのリストを返します。
次のクエリ パラメータを渡して、共有ドライブのページ分割をカスタマイズするか、共有ドライブをフィルタします。
pageSize: ページごとに返す共有ドライブの最大数。pageToken: 前回のリスト呼び出しから受け取ったページトークン。結果の次のページを取得するには、このトークンを指定します。q: 共有ドライブを検索するためのクエリ文字列。詳細については、 共有ドライブを検索するをご覧ください。useDomainAdminAccess:trueに設定すると、ドメイン管理者としてリクエストを発行し、リクエスト元が管理者であるドメインのすべての共有ドライブを返します。詳細については、ドメイン管理者として共有ドライブを管理する をご覧ください。
共有ドライブを更新する
共有ドライブのメタデータを更新するには、update メソッドを
drives リソースで driveId パス
パラメータを指定して使用します。
このメソッドは、共有ドライブを drives リソースのインスタンスとして返します。
ドメイン管理者としてリクエストを発行するには、useDomainAdminAccess クエリ パラメータを true
に設定します。詳細については、ドメイン管理者として
共有ドライブを管理するをご覧ください。
共有ドライブを非表示にする、再表示する
共有ドライブをデフォルト ビューから非表示にするには、hide メソッドを
drives リソースで driveId パラメータを指定して使用します。
共有ドライブが非表示になると、ドライブは共有ドライブ リソースを hidden=true
としてマークします。非表示の共有ドライブは、ドライブの UI や返されたファイルのリストに表示されません。
共有ドライブをデフォルト ビューに戻すには、unhide リソースで
drives パラメータを指定して driveId メソッドを使用します。
どちらのメソッドも、共有ドライブを drives リソースのインスタンスとして返します。
共有ドライブを削除する
共有ドライブを完全に削除するには、
delete リソースで drives パラメータを指定して driveId メソッドを使用します。
共有ドライブを削除する前に、共有ドライブ内のすべてのコンテンツをゴミ箱に移動するか、削除する必要があります。また、ユーザーは共有ドライブ
フォルダに対する role=organizer 権限を持っている必要があります。詳細については、ファイルとフォルダをゴミ箱に移動する、または削除するをご覧ください。
次のクエリ パラメータを渡して、共有ドライブをフィルタします。
useDomainAdminAccess:trueに設定すると、ドメイン管理者としてリクエストを発行し、リクエスト元が管理者であるドメインのすべての共有ドライブを返します。詳細については、ドメイン管理者として共有ドライブを管理する をご覧ください。allowItemDeletion:trueに設定すると、共有ドライブ内のアイテムが削除されます。useDomainAdminAccessもtrueに設定されている場合にのみサポートされます。
共有ドライブのメンバーを追加または削除する
permissions リソースを使用して、共有ドライブのメンバーを追加または削除します。
メンバーを追加するには、共有ドライブに対する権限を作成します。権限メソッドは、共有ドライブ内の個々のファイルでも使用できます。これにより、メンバーに追加の権限を付与したり、メンバー以外のユーザーが特定のアイテムで共同作業を行えるようにしたりできます。
詳細とサンプルコードについては、ファイル、フォルダ、ドライブを共有するをご覧ください。
ドメイン管理者として共有ドライブを管理する
drives リソースと permissions
リソースで useDomainAdminAccess パラメータを適用して、組織全体の共有ドライブを管理します。
これらのメソッドをuseDomainAdminAccess=trueを指定して呼び出すユーザーには、
Drive and Docs 管理者
権限が必要です。
管理者は、特定の共有ドライブのメンバーシップに関係なく、組織が所有する共有ドライブを検索したり、共有ドライブの権限を更新したりできます。
サービス アカウントを使用する場合は、サービス アカウントの権限借用を使用して、認証済みの 管理者の権限を借用する必要がある場合があります。ユーザー アカウントとは異なり、サービス アカウントは Google Workspace ドメインに属していません。 ドキュメントやイベントなどの Google Workspace アセットを Google Workspace ドメイン全体で共有しても、サービス アカウントとは共有されません。詳しくは、サービス アカウント の概要をご覧ください。
オーガナイザーがいない共有ドライブを復元する
次のコードサンプルは、オーガナイザーがいなくなった共有ドライブを復元する方法を示しています。
Java
Python
Node.js
PHP
.NET
他のユーザーがファイルをダウンロード、印刷、コピーできないようにする
共有ドライブ内のファイルのダウンロード、印刷、コピーの方法を制限できます。
ユーザーが共有ドライブのオーガナイザーが適用したダウンロード制限を変更できるかどうかを確認するには、capabilities.canChangeDownloadRestrictionブール値フィールドを確認します。capabilities.canChangeDownloadRestriction が true
に設定されている場合は、共有ドライブにダウンロード制限を適用できます。詳細については、
ファイルの機能についてをご覧ください。
drives リソースには、共有ドライブでアクションを実行できるかどうかを示す
ブール値の restrictions
フィールドのコレクションが含まれています。
制限は、共有ドライブまたは共有ドライブ内のアイテムに適用されます。
制限は、drives.update メソッドを使用して設定できます。
共有ドライブにダウンロード制限を適用するには、共有ドライブの管理者が
restrictions.downloadRestrictionオブジェクトを使用してdrives
リソースの
DownloadRestrictionフィールドを設定します。
restrictedForReaders
ブール値フィールドを true に設定すると、閲覧者のダウンロードとコピーの両方が制限されます。restrictedForWriters
ブール値フィールドを true に設定すると、書き込み者のダウンロードとコピーの両方が制限されます。restrictedForWriters フィールドが true の場合、閲覧者のダウンロードとコピーも制限されます。同様に、restrictedForWriters を
true に、restrictedForReaders を false に設定することは、restrictedForWriters と
restrictedForReaders の両方を true に設定することと同じです。
下位互換性
DownloadRestriction オブジェクトの導入に伴い、
restrictions.copyRequiresWriterPermission
ブール値フィールドの機能が更新されました。
`restrictions.copyRequiresWriterPermission` を `true` に設定すると、DownloadRestriction オブジェクトの restrictedForReaders ブール値フィールドが `true` に更新され、閲覧者のダウンロードとコピーの両方が制限されることを宣言します。
copyRequiresWriterPermission フィールドを false に設定すると、restrictedForWriters
フィールドと restrictedForReaders フィールドの両方が false
に更新されます。つまり、すべてのユーザーのダウンロードまたはコピーの制限設定が削除されます。
ダウンロード、印刷、コピー機能を制御するフィールド
次の表に、ダウンロード、印刷、コピー機能に影響する drives リソース フィールド
を示します。
| フィールド | 説明 | バージョン |
|---|---|---|
capabilities.canCopy |
現在のユーザーが共有ドライブ内のファイルをコピーできるかどうか。 | v2、v3 |
capabilities.canDownload |
現在のユーザーが共有ドライブ内のファイルをダウンロードできるかどうか。 | v2、v3 |
capabilities.canChangeCopyRequiresWriterPermission |
現在のユーザーが共有ドライブの copyRequiresWriterPermission 制限を変更できるかどうか。 |
v2、v3 |
capabilities.canResetDriveRestrictions |
現在のユーザーが共有ドライブの制限をデフォルトにリセットできるかどうか。 | v2、v3 |
capabilities.canChangeDownloadRestriction |
現在のユーザーが共有ドライブのダウンロード制限を変更できるかどうか。 | v3 のみ |
restrictions.copyRequiresWriterPermission |
共有ドライブ内のファイルをコピー、印刷、ダウンロードするオプションが、閲覧者と閲覧者(コメント可)に対して無効になっているかどうか。true の場合、この共有ドライブ内のすべてのファイルに対して、同様の名前のフィールドが true に設定されます。 |
v2、v3 |
restrictions.downloadRestriction |
共有ドライブの管理者が適用するダウンロード制限。 | v3 のみ |
フォルダの制限
共有ドライブのフォルダには、保存容量の上限が設定されています。詳細については、Google ドライブでの 共有ドライブの制限 をご覧ください。
アイテム数の上限
各ユーザーの共有ドライブには、ファイル、フォルダ、ショートカットを含め、50 万個のアイテムの上限があります。
上限に達すると、共有ドライブにアイテムを追加できなくなります。ファイルの受信を再開するには、共有ドライブからアイテムを完全に削除する必要があります。ゴミ箱内のアイテムは上限にカウントされますが、完全に削除されたアイテムはカウントされません。詳細については、ファイルとフォルダをゴミ箱に移動する、または削除する をご覧ください。
フォルダの深さの上限
共有ドライブ内のフォルダにネストできるフォルダは 100 レベルまでです。 つまり、子フォルダを 99 レベルを超えるフォルダに保存することはできません。この制限は、子フォルダにのみ適用されます。
100 レベルを超えるフォルダを追加しようとすると、
teamDriveHierarchyTooDeep
HTTP ステータスコードのレスポンスが返されます。