特定の共有ドライブのセットを検索するには、クエリ文字列 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 |
複数のメンバーがいる共有ドライブ | 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 |
括弧を使用した複数の語句をクエリする
かっこを使用すると、複数のクエリ語句をグループ化できます。たとえば、特定の日付以降に作成された共有ドライブで、主催者が 6 人または 20 人を超える共有ドライブを検索するには、次のクエリを使用します。
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
この検索では、2019 年 1 月 1 日以降に作成され、主催者が 6 人以上またはメンバーが 20 人を超えるすべての共有ドライブが返されます。
Drive API は and
演算子と or
演算子を左から右に評価するため、かっこなしで検索すると次の結果が返されます。
- 2019 年 1 月 1 日以降に作成された主催者が 5 人以上の共有ドライブのみ。
- メンバーが 20 人を超えるすべての共有ドライブ(2019 年 1 月 1 日より前に作成されたものも含む)。