Google ドライブは、ユーザーがファイルを保存し、デバイス間でファイルを同期し、他のユーザーとファイルを共有できるGoogleのクラウドストレージおよびファイル同期サービスです。Googleの生産性エコシステムの中核コンポーネントとして、Google ドライブは堅牢なストレージ、整理、コラボレーション機能を提供しています。
AptlystarでGoogle ドライブツールを統合して、ワークフローを通じてドライブから情報を簡単に取得する方法を学びましょう。このチュートリアルでは、Google ドライブの接続、データ取得のセットアップ、保存されたドキュメントやファイルを使用して自動化を強化する方法を説明します。エージェントとリアルタイムで重要なデータを同期するのに最適です。
Google ドライブでは、次のことができます：
- クラウドにファイルを保存：インターネットアクセスがあればどこからでもファイルをアップロードしてアクセス可能
- コンテンツを整理：フォルダの作成、カラーコーディングの使用、命名規則の実装
- 共有とコラボレーション：アクセス権限を制御し、ファイルで同時に作業
- 効率的な検索：Googleの強力な検索技術でファイルをすばやく見つける
- 複数デバイスでのアクセス：デスクトップ、モバイル、WebプラットフォームでGoogle ドライブを使用
- 他のサービスとの統合：Google ドキュメント、スプレッドシート、スライド、サードパーティアプリケーションと連携
Aptlystarでは、Google Drive統合により、エージェントがプログラム的にクラウドストレージと直接やり取りすることができます。これにより、ファイル管理、コンテンツ整理、ドキュメントワークフローなどの強力な自動化シナリオが可能になります。エージェントは特定のフォルダに新しいファイルをアップロードしたり、既存のファイルをダウンロードしてその内容を処理したり、フォルダの内容を一覧表示してストレージ構造をナビゲートしたりできます。この統合により、AIワークフローとドキュメント管理システムの間のギャップが埋まり、手動介入なしでシームレスなファイル操作が可能になります。AptlystarとGoogle Driveを接続することで、ファイルベースのワークフローを自動化し、ドキュメントをインテリジェントに管理し、クラウドストレージ操作をエージェントの機能に組み込むことができます。
Google Driveをワークフローに統合します。ファイルの作成、アップロード、一覧表示が可能です。OAuthが必要です。
ファイルをGoogle Driveにアップロードする
| パラメータ | 型 | 必須 | 説明 |
|---|
fileName | string | はい | アップロードするファイルの名前 |
file | file | いいえ | アップロードするバイナリファイル（UserFileオブジェクト） |
content | string | いいえ | アップロードするテキストコンテンツ（fileかこちらのどちらか一方を使用、両方は不可） |
mimeType | string | いいえ | アップロードするファイルのMIMEタイプ（指定がない場合はファイルから自動検出） |
folderSelector | string | いいえ | ファイルをアップロードするフォルダを選択 |
folderId | string | いいえ | ファイルをアップロードするフォルダのID（内部使用） |
| パラメータ | 型 | 説明 |
|---|
file | json | ID、名前、リンクを含むアップロードされたファイルのメタデータ |
Google Driveに新しいフォルダを作成する
| パラメータ | 型 | 必須 | 説明 |
|---|
fileName | string | はい | 作成するフォルダの名前 |
folderSelector | string | いいえ | フォルダを作成する親フォルダを選択 |
folderId | string | いいえ | 親フォルダのID（内部使用） |
| パラメータ | 型 | 説明 |
|---|
file | json | 作成されたフォルダのメタデータ（ID、名前、親情報を含む） |
Google Driveからファイルをダウンロードする（Google Workspaceファイルは自動的にエクスポートされます）
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | ダウンロードするファイルのID |
mimeType | string | いいえ | Google Workspaceファイルをエクスポートする際のMIMEタイプ（オプション） |
fileName | string | いいえ | オプションのファイル名上書き |
| パラメータ | 型 | 説明 |
|---|
file | file | 実行ファイルに保存されたダウンロードファイル |
Google Drive内のファイルとフォルダを一覧表示する
| パラメータ | 型 | 必須 | 説明 |
|---|
folderSelector | string | いいえ | ファイルを一覧表示するフォルダを選択 |
folderId | string | いいえ | ファイルを一覧表示するフォルダのID（内部使用） |
query | string | いいえ | ファイル名でフィルタリングする検索語（例：「budget」は名前に「budget」を含むファイルを検索）。ここではGoogle Driveのクエリ構文を使用しないでください - 単純な検索語を提供してください。 |
pageSize | number | いいえ | 返すファイルの最大数（デフォルト：100） |
pageToken | string | いいえ | ページネーションに使用するページトークン |
| パラメータ | 型 | 説明 |
|---|
files | json | 指定されたフォルダからのファイルメタデータオブジェクトの配列 |
- カテゴリ:
tools
- タイプ:
google_drive
| パラメータ | 型 | 説明 |
|---|
file | file | 実行ファイルに保存されたダウンロード済みファイル |
metadata | object | Google Driveからの完全なファイルメタデータ |
↳ id | string | Google DriveファイルID |
↳ kind | string | リソースタイプ識別子 |
↳ name | string | ファイル名 |
↳ mimeType | string | MIMEタイプ |
↳ description | string | ファイルの説明 |
↳ originalFilename | string | 元のアップロードファイル名 |
↳ fullFileExtension | string | 完全なファイル拡張子 |
↳ fileExtension | string | ファイル拡張子 |
↳ owners | json | ファイル所有者のリスト |
↳ permissions | json | ファイルの権限 |
↳ permissionIds | json | 権限ID |
↳ shared | boolean | ファイルが共有されているかどうか |
↳ ownedByMe | boolean | 現在のユーザーが所有しているかどうか |
↳ writersCanShare | boolean | 編集者が共有できるかどうか |
↳ viewersCanCopyContent | boolean | 閲覧者がコピーできるかどうか |
↳ copyRequiresWriterPermission | boolean | コピーに編集者権限が必要かどうか |
↳ sharingUser | json | ファイルを共有したユーザー |
↳ starred | boolean | ファイルにスターが付いているかどうか |
↳ trashed | boolean | ファイルがゴミ箱にあるかどうか |
↳ explicitlyTrashed | boolean | 明示的にゴミ箱に移動されたかどうか |
↳ appProperties | json | アプリ固有のプロパティ |
↳ createdTime | string | ファイル作成時刻 |
↳ modifiedTime | string | 最終更新時刻 |
↳ modifiedByMeTime | string | 現在のユーザーによる更新時刻 |
↳ viewedByMeTime | string | 現在のユーザーによる最終閲覧時刻 |
↳ sharedWithMeTime | string | 現在のユーザーとの共有時刻 |
↳ lastModifyingUser | json | ファイルを最後に更新したユーザー |
↳ viewedByMe | boolean | 現在のユーザーが閲覧したかどうか |
↳ modifiedByMe | boolean | 現在のユーザーが更新したかどうか |
↳ webViewLink | string | ブラウザで表示するURL |
↳ webContentLink | string | 直接ダウンロードURL |
↳ iconLink | string | ファイルアイコンのURL |
↳ thumbnailLink | string | サムネイルのURL |
↳ exportLinks | json | エクスポート形式のリンク |
↳ size | string | ファイルサイズ（バイト） |
↳ quotaBytesUsed | string | 使用されたストレージ容量 |
↳ md5Checksum | string | MD5ハッシュ |
↳ sha1Checksum | string | SHA-1ハッシュ |
↳ sha256Checksum | string | SHA-256ハッシュ |
↳ parents | json | 親フォルダID |
↳ spaces | json | ファイルを含むスペース |
↳ driveId | string | 共有ドライブID |
↳ capabilities | json | ファイルに対するユーザーの権限 |
↳ version | string | バージョン番号 |
↳ headRevisionId | string | ヘッドリビジョンID |
↳ hasThumbnail | boolean | サムネイルがあるかどうか |
↳ thumbnailVersion | string | サムネイルバージョン |
↳ imageMediaMetadata | json | 画像固有のメタデータ |
↳ videoMediaMetadata | json | 動画固有のメタデータ |
↳ isAppAuthorized | boolean | リクエストしたアプリによって作成されたかどうか |
↳ contentRestrictions | json | コンテンツ制限 |
↳ linkShareMetadata | json | リンク共有メタデータ |
↳ revisions | json | ファイルのリビジョン履歴（最初の100リビジョンのみ） |
Google Driveでファイルのコピーを作成します
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | コピーするファイルのID |
newName | string | いいえ | コピーしたファイルの名前（デフォルトは「Copy of [元の名前]」） |
destinationFolderId | string | いいえ | コピーを配置するフォルダのID（デフォルトは元のファイルと同じ場所） |
| パラメータ | 型 | 説明 |
|---|
file | json | コピーされたファイルのメタデータ |
↳ id | string | コピーのGoogle DriveファイルID |
↳ kind | string | リソースタイプ識別子 |
↳ name | string | ファイル名 |
↳ mimeType | string | MIMEタイプ |
↳ webViewLink | string | ブラウザで表示するURL |
↳ parents | json | 親フォルダID |
↳ createdTime | string | ファイル作成時刻 |
↳ modifiedTime | string | 最終更新時刻 |
↳ owners | json | ファイル所有者のリスト |
↳ size | string | ファイルサイズ（バイト） |
Google Driveでファイルのメタデータを更新します（名前変更、移動、スター付け、説明の追加）
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | 更新するファイルのID |
name | string | いいえ | ファイルの新しい名前 |
description | string | いいえ | ファイルの新しい説明 |
addParents | string | いいえ | 追加する親フォルダIDのカンマ区切りリスト（ファイルをこれらのフォルダに移動） |
removeParents | string | いいえ | 削除する親フォルダIDのカンマ区切りリスト |
starred | boolean | いいえ | ファイルにスターを付けるか外すか |
| パラメータ | 型 | 説明 |
|---|
file | json | 更新されたファイルのメタデータ |
↳ id | string | Google DriveファイルID |
↳ kind | string | リソースタイプ識別子 |
↳ name | string | ファイル名 |
↳ mimeType | string | MIMEタイプ |
↳ description | string | ファイルの説明 |
↳ starred | boolean | ファイルがスター付きかどうか |
↳ webViewLink | string | ブラウザで表示するURL |
↳ parents | json | 親フォルダID |
↳ modifiedTime | string | 最終更新日時 |
Google Driveでファイルをゴミ箱に移動する(後で復元可能)
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | ゴミ箱に移動するファイルのID |
| パラメータ | 型 | 説明 |
|---|
file | json | ゴミ箱に移動されたファイルのメタデータ |
↳ id | string | Google DriveファイルID |
↳ kind | string | リソースタイプ識別子 |
↳ name | string | ファイル名 |
↳ mimeType | string | MIMEタイプ |
↳ trashed | boolean | ファイルがゴミ箱にあるかどうか(trueであるべき) |
↳ trashedTime | string | ファイルがゴミ箱に移動された日時 |
↳ webViewLink | string | ブラウザで表示するURL |
Google Driveからファイルを完全に削除します（ゴミ箱をバイパス）
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | 完全に削除するファイルのID |
| パラメータ | 型 | 説明 |
|---|
deleted | boolean | ファイルが正常に削除されたかどうか |
fileId | string | 削除されたファイルのID |
ファイルをユーザー、グループ、ドメインと共有するか、公開します
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | 共有するファイルのID |
type | string | はい | 付与先のタイプ：user、group、domain、またはanyone |
role | string | はい | 権限ロール：owner（所有権の譲渡）、organizer（共有ドライブのみ）、fileOrganizer（共有ドライブのみ）、writer（編集）、commenter（閲覧とコメント）、reader（閲覧のみ） |
email | string | いいえ | ユーザーまたはグループのメールアドレス（type=userまたはtype=groupの場合は必須） |
domain | string | いいえ | 共有するドメイン（type=domainの場合は必須） |
transferOwnership | boolean | いいえ | roleがownerの場合は必須。指定されたユーザーに所有権を譲渡します。 |
moveToNewOwnersRoot | boolean | いいえ | 所有権を譲渡する際、ファイルを新しい所有者のマイドライブのルートフォルダに移動します。 |
sendNotification | boolean | いいえ | メール通知を送信するかどうか（デフォルト：true） |
emailMessage | string | いいえ | 通知メールに含めるカスタムメッセージ |
| パラメータ | 型 | 説明 |
|---|
permission | json | 作成された権限の詳細 |
↳ id | string | 権限ID |
↳ type | string | 付与先のタイプ (user、group、domain、anyone) |
↳ role | string | 権限ロール |
↳ emailAddress | string | 付与先のメールアドレス |
↳ displayName | string | 付与先の表示名 |
↳ domain | string | 付与先のドメイン |
↳ expirationTime | string | 有効期限 |
↳ deleted | boolean | 付与先が削除されているかどうか |
ファイルから権限を削除する(アクセスを取り消す)
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | 権限を変更するファイルのID |
permissionId | string | はい | 削除する権限のID (list_permissionsを使用して確認) |
| パラメータ | 型 | 説明 |
|---|
removed | boolean | 権限が正常に削除されたかどうか |
fileId | string | ファイルのID |
permissionId | string | 削除された権限のID |
Google Driveのファイルに対するすべての権限(アクセス権を持つユーザー)を一覧表示する
| パラメータ | 型 | 必須 | 説明 |
|---|
fileId | string | はい | 権限を一覧表示するファイルのID |
| パラメータ | 型 | 説明 |
|---|
permissions | array | ファイルの権限リスト |
↳ id | string | 権限ID（権限削除に使用） |
↳ type | string | 付与先のタイプ（user、group、domain、anyone） |
↳ role | string | 権限ロール（owner、organizer、fileOrganizer、writer、commenter、reader） |
↳ emailAddress | string | 付与先のメールアドレス |
↳ displayName | string | 付与先の表示名 |
↳ photoLink | string | 付与先の写真URL |
↳ domain | string | 付与先のドメイン |
↳ expirationTime | string | 権限の有効期限 |
↳ deleted | boolean | 付与先のアカウントが削除されているかどうか |
↳ allowFileDiscovery | boolean | 付与先がファイルを検索可能かどうか |
↳ pendingOwner | boolean | 所有権の移転が保留中かどうか |
↳ permissionDetails | json | 継承された権限の詳細 |
nextPageToken | string | 次のページの権限を取得するためのトークン |
ユーザーとそのGoogle Driveに関する情報を取得します（ストレージ容量、機能）
| パラメータ | 型 | 説明 |
|---|
user | json | 認証されたユーザーに関する情報 |
↳ displayName | string | ユーザーの表示名 |
↳ emailAddress | string | ユーザーのメールアドレス |
↳ photoLink | string | ユーザープロフィール写真のURL |
↳ permissionId | string | ユーザー権限ID |
↳ me | boolean | これが認証されたユーザーかどうか |
storageQuota | json | ストレージ容量情報（バイト単位） |
↳ limit | string | 合計ストレージ制限（バイト単位、無制限の場合はnull） |
↳ usage | string | 使用中の合計ストレージ（バイト単位） |
↳ usageInDrive | string | Driveファイルが使用しているストレージ（バイト単位） |
↳ usageInDriveTrash | string | ゴミ箱内のファイルが使用しているストレージ（バイト単位） |
canCreateDrives | boolean | ユーザーが共有ドライブを作成できるかどうか |
importFormats | json | インポート可能なMIMEタイプとその変換先フォーマットのマップ |
exportFormats | json | Google WorkspaceのMIMEタイプとそのエクスポート可能なフォーマットのマップ |
maxUploadSize | string | 最大アップロードサイズ（バイト単位） |
