Google ドライブ ファイルの作成、アップロード、リスト表示
Google ドライブ は、ユーザーがファイルを保存し、デバイス間でファイルを同期し、他のユーザーとファイルを共有できるGoogleのクラウドストレージおよびファイル同期サービスです。Googleの生産性エコシステムの中核コンポーネントとして、Google ドライブは堅牢なストレージ、整理、コラボレーション機能を提供しています。
SimでGoogle ドライブツールを統合して、ワークフローを通じてドライブから情報を簡単に取得する方法を学びましょう。このチュートリアルでは、Google ドライブの接続、データ取得のセットアップ、保存されたドキュメントやファイルを使用して自動化を強化する方法を説明します。エージェントとリアルタイムで重要なデータを同期するのに最適です。
VIDEO
Google ドライブでは、次のことができます：
クラウドにファイルを保存 ：インターネットアクセスがあればどこからでもファイルをアップロードしてアクセス可能コンテンツを整理 ：フォルダの作成、カラーコーディングの使用、命名規則の実装共有とコラボレーション ：アクセス権限を制御し、ファイルで同時に作業効率的な検索 ：Googleの強力な検索技術でファイルをすばやく見つける複数デバイスでのアクセス ：デスクトップ、モバイル、WebプラットフォームでGoogle ドライブを使用他のサービスとの統合 ：Google ドキュメント、スプレッドシート、スライド、サードパーティアプリケーションと連携
Simでは、Google Drive統合により、エージェントがプログラム的にクラウドストレージと直接やり取りすることができます。これにより、ファイル管理、コンテンツ整理、ドキュメントワークフローなどの強力な自動化シナリオが可能になります。エージェントは特定のフォルダに新しいファイルをアップロードしたり、既存のファイルをダウンロードしてその内容を処理したり、フォルダの内容を一覧表示してストレージ構造をナビゲートしたりできます。この統合により、AIワークフローとドキュメント管理システムの間のギャップが埋まり、手動介入なしでシームレスなファイル操作が可能になります。SimとGoogle Driveを接続することで、ファイルベースのワークフローを自動化し、ドキュメントをインテリジェントに管理し、クラウドストレージ操作をエージェントの機能に組み込むことができます。
Google Driveをワークフローに統合します。ファイルの作成、アップロード、一覧表示が可能です。OAuthが必要です。
ファイルをGoogle Driveにアップロードする
パラメータ 型 必須 説明 fileNamestring はい アップロードするファイルの名前 filefile いいえ アップロードするバイナリファイル（UserFileオブジェクト） contentstring いいえ アップロードするテキストコンテンツ（fileかこちらのどちらか一方を使用、両方は不可） mimeTypestring いいえ アップロードするファイルのMIMEタイプ（指定がない場合はファイルから自動検出） folderSelectorstring いいえ ファイルをアップロードするフォルダを選択 folderIdstring いいえ ファイルをアップロードするフォルダのID（内部使用）
パラメータ 型 説明 filejson ID、名前、リンクを含むアップロードされたファイルのメタデータ
Google Driveに新しいフォルダを作成する
パラメータ 型 必須 説明 fileNamestring はい 作成するフォルダの名前 folderSelectorstring いいえ フォルダを作成する親フォルダを選択 folderIdstring いいえ 親フォルダのID（内部使用）
パラメータ 型 説明 filejson 作成されたフォルダのメタデータ（ID、名前、親情報を含む）
Google Driveからファイルをダウンロードする（Google Workspaceファイルは自動的にエクスポートされます）
パラメータ 型 必須 説明 fileIdstring はい ダウンロードするファイルのID mimeTypestring いいえ Google Workspaceファイルをエクスポートする際のMIMEタイプ（オプション） fileNamestring いいえ オプションのファイル名上書き
パラメータ 型 説明 filefile 実行ファイルに保存されたダウンロードファイル
Google Drive内のファイルとフォルダを一覧表示する
パラメータ 型 必須 説明 folderSelectorstring いいえ ファイルを一覧表示するフォルダを選択 folderIdstring いいえ ファイルを一覧表示するフォルダのID（内部使用） querystring いいえ ファイル名でフィルタリングする検索語（例：「budget」は名前に「budget」を含むファイルを検索）。ここではGoogle Driveのクエリ構文を使用しないでください - 単純な検索語を提供してください。 pageSizenumber いいえ 返すファイルの最大数（デフォルト：100） pageTokenstring いいえ ページネーションに使用するページトークン
パラメータ 型 説明 filesjson 指定されたフォルダからのファイルメタデータオブジェクトの配列
カテゴリ: tools
タイプ: google_drive
パラメータ 型 説明 filefile 実行ファイルに保存されたダウンロード済みファイル metadataobject 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でファイルのコピーを作成します
パラメータ 型 必須 説明 fileIdstring はい コピーするファイルのID newNamestring いいえ コピーしたファイルの名前（デフォルトは「Copy of [元の名前]」） destinationFolderIdstring いいえ コピーを配置するフォルダのID（デフォルトは元のファイルと同じ場所）
パラメータ 型 説明 filejson コピーされたファイルのメタデータ ↳ 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でファイルのメタデータを更新します（名前変更、移動、スター付け、説明の追加）
パラメータ 型 必須 説明 fileIdstring はい 更新するファイルのID namestring いいえ ファイルの新しい名前 descriptionstring いいえ ファイルの新しい説明 addParentsstring いいえ 追加する親フォルダIDのカンマ区切りリスト（ファイルをこれらのフォルダに移動） removeParentsstring いいえ 削除する親フォルダIDのカンマ区切りリスト starredboolean いいえ ファイルにスターを付けるか外すか
パラメータ 型 説明 filejson 更新されたファイルのメタデータ ↳ 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でファイルをゴミ箱に移動する(後で復元可能)
パラメータ 型 必須 説明 fileIdstring はい ゴミ箱に移動するファイルのID
パラメータ 型 説明 filejson ゴミ箱に移動されたファイルのメタデータ ↳ id string Google DriveファイルID ↳ kind string リソースタイプ識別子 ↳ name string ファイル名 ↳ mimeType string MIMEタイプ ↳ trashed boolean ファイルがゴミ箱にあるかどうか(trueであるべき) ↳ trashedTime string ファイルがゴミ箱に移動された日時 ↳ webViewLink string ブラウザで表示するURL
Google Driveからファイルを完全に削除します（ゴミ箱をバイパス）
パラメータ 型 必須 説明 fileIdstring はい 完全に削除するファイルのID
パラメータ 型 説明 deletedboolean ファイルが正常に削除されたかどうか fileIdstring 削除されたファイルのID
ファイルをユーザー、グループ、ドメインと共有するか、公開します
パラメータ 型 必須 説明 fileIdstring はい 共有するファイルのID typestring はい 付与先のタイプ：user、group、domain、またはanyone rolestring はい 権限ロール：owner（所有権の譲渡）、organizer（共有ドライブのみ）、fileOrganizer（共有ドライブのみ）、writer（編集）、commenter（閲覧とコメント）、reader（閲覧のみ） emailstring いいえ ユーザーまたはグループのメールアドレス（type=userまたはtype=groupの場合は必須） domainstring いいえ 共有するドメイン（type=domainの場合は必須） transferOwnershipboolean いいえ roleがownerの場合は必須。指定されたユーザーに所有権を譲渡します。 moveToNewOwnersRootboolean いいえ 所有権を譲渡する際、ファイルを新しい所有者のマイドライブのルートフォルダに移動します。 sendNotificationboolean いいえ メール通知を送信するかどうか（デフォルト：true） emailMessagestring いいえ 通知メールに含めるカスタムメッセージ
パラメータ 型 説明 permissionjson 作成された権限の詳細 ↳ id string 権限ID ↳ type string 付与先のタイプ (user、group、domain、anyone) ↳ role string 権限ロール ↳ emailAddress string 付与先のメールアドレス ↳ displayName string 付与先の表示名 ↳ domain string 付与先のドメイン ↳ expirationTime string 有効期限 ↳ deleted boolean 付与先が削除されているかどうか
ファイルから権限を削除する(アクセスを取り消す)
パラメータ 型 必須 説明 fileIdstring はい 権限を変更するファイルのID permissionIdstring はい 削除する権限のID (list_permissionsを使用して確認)
パラメータ 型 説明 removedboolean 権限が正常に削除されたかどうか fileIdstring ファイルのID permissionIdstring 削除された権限のID
Google Driveのファイルに対するすべての権限(アクセス権を持つユーザー)を一覧表示する
パラメータ 型 必須 説明 fileIdstring はい 権限を一覧表示するファイルのID
パラメータ 型 説明 permissionsarray ファイルの権限リスト ↳ 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 継承された権限の詳細 nextPageTokenstring 次のページの権限を取得するためのトークン
ユーザーとそのGoogle Driveに関する情報を取得します（ストレージ容量、機能）
パラメータ 型 説明 userjson 認証されたユーザーに関する情報 ↳ displayName string ユーザーの表示名 ↳ emailAddress string ユーザーのメールアドレス ↳ photoLink string ユーザープロフィール写真のURL ↳ permissionId string ユーザー権限ID ↳ me boolean これが認証されたユーザーかどうか storageQuotajson ストレージ容量情報（バイト単位） ↳ limit string 合計ストレージ制限（バイト単位、無制限の場合はnull） ↳ usage string 使用中の合計ストレージ（バイト単位） ↳ usageInDrive string Driveファイルが使用しているストレージ（バイト単位） ↳ usageInDriveTrash string ゴミ箱内のファイルが使用しているストレージ（バイト単位） canCreateDrivesboolean ユーザーが共有ドライブを作成できるかどうか importFormatsjson インポート可能なMIMEタイプとその変換先フォーマットのマップ exportFormatsjson Google WorkspaceのMIMEタイプとそのエクスポート可能なフォーマットのマップ maxUploadSizestring 最大アップロードサイズ（バイト単位）