共有ドライブを検索する

特定の共有ドライブのセットを検索するには、クエリ文字列 q フィールド を drives.list で使用して、1 つ以上の検索語句を組み合わせて返されるドライブをフィルタします。

クエリ文字列には次の 3 つの部分が含まれます。

query_term operator values

ここで

• query_term は、検索するクエリ語句またはフィールドです。

• operator は、クエリ語句の条件を指定します。

• values は、検索結果のフィルタに使用する特定の値です。

共有ドライブのフィルタに使用できるクエリ語句と演算子については、 検索クエリ語句と演算子をご覧ください。

たとえば、次のクエリ文字列は、名前が「Google Drive API resources」の共有ドライブのみを返すように検索をフィルタします。

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

クエリ文字列の例

次の表に、共有ドライブの基本的なクエリ文字列の例を示します。実際のコードは、検索に使用するクライアント ライブラリによって異なります。

クエリが正しく機能するように、ファイル名の特殊文字もエスケープする必要があります。たとえば、ファイル名にアポストロフィ (')とバックスラッシュ（"\"）の両方の文字が含まれている場合は、バックスラッシュを使用してエスケープします（name contains 'quinn\'s paper\\essay'）。

クエリ対象	例	useDomainAdminAccess の設定
2017 年 6 月 1 日以降に作成された共有ドライブ	createdTime > '2017-06-01T12:00:00'	true
デフォルト ビューに表示される共有ドライブ	hidden = false	false
メンバーが 2 人以上の共有ドライブ	memberCount > 1	true
タイトルに「confidential」という単語が含まれ、メンバーが 20 人以上の共有ドライブ	name contains 'confidential' and memberCount >= 20	true
組織のすべての共有ドライブの中で、タイトルに「confidential」という単語が含まれる共有ドライブ	name contains 'confidential' and orgUnitId = 'C03az79cb'	true
ユーザーがメンバーになっているすべての共有ドライブの中で、タイトルに「confidential」という単語が含まれる共有ドライブ	name contains 'confidential'	false
割り当てられたオーガナイザーがない共有ドライブ	organizerCount = 0	true
組織部門 ID が含まれていない共有ドライブ	orgUnitId != 'C03az79cb'	true

かっこを使用して複数の語句をクエリする

かっこを使用して、複数のクエリ語句をグループ化できます。たとえば、特定の日付以降に作成され、オーガナイザーが 5 人以上またはメンバーが 20 人以上の共有ドライブを検索するには、次のクエリを使用します。

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)

この検索では、2019 年 1 月 1 日以降に作成され、オーガナイザーが 5 人以上またはメンバーが 20 人以上のすべての共有ドライブが返されます。

Drive API は and 演算子と or 演算子を左から右に評価するため、かっこを使用しない同じ検索では次の結果が返されます。

• 2019 年 1 月 1 日以降に作成された、オーガナイザーが 5 人以上の共有ドライブのみ。
• 2019 年 1 月 1 日より前に作成されたものも含め、メンバーが 20 人以上のすべての共有ドライブ。

関連トピック

• ファイルとフォルダを検索する
• 検索クエリ語句と演算子