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
です。