Google Drive モジュール

Adobe Workfront Fusion Google Drive モジュールを使用すると、Google Drive 内のファイル、フォルダー、または共有ドライブを監視、検索、作成、更新、削除、管理できます。

Adobe Workfront Fusion のシナリオでは、Google Drive アカウントを複数のサードパーティのアプリケーションとサービスに接続できます。

シナリオの作成手順について詳しくは、 Adobe Workfront Fusion のシナリオの作成を参照してください。

モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

Google Drive API に関する情報

Google ドライブコネクタは以下を使用します。

ベース URL
https://www.googleapis.com/drive/v3
API バージョン
v3
API タグ
v4.1.22

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 におけるモジュール間の情報のマッピングを参照してください。

トリガー

フォルダー内のファイルを監視

指定されたフォルダーにファイルが追加または変更されると、ファイルの詳細を取得します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続を参照してください。
Select the folder to be watched
ファイルを監視したいドライブ上のフォルダーを選択します。
What files to watch

監視するファイルの種類を選択します。

  • All
  • Google Documents
  • Google Spreadsheets
  • Google Slides
  • Google Drawings
Convert Google Documents files to format
Google Documents の変換先のファイル形式を選択します。
Convert Google Spreadsheets files to format
Google Spreadsheets の変換先のファイル形式を選択します。
Convert Google Slides files to format
Google Slides の変換先のファイル形式を選択します。
Convert Google Drawings files to format
Google Drawings の変換先のファイル形式を選択します。
Watch
新規ファイルとすべての変更を監視するか、新規ファイルのみを監視するかを選択します。
Maximum number of downloaded files
1 回のサイクル中に Workfront Fusion がダウンロードする結果の最大数(シナリオ実行あたりの繰り返し数)を設定します。

すべてのファイルの監視

Google Drive 内のファイルが追加または変更されたときに、ファイルの詳細を取得します。

Connection
Google Drive アカウントを Workfront Fusion に接続する手順については、Workfront Fusion への Google Drive の接続 を参照してください。
What files to watch

監視するファイルの種類を選択します。

  • All
  • Google Documents
  • Google Spreadsheets
  • Google Slides
  • Google Drawings
Convert Google Documents files to format
Google Documents の変換先のファイル形式を選択します。
Convert Google Spreadsheets files to format
Google Spreadsheets の変換先のファイル形式を選択します。
Convert Google Slides files to format
Google Slides の変換先のファイル形式を選択します。
Convert Google Drawings files to format
Google Drawings の変換先のファイル形式を選択します。
Watch
新規ファイルとすべての変更を監視するか、新規ファイルのみを監視するかを選択します。
Maximum number of downloaded files
1 回のサイクル中に Workfront Fusion がダウンロードする結果の最大数(シナリオ実行あたりの繰り返し回数)を設定します。

共有ファイルの監視

新規ファイルが共有されたときや、既存の共有ファイルが更新されたときにトリガーされます。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続を参照してください。
Select the folder to be watched
監視するファイルが含まれている共有フォルダーを選択します。
What files to watch

監視するファイルの種類を選択します。

  • All
  • Google Documents
  • Google Spreadsheets
  • Google Slides
  • Google Drawings
Convert Google Documents files to format
Google Documents の変換先のファイル形式を選択します。
Convert Google Spreadsheets files to format
Google Spreadsheets の変換先のファイル形式を選択します。
Convert Google Slides files to format
Google Slides の変換先のファイル形式を選択します。
Convert Google Drawings files to format
Google Drawings の変換先のファイル形式を選択します。
Watch
新規ファイルとすべての変更を監視するか、新規ファイルのみを監視するかを選択します。
Maximum number of downloaded files
1 回のサイクル中で Workfront Fusion がダウンロードする結果の最大数(シナリオ実行あたりの繰り返し数)を設定します。

コメントを監視

選択したファイルにコメントが追加または変更されたときにトリガーされます。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続するを参照してください。
File
コメントを監視するファイルを選択します。
Watch
すべての変更を監視するか、新しいコメントのみを監視するかを選択
Maximum number of returned comments
1 回のサイクル中で Workfront Fusion が返すコメントの最大数(シナリオ実行ごとの繰り返し数)を設定します。

アクション

ファイルをアップロード

ファイルを Google Drive にアップロードします。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
Destination

ファイルのアップロード先を選択します。

  • My Drive
  • Shared with Me
Target folder
ファイルをアップロードするフォルダーを選択します。
Source file
以前のモジュールから渡されたファイルを使用するか、ファイルを手動でマッピングするかを選択します。
File name
ファイル名を選択します。このオプションは、「source file」フィールドで「Map」を選択した場合に使用できます。
Data
アップロードするデータファイルを選択します。このオプションは、「source file」フィールドで「Map」を選択した場合に使用できます。
Title
新規ファイルのタイトルを入力します。
Convert a file
このオプションを有効にすると、モジュールはファイルを対応する Google 形式に変換できます。

ファイルを更新

ファイルのメタデータまたはコンテンツを更新します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
Destination

ファイルのアップロード先を選択します。

  • My Drive
  • Shared with Me
Move to a folder
ファイルを別のフォルダーに移動する場合は、ファイルの移動先のフォルダーを選択します。
File ID
更新するファイルの ID をマッピングします。
Title
更新されたファイルのタイトルを入力します。
Change a file content
ファイルのコンテンツを置き換えるかどうかを選択します。
Source file
以前のモジュールから渡されたファイルを使用するか、ファイルを手動でマッピングするかを選択します。このフィールドは、前のフィールドでファイルの内容を変更することを選択した場合に使用できます。
File name
ファイル名を選択します。このオプションは、「source file」フィールドで「Map」を選択した場合に使用できます。
Data
アップロードするデータファイルを選択します。このオプションは、「source file」フィールドで「Map」を選択した場合に使用できます。

ファイルをコピー

ファイルを新しい場所にコピーします。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
Destination

ファイルのアップロード先を選択します。

  • My Drive
  • Shared with Me
Target folder
コピーするファイルが存在するフォルダーを選択します
File ID
更新するファイルの ID をマッピングします。
The name of the copy
新規ファイルのタイトルを入力します。元のファイル名を変更しない場合は、このフィールドを空白のままにしておきます。

ファイルを削除

ファイルまたはフォルダを完全に削除します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
File ID
削除するファイルの ID をマッピングします。

ファイル/フォルダーをごみ箱に移動

ファイルまたはフォルダーをごみ箱に移動します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
File ID
ゴミ箱に移動するファイルの ID をマッピングします。

ファイルを取得

指定された ID を持つファイルを取得します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
Convert Google Documents files to format
Google Documents の変換先のファイル形式を選択します。
Convert Google Spreadsheets files to format
Google Spreadsheets の変換先のファイル形式を選択します。
Convert Google Slides files to format
Google Slides の変換先のファイル形式を選択します。
Convert Google Drawings files to format
Google Drawings の変換先のファイル形式を選択します。
File ID
取得するファイルの ID をマッピングします。

ファイル/フォルダを検索

検索条件に基づいてファイルまたはフォルダーを検索します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
Destination

検索先を選択します。

  • My Drive
  • Shared with Me
List a folder
ファイルまたはフォルダーを検索するフォルダーに移動します。
Retrieve
検索対象を、ファイル、フォルダまたはその両方から選択します。
Search

実行する検索のタイプを選択します。

  • Search within file/folder names

    • Query

      検索するファイル名の一部または完全なファイル名(拡張子を含む)を入力します。

    • Search Options

      完全に一致する用語を検索するか、検索語を含む名前を検索するかを選択します。

  • Fulltext検索

    • Query

      Google Drive で検索する検索語を入力します。

  • カスタム検索クエリを入力

    • Query

      カスタム検索クエリを入力します。詳しくは、この記事のSearch for Filesの節を参照してください。

    • 上記で選択したフォルダをクエリに追加

      親コレクション内のフォルダーを検索します。これにより、上記で選択したフォルダー内にあるすべてのファイルとフォルダーが検索されます。

Maximum number of returned results
Workfront Fusion の 1 回の実行サイクルで返されるファイルまたはフォルダーの最大数を設定します。
Continue the execution of the route even if the module returns no results
モジュールが結果を返さない場合にシナリオが停止しないようにするには、このオプションを有効にします。

フォルダーを作成

指定された場所にフォルダーを作成します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
Destination

ファイルのアップロード先を選択します。

  • My Drive
  • Shared with Me
New folder location
新規フォルダーを作成する場所に移動します。
The name of the new folder
作成するフォルダーの名前を入力します。
Share folder
Shareリンクを使用してこのフォルダーを他のユーザーと共有する場合は、このオプションを選択します。選択しない場合、共有リンクを使用できるのは所有者のみになります。

共有リンクの取得

Google Drive 内のファイルの共有リンクを取得します。

Connection
Google Drive アカウントを Workfront Fusion に接続する方法について詳しくは、Google Drive を Workfront Fusion に接続する を参照してください。
File ID
取得する共有リンクの対象ファイルの ID をマッピングします。

トラブルシューティング

ファイルをアップロードまたは更新できない

ファイルのアップロードまたは更新に失敗する状況はいくつかあります。

  • アップロードされたファイルが大きすぎて、Google Drive プランで許可されている最大ファイルサイズ制限を超えているか、Google Drive のストレージ制限を超えています。ストレージプランをアップグレードするか、Google Drive サービスから既存のファイルを削除することができます。
  • ファイルのアップロード先として選択したフォルダーが存在しません。シナリオが停止するので、ターゲットフォルダーを再度選択する必要があります。

ファイルの検索

フォルダーの「ファイルのリスト」モジュールでは、次の要素で構成される独自のクエリを使用できます。

  • フィールド - 検索するファイルの属性(例:ファイルの name 属性)。

  • 演算子 - 照合するためにデータに対して実行されるテスト(例:contains)。

  • - テストされる属性の内容(例:ファイル名 My cool document

接続詞「and」または「or」で句を結合したり、「not」でクエリを否定したりできます。

フィールド

フィールド
値のタイプ
演算子
説明
title
文字列
contains1=!=
ファイルの名前
fullText
文字列
contains2、3
ファイルのテキスト全体(名前、説明、内容、インデックス付け可能なテキストなどを含む)。
mimeType
文字列
contains=!=
ファイルの MIME タイプ
modifiedDate
日付4
<=<=!=>>=
ファイルが最後に変更された日付。
lastViewedByMeDate
date4
<=, <, =, !=, >, >=
ユーザーが最後にファイルを表示した日付。
trashed
ブール値
=, !=
ファイルがごみ箱に入っているかどうか。
starred
ブール値
=, !=
ファイルがスター付きかどうか。
parents
コレクション
in
parentsコレクションに指定した ID が含まれているかどうか。
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
日付
RFC 3339 形式。デフォルトタイムゾーンは UTC です。例: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 コレクションで ID 1234567 を検索する。これにより、ID が 1234567 のフォルダーの直下にあるすべてのファイルとフォルダーを検索されます。

    '1234567' in parents
    
  • parents コレクションでエイリアス ID appDataFolder を検索する。これにより、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 ドキュメントです。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43