ファイルの版を管理する

Google Drive API には revisions リソースが用意されており、ファイルのリビジョンをダウンロードして公開できます。リビジョンの用語の詳細については、変更とリビジョンの概要をご覧ください。

自動削除から保存するリビジョンを指定する

Google ドライブでは、ユーザーが関心を示さなくなった古いリビジョンは自動的に削除されます。これを回避するには、ブール値フラグ keepRevisionForever を true に設定して、ドライブでパージしないようにリビジョンにマークを付けます。

リビジョンをダウンロードする

最新のリビジョンをダウンロードするには、files.download メソッドを使用します。詳細については、長時間実行オペレーションの管理をご覧ください。

リビジョンを公開する

Google ドキュメント、Google スプレッドシート、Google スライドのリビジョンを公開するには、revisions リソースでそのファイルの published プロパティを設定します。Drive API を使用して Google サイトのリビジョンにこのプロパティを設定することはできません。

Google スライドと Google ドローでは、特定のリビジョンの公開はサポートされていません。最新のリビジョンの自動再公開のみがサポートされています。スライドと図形描画を公開するには、publishAuto を true に設定します。

ファイルが Google Workspace ドメインで作成された場合、publishedOutsideDomain プロパティは、リビジョンに誰でもアクセスできるかどうか、またはドメインのユーザーに限定されているかどうかを示します。Sites ファイルの場合、このプロパティは type=anyone 権限が存在するかどうかを示します。

publishAuto プロパティが設定されていない限り、公開されたリビジョンにはファイルに加えた変更は反映されません。このプロパティが true に設定されている場合、ファイルの新しいリビジョンが自動的に公開され、以前のリビジョンが上書きされます。この動作は、ドライブの UI の [変更が加えられると自動的に再公開する] チェックボックスでも制御できます。スライドと描画は自動再公開のみをサポートし、publishAuto プロパティを true に設定する必要があります。Sites ファイルの場合、publishAuto は常に false です。