このページは Cloud Translation API によって翻訳されました。

Google ドライブコネクタ

Google ドライブコネクタを使用すると、Integration Connectors で Google ドライブ接続を作成して構成できます。この接続をビジネスアプリケーションで使用して、データを安全に交換し、Google ドライブでオペレーションを実行できます。

サポートされているエンティティとオペレーションの一覧については、サポートされているエンティティとオペレーションをご覧ください。サポートされているコネクタ固有のアクションについては、サポートされているアクションをご覧ください。

Google ドライブコネクタのバージョン

Google ドライブコネクタは次の 2 つのバージョンをサポートしています。

Google Drive v1: このコネクタバージョンを使用して、Google Drive v3 API にアクセスします。
Google Drive v2: このコネクタバージョンを使用して、Google Drive v2 API にアクセスします。

Google ドライブ接続の作成については、Google ドライブコネクタを作成して構成するをご覧ください。

サポートされているエンティティとオペレーション

Google ドライブコネクタは、次のエンティティとオペレーションをサポートしています。

エンティティ	説明	運用
`File`	Google ドライブ内のファイルを表します。	`Get`、`List`、`Create`、`Update`、`Delete`
`Folder`	Google ドライブのフォルダを表します。	`Get`、`List`、`Create`、`Update`、`Delete`
`Permission`	Google ドライブのファイルまたはフォルダの権限を表します。	`Get`、`List`、`Create`、`Update`、`Delete`
`Drive`	Google ドライブ内のドライブを表します。	`Get`、`List`、`Create`、`Update`、`Delete`

Application Integration のユースケースの例については、Application Integration のユースケースの例をご覧ください。

サポートされているアクション

Google ドライブコネクタは、次のアクションをサポートしています。

CopyResource

説明: Google ドライブで指定されたリソースのコピーを作成します。コピーしたファイルの新しい名前を定義し、親フォルダ ID のリストを指定して宛先フォルダを指定できます。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	コピーするリソースの ID。
`NewName`	文字列	はい	コピーしたファイルの新しい名前。
`ParentIDs`	文字列	×	コピーしたファイルの配置先となる親フォルダ ID のカンマ区切りのリスト。指定しない場合、ファイルは元のファイルと同じフォルダにコピーされます。
`IgnoreDefaultVisibility`	ブール値	×	新しく作成されたファイルのデフォルトの公開設定をバイパスするかどうかを決定します。アップロードされたすべてのファイルをデフォルトで表示するようにドメインが構成されている場合、このパラメータを true に設定すると、この特定のリクエストに対してその動作がオーバーライドされます。デフォルト値は false です。
`IncludeLabels`	文字列	×	レスポンスの labelInfo 部分に含めるラベル ID のカンマ区切りのリスト。
`IncludePermissionsForView`	文字列	はい	このフィールドは、レスポンスに含める追加のビュー権限を指定します。サポートされている値が公開されます。
`KeepRevisionForever`	ブール値	×	ファイルの変更履歴を永久に保持するかどうかを示します。この機能は、Google ドライブ内のバイナリコンテンツを含むファイルにのみ適用されます。ファイルごとに最大 200 個のリビジョンを永久に保存できます。上限に達した場合は、新しいリビジョンを追加するために既存のリビジョンを削除する必要があります。デフォルト値は false です。
`OCRLanguage`	文字列	×	このフィールドは、画像ファイルをインポートするときに OCR（光学式文字認識）の言語ヒントを提供します。言語は、ISO 639-1 の 2 文字の言語コード（英語の場合は `en`、ドイツ語の場合は `de` など）で指定します。
`SupportsAllDrives`	ブール値	はい	このパラメータは、マイドライブと共有ドライブの変更を追跡するかどうかを示します。共有ドライブへのアクセスを有効にするには、このパラメータを true に設定します。デフォルト値は false です。

出力パラメータ

パラメータ名	データ型	説明
`CopiedFileID`	文字列	コピーしたファイルの ID。
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で CopyResource アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[CopyResource] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]
      
```

CreateFolder

説明: Google ドライブ内に新しいフォルダを作成します。新しいフォルダの名前を指定し、親フォルダの ID を指定してその場所を指定する必要があります。説明を追加したり、フォルダにスターを付けたりすることもできます。

入力パラメータ

パラメータ名	データ型	必須	説明
`Name`	文字列	はい	フォルダのタイトル。
`Description`	文字列	×	フォルダの説明。
`Starred`	ブール値	×	このパラメータは、フォルダにスターが付いているかどうかを示します。デフォルト値は false です。
`ParentIds`	文字列	はい	新しいフォルダを作成する親フォルダの ID のカンマ区切りのリスト。

出力パラメータ

パラメータ名	データ型	説明
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。
`Id`	文字列	新しいフォルダの ID。

ユースケースの例

次の例は、Application Integration で CreateFolder アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[CreateFolder] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

説明: Google ドライブからファイルまたはフォルダを完全に削除します。このアクションを使用するには、削除するリソースの一意の ID を指定する必要があります。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	削除するリソースの ID。

出力パラメータ

パラメータ名	データ型	説明
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で DeleteResource アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[DeleteResource] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

説明: Google ドライブからファイルをダウンロードします。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	ダウンロードするファイルの ID。
`LocalFile`	文字列	×	ファイルを保存するファイルパスとファイル名。空のままにすると、ファイルはメモリに保存されます。
`Encoding`	文字列	×	ファイルデータのエンコードタイプ。LocalFile が空の場合、ファイルデータは指定されたエンコードで返されます。指定できる値は NONE と BASE64 です。デフォルト値は BASE64 です。
`Overwrite`	ブール値	×	このパラメータは、ダウンロード時にファイルがすでに存在する場合に、そのファイルを上書きするかどうかを決定します。デフォルト値は false です。ファイルを上書きするには、パラメータを TRUE に設定します。
`FileFormat`	文字列	×	ファイルをダウンロードできる形式。ファイルの最大サイズは 10 MB です。元の形式でダウンロードするには、このパラメータを空白のままにします。サポートされている形式は、DOCX、ODT、RTF、HTML、TXT、PDF です。

出力パラメータ

パラメータ名	データ型	説明
`FileData`	文字列	LocalFile が指定されていない場合、指定されたエンコードを使用してファイルデータが返されます。
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で DownloadFile アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[DownloadFile] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

説明: Google ドライブ内の別の場所にファイルまたはフォルダを移動します。移動するリソースの ID と、新しい親フォルダの ID を指定する必要があります。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	移動するリソースの ID。
`ParentIDs`	文字列	はい	親フォルダとして使用する ID のカンマ区切りのリスト。共有ドライブ内のリソースには親フォルダが 1 つだけ必要です。共有ドライブ内でファイルやフォルダを移動できるのは、「ファイル管理者」または「管理者」の役割を持つユーザーのみです。

出力パラメータ

パラメータ名	データ型	説明
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で MoveResource アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[MoveResource] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

説明: Google ドライブのファイルまたはフォルダのメタデータを更新します。名前、説明、MIME タイプ、スター付きかどうかを変更できます。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	更新するリソースの ID。
`Name`	文字列	はい	更新されたファイルの新しい名前。
`Description`	文字列	×	ファイルまたはフォルダの説明。
`MIMEType`	文字列	×	ファイルの MIME タイプ。
`Starred`	文字列	×	このパラメータは、リソースにスターが付いているかどうかを示します。デフォルト値は false です。

出力パラメータ

パラメータ名	データ型	説明
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で UpdateResource アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[UpdateResource] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"Success": "TRUE"}]
      
```

UploadFile

説明: Google ドライブにファイルをアップロードします。ファイルデータとその MIME タイプを指定する必要があります。ファイルを配置する親フォルダと、アップロードするファイルの名前を指定することもできます。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	アップロードするファイルの ID。
`FileData`	文字列	はい	アップロードするファイルデータ。
`MIMEType`	文字列	はい	ファイルの MIME タイプ。
`ParentIDs`	文字列	×	アップロードされたファイルの配置先となる親フォルダ ID のカンマ区切りのリスト。指定しない場合、ファイルはユーザーのマイドライブのルートフォルダにアップロードされます。
`Filename`	文字列	×	アップロードするファイルの名前。

出力パラメータ

パラメータ名	データ型	説明
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で UploadFile アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[UploadFile] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

説明: Google ドライブ内の特定のファイルに対する変更の通知を購読します。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	登録するファイルの ID。
`Token`	文字列	はい	ファイル変更のサブスクライブに使用するトークン。

出力パラメータ

パラメータ名	データ型	説明
`Success`	文字列	このパラメータは、オペレーションが成功したかどうかを示します。

ユースケースの例

次の例は、Application Integration で SubscribeToFileChanges アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[SubscribeToFileChanges] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

説明: Google ドライブで特定のユーザーが行った変更の通知を登録します。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	登録するユーザーの ID。
`Token`	文字列	はい	ユーザーの変更を登録するために使用されるトークン。

ユースケースの例

次の例は、Application Integration で SubscribeToUserChanges アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[SubscribeToUserChanges] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

説明: 以前にモニタリングしていたリソースの通知の受信を停止します。

入力パラメータ

パラメータ名	データ型	必須	説明
`Id`	文字列	はい	モニタリングを停止するリソースの ID。
`Token`	文字列	はい	リソースの監視を停止するために使用されるトークン。

ユースケースの例

次の例は、Application Integration で StopWatchingResources アクションを構成する方法を示しています。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[StopWatchingResources] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Value フィールドに次のような値を入力します。

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

アクションが成功すると、コネクタタスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

システムの上限

Google ドライブコネクタは、ノードごとに 1 秒あたり最大 2QPS のトランザクションを処理することができ、この上限を超えるトランザクションはすべてスロットルされます。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

注: Integration Connectors ノードの数は、使用状況に応じて動的に自動スケーリングされます。ただし、自動スケーリングを待たずに大量の容量を確保する場合は、接続の最小ノード値を調整できます。1 つの接続により多くのトランザクションを処理するには、より多くのノードが必要です。逆に、接続が処理するトランザクションが少ない場合は、必要なノードの数が少なくなります。ノードの値を構成するには、次の手順を行います。

従量課金制をご利用のお客様は、接続の編集ページでノードの最小値と最大値を構成します。
サブスクリプションベースで利用されているお客様は、サポートにお問い合わせください。

ノードが処理できる最大トランザクションは、さまざまな要因によって異なります。そのため、スループットを高めるために最小ノードを調整する前に、バックエンドシステムが必要なトラフィックを処理するために最適に設定されているかどうかを確認することをおすすめします。

次のステップ

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

Google ドライブ コネクタ

Google ドライブ コネクタのバージョン

サポートされているエンティティとオペレーション

サポートされているアクション

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

出力パラメータ

ユースケースの例

入力パラメータ

ユースケースの例

入力パラメータ

ユースケースの例

システムの上限

次のステップ

Google Cloud コミュニティの助けを借りる

Google ドライブコネクタ

Google ドライブコネクタのバージョン