特定の共有ドライブのセットを検索するには、クエリ文字列 q フィールドを使用します。
drives.list でドライブをフィルタします。
検索語句を組み合わせて返すことができます。
クエリ文字列は、次の 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 |
| 複数のメンバーがいる共有ドライブ | memberCount > 1 |
true |
| 「機密」という言葉が付いた共有ドライブ20 人以上のメンバーが含まれていること | name contains 'confidential' and memberCount >= 20 |
true |
| 「機密」という言葉が付いた共有ドライブ組織のすべての共有ドライブのタイトルに含まれる | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| 「機密」という言葉が付いた共有ドライブユーザーがメンバーになっているすべての共有ドライブのタイトル | 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 演算子を左から右に評価します。
したがって、かっこなしで検索すると、次の結果が返されます。
- 主催者が 5 人以上の共有ドライブのみ 2019 年 1 月 1 日
- メンバー数が 20 人を超えるすべての共有ドライブ（以前に作成されたものも含む） 2019 年 1 月 1 日