ファイル メタデータの管理

このドキュメントでは、ファイルに名前を付け、 テキストやサムネイルなどのメタデータです。ファイルの挿入と取得については、以下をご覧ください。 files リソース。

ファイル名と拡張子を指定する

アプリでは、ファイルを挿入するときに title プロパティでファイル拡張子を指定する必要があります Google Drive API でやり遂げましたたとえば、JPEG ファイルを挿入する操作では、 メタデータで "name": "cat.jpg" などを指定します。

後続の GET レスポンスには、読み取り専用の fileExtension プロパティを含めることができます。 name プロパティで最初に指定した拡張子が入力されます。特定の Google ドライブのユーザーがファイルのダウンロードをリクエストしたとき、またはファイルがダウンロードされたとき 同期クライアントを介して、ドライブは完全なファイル名を作成し、 拡張機能など)が表示されます。拡張機能がない場合は ドライブは、ファイルの拡張子に基づいて MIME タイプ。

インデックス登録可能なテキストを保存する

ドライブは、ドキュメントを自動的にインデックスに登録し、 は、テキスト ドキュメント、PDF、テキスト付きの画像などのファイル形式を認識し、 使用できます。その他の種類のファイル(図形描画、 動画、ショートカットなど)を提供する場合、 ファイルの contentHints.indexableText フィールドのインデックス登録可能なテキスト。

インデックス登録可能なテキストは、HTML としてインデックスに登録されます。インデックス登録可能なテキスト文字列を保存する場合 <section attribute="value1">Here's some text</section> を押してから、「 テキスト」インデックスは付きますが、「value1」はありませんそのため、XML はインデックス登録可能として保存します。 HTML を保存する場合ほど有用ではありません。

indexableText を指定する場合は、次の点に注意してください。

  • contentHints.indexableText のサイズの上限は 128 KB です。
  • ユーザーが検索すると予想される主な用語や概念を把握します。
  • 重要度順にテキストを並べ替えると、インデクサによって並べ替えが行われます。 役立ちます
  • アプリケーションは、保存のたびにインデックス登録可能なテキストを更新する必要があります。
  • テキストはファイルのコンテンツまたはメタデータに関連しているものにしてください。

この最後の点は、当たり前のように思えるかもしれませんが、重要なことです。インフラストラクチャの変更は、 よく検索されるキーワードを追加して、検索結果にファイルを強制的に表示させることができます。この ユーザーをイライラさせるだけでなく、ファイルを削除する意欲を起こさせることもあります。

サムネイルのアップロード

ドライブで多数の一般的なファイルのサムネイルが自動生成される Google ドキュメント、スプレッドシート、スライドなどです。 サムネイルによってドライブ内のファイルがわかりやすくなります。

ドライブで標準のサムネイルを生成できないファイル形式の場合 アプリケーションで生成されたサムネイル画像を提供できます。イベント中 サムネイルをアップロードするには files リソースの contentHints.thumbnail フィールド。

詳細は以下のとおりです。

  • contentHints.thumbnail.image フィールドを、安全な URL とファイル名に設定します。 base64 でエンコードされた画像(RFC 4648 のセクションを参照) 5)。
  • contentHints.thumbnail.mimeType フィールドを適切な MIME タイプに設定します。 選択します。

ファイルからサムネイルを生成できる場合は、 自動的に作成され、アップロードしたものは無視されます。作成できない場合 サムネイルが生成されると、指定したサムネイルが使用されます。

サムネイルは以下のルールに準拠している必要があります。

  • PNG、GIF、JPG のいずれかの形式でアップロードできます。
  • 推奨される幅は 1,600 ピクセルです。
  • 最小幅は 220 ピクセルです。
  • ファイルサイズの上限は 2 MB です。
  • 保存のたびにアプリケーションで更新する必要があります。
で確認できます。

詳細については、files リソースをご覧ください。

サムネイルを取得する

ドライブ ファイルのメタデータ(サムネイルを含む)を取得できます。 サムネイル情報は、チャンネルの thumbnailLink フィールドに格納されます。 files リソース。

特定のサムネイルを返す

次のコードサンプルは、 files.get メソッド リクエスト thumbnailLink メタデータを返すクエリ パラメータとして複数のフィールドを 適用できます。詳細については、特定のフィールドを返す 。

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

FILE_ID は、目的のファイルの fileId に置き換えます。 表示されます。

有効期間が短い URL(使用可能な場合)がファイルのサムネイルに返されます。 通常、リンクの有効期間は数時間です。このフィールドに値が入力されるのは、 リクエスト元のアプリがファイルのコンテンツにアクセスできるようになります。ファイルが共有されていない場合 一般公開する場合は、thumbnailLink で返される URL を 認証されたリクエスト

サムネイルのリストを返す

次のコードサンプルは、 files.list メソッド リクエスト thumbnailLink メタデータを返すクエリ パラメータとして複数のフィールドを ファイルのリストを作成します。詳しくは、ファイルとファイルを検索する フォルダをご覧ください。

GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)

検索結果を特定のファイルタイプに制限するには、クエリ文字列を MIME タイプを設定します。たとえば、次のコードサンプルは、 Google スプレッドシートファイルですMIME タイプについて詳しくは、 Google Workspace と Google ドライブでサポートされる MIME あります

GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)