Google Drive モジュール
Adobe Workfront Fusion Google Drive モジュールを使用すると、Google Drive 内のファイル、フォルダー、または共有ドライブを監視、検索、作成、更新、削除、管理できます。
Adobe Workfront Fusion のシナリオでは、Google Drive アカウントを複数のサードパーティのアプリケーションとサービスに接続できます。
シナリオの作成手順について詳しくは、 Adobe Workfront Fusion のシナリオの作成を参照してください。
モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
Google Drive API に関する情報
Google ドライブコネクタは以下を使用します。
Google Drive を Workfront Fusion に接続
@gmail.com または @googlemail.com ユーザーの場合は、クライアント ID とクライアントシークレットを取得するために、 Google Cloud Platform に OAuth クライアントを作成する必要があります。
OAuth クライアントを作成(およびクライアント ID とクライアントシークレットを取得)する手順について詳しくは、カスタム OAuth クライアントを使用した Adobe Workfront Fusion と Google Services の接続を参照してください。
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Google Drive モジュールとそのフィールド
Google Drive モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Google Drive フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion におけるモジュール間の情報のマッピングを参照してください。
トリガー
フォルダー内のファイルを監視
指定されたフォルダーにファイルが追加または変更されると、ファイルの詳細を取得します。
すべてのファイルの監視
Google Drive 内のファイルが追加または変更されたときに、ファイルの詳細を取得します。
共有ファイルの監視
新規ファイルが共有されたときや、既存の共有ファイルが更新されたときにトリガーされます。
コメントを監視
選択したファイルにコメントが追加または変更されたときにトリガーされます。
アクション
ファイルをアップロード
ファイルを Google Drive にアップロードします。
ファイルを更新
ファイルのメタデータまたはコンテンツを更新します。
ファイルをコピー
ファイルを新しい場所にコピーします。
ファイルを削除
ファイルまたはフォルダを完全に削除します。
ファイル/フォルダーをごみ箱に移動
ファイルまたはフォルダーをごみ箱に移動します。
ファイルを取得
指定された ID を持つファイルを取得します。
ファイル/フォルダを検索
検索条件に基づいてファイルまたはフォルダーを検索します。
フォルダーを作成
指定された場所にフォルダーを作成します。
共有リンクの取得
Google Drive 内のファイルの共有リンクを取得します。
トラブルシューティング
ファイルをアップロードまたは更新できない
ファイルのアップロードまたは更新に失敗する状況はいくつかあります。
- アップロードされたファイルが大きすぎて、Google Drive プランで許可されている最大ファイルサイズ制限を超えているか、Google Drive のストレージ制限を超えています。ストレージプランをアップグレードするか、Google Drive サービスから既存のファイルを削除することができます。
- ファイルのアップロード先として選択したフォルダーが存在しません。シナリオが停止するので、ターゲットフォルダーを再度選択する必要があります。
ファイルの検索
フォルダーの「ファイルのリスト」モジュールでは、次の要素で構成される独自のクエリを使用できます。
-
フィールド - 検索するファイルの属性(例:ファイルの
name
属性)。 -
演算子 - 照合するためにデータに対して実行されるテスト(例:
contains
)。 -
値 - テストされる属性の内容(例:ファイル名
My cool document
)
接続詞「and
」または「or
」で句を結合したり、「not
」でクエリを否定したりできます。
フィールド
title
contains
1、=
、 !=
fullText
contains
2、3mimeType
contains
、=
、 !=
modifiedDate
<=
、<
、=
、!=
、>
、 >=
lastViewedByMeDate
<=
, <
, =
, !=
, >
, >=
trashed
=
, !=
starred
=
, !=
parents
in
owners
in
writers
in
readers
in
sharedWithMe
=
, !=
properties
has
これらのフィールドの演算子について、次の点を考慮してください。
-
contains
演算子は、title
に対する接頭辞一致検索のみを実行します。例えば、「HelloWorld」というタイトルは、
title contains 'Hello'
に一致しますが、title contains 'World'
には一致しません。 -
contains
演算子は、fullText
文字列トークン全体に対してのみ一致検索を実行します。例えば、ドキュメントの全文に「HelloWorld」という文字列が含まれている場合、クエリ
fullText contains 'HelloWorld'
のみが結果を返します。このシナリオでは、クエリfullText contains 'Hello'
は結果を返しません。 -
contains
演算子は、二重引用符で囲まれた英数字句と完全一致します。例えば、ドキュメントの
fullText
が「Hello there world」という文字列を含む場合、クエリfullText contains '"Hello there"'
は結果を返しますが、クエリはfullText contains '"Hello world"'
は結果を返しません。さらに、検索は英数字なので、ドキュメントの
fullText
に「Hello_world」という文字列が含まれている場合、クエリfullText contains '"Hello world"'
は結果を返します。 -
type
が日付のフィールドは現在、互いに比較することはできず、定数の日付とのみ比較できます。
値のタイプ
\'
でエスケープします、例: 'Valentine\'s Day'
.true
または false
2012-06-04T12:00:00-08:00
演算子
contains
=
!=
<
<=
>
>=
in
and
or
not
has
複合句の場合は、括弧を使用して句をグループ化できます。例:modifiedDate > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/')
この検索では、2012年6月4日(PT)以降に最終変更された画像またはビデオのうち、MIME タイプを持つすべてのファイルが返されます。and
演算子と or
演算子は括弧なしで左から右に評価されるため、上記の例では、画像に関しては、2012年6月4日(PT)以降に変更された画像のみが返されますが、ビデオに関しては、2012年6月4日(PT)より前のビデオも含めすべてのビデオが返されます。
例
このページのすべての例は、エンコードされていない <q>q</q>
パラメーターを示しています。title = 'hello'
は title+%3d+%27hello%27
としてエンコードされています。クライアントライブラリは、このエンコーディングを自動的に処理します。
-
「hello」という名前のファイルを検索する
title = 'hello'
-
フォルダー固有の MIME タイプを使用したフォルダーを検索する
mimeType = 'application/vnd.google-apps.folder'
-
フォルダー以外のファイルを検索する
mimeType != 'application/vnd.google-apps.folder'
-
「hello」と「goodbye」という単語を含む名前のファイルを検索する
title contains 'hello' and name contains 'goodbye'
-
「hello」という語を含まない名前のファイルを検索する
not title contains 'hello'
-
コンテンツ内に「hello」という単語を含むファイルを検索する
fullText contains 'hello'
-
コンテンツ内に「hello」という単語を含まないファイルを検索する
not fullText contains 'hello'
-
コンテンツ内に「hello world」という完全なフレーズを含むファイルを検索する
fullText contains '"hello world"'fullText contains '"hello_world"'
-
クエリに「\」文字を含むファイルを検索する(例:「\authors」)
fullText contains '\\authors'
-
ユーザー
test@example.org
によって書き込み可能なファイルを検索します。'test@example.org' in writers
-
parents
コレクションで ID1234567
を検索する。これにより、ID が1234567
のフォルダーの直下にあるすべてのファイルとフォルダーを検索されます。'1234567' in parents
-
parents
コレクションでエイリアス IDappDataFolder
を検索する。これにより、Application Data フォルダーの直下にあるすべてのファイルとフォルダーが検索されます。'appDataFolder' in parents
-
ユーザー
test@example.org
およびtest2@example.org
によって書き込み可能なファイルを検索します。'test@example.org' in writers and 'test2@example.org' in writers
-
ごみ箱に入っている、「important」というテキストを含むファイルを検索する
fullText contains 'important' and trashed = true
-
2012年6月4日(PT)以降に変更されたファイルを検索する
modifiedDate > '2012-06-04T12:00:00' //デフォルトタイムゾーンは UTC©
modifiedDate > '2012-06-04T12:00:00-08:00'
-
名前に「hello」を含む、認証済みユーザーと共有されているファイルを検索する
sharedWithMe and title contains 'hello'
-
値
8e8aceg2af2ge72e78
を含むadditionalID
という名前のカスタムファイルプロパティを持つファイルを検索するproperties has { key='additionalID' and value='8e8aceg2af2ge72e78' and visibility='PRIVATE' }
このガイドの出典は、Google Drive ドキュメントです。