このガイドでは、Terraform を構成する主なメソッドなど、 ドキュメントへのアクセス方法、ドキュメントを作成する際のワークフロー ドキュメントをご覧ください
API メソッド
documents
リソースには、Docs API の呼び出しに使用するメソッドが用意されています。以下の方法で、
ドキュメントの作成、読み取り、更新:
documents.create
を使用する メソッドを使用してドキュメントを作成します。documents.get
メソッドを使用する 指定したドキュメントのコンテンツを取得できます。documents.batchUpdate
を使用する メソッドを使用すると、指定したドキュメントに対して一連の更新をアトミックに実行できます。
documents.get
メソッドと documents.batchUpdate
メソッドには documentId
が必要です。
引数としてターゲット ドキュメントを指定します。documents.create
メソッドは、作成されたドキュメントのインスタンスを返します。このインスタンスから documentId
を読み取ることができます。Docs API リクエストの詳細と、Pub/Sub についての
詳細については、リクエストと
回答。
ドキュメント ID
documentId
はドキュメントの一意の識別子です。この値から導出できます。
取得できるからです文字、数字、メールアドレスを含む
使用しないでください。ドキュメント名が変わっても、ドキュメント ID は不変です。
できます。
https://docs.google.com/document/d/DOCUMENT_ID/edit
次の正規表現を使用して、documentId
を
Google ドキュメントの URL:
/document/d/([a-zA-Z0-9-_]+)
Google Drive API に精通している場合、documentId
は id
に対応します。
これは files
リソースにあります。
Google ドライブのドキュメントの管理
ドキュメント ファイルは、クラウド ベースのストレージ サービスである Google ドライブに保存されます。Docs API には独自のスタンドアロン メソッドがありますが、
また、Google Drive API メソッドを使用してユーザーの
。たとえば、ドキュメント ファイルをコピーするには、
Drive API の files.copy
メソッドを呼び出します。詳しくは、既存の
ドキュメントをご覧ください。
デフォルトでは、Docs API を使用すると、新しいドキュメントは ドライブ上のユーザーのルートフォルダです。ドライブのフォルダにファイルを保存する方法はいくつかあります。詳しくは、 Google ドライブ フォルダ。
ドキュメント ファイルを操作する
ユーザーのマイドライブからドキュメントを取得するには、多くの場合、
最初に Google ドライブの
files.list
メソッドで取得し、
ファイルの ID。パラメータなしでメソッドを呼び出すと、すべてのパラメータのリストが返されます。
ユーザーごとにファイルとフォルダ(ID を含む)が作成されます。
ドキュメントの MIME タイプは、データのタイプと形式を示します。MIME タイプの形式
ドキュメントの価格は application/vnd.google-apps.document
です。リストには
MIME タイプについては、Google Workspace と Google ドライブでサポートされる MIME についてご覧ください。
あります。
[マイページ] 内のドキュメント ファイルのみを MIME タイプで検索できます。 ドライブでは、次のクエリ文字列フィルタを追加します。
q: mimeType = 'application/vnd.google-apps.document'
クエリ文字列フィルタについて詳しくは、ファイルと フォルダをご覧ください。
documentId
がわかったら、次のコマンドを使用します。
取得する documents.get
メソッド
指定したドキュメントの完全なインスタンス。詳細については、次をご覧ください:
リクエストとレスポンス。
Google Workspace ドキュメントのバイト コンテンツを書き出すには、ドライブの
files.export
メソッド
エクスポートするファイルの documentId
と正しいエクスポート MIME
type。詳しくは、エクスポートする
Google Workspace ドキュメント
コンテンツをご覧ください。
Get
メソッドと List
メソッドを比較する
次の表に、Google ドライブと および各メソッドで返されるデータがあります。
演算子 | 説明 | 用途 |
---|---|---|
drive.files.get |
ファイルのメタデータを ID で取得します。files リソースのインスタンスを返します。 |
特定のファイルのメタデータを取得します。 |
drive.files.list |
ユーザーのファイルを取得します。ファイルのリストを返します。 | 変更する必要があるファイルが不明な場合は、ユーザー ファイルのリストを取得します。 |
docs.documents.get |
指定したドキュメントの最新バージョン(すべての書式設定とテキストを含む)を取得します。documents リソースのインスタンスを返します。 |
特定のドキュメント ID のドキュメントを取得します。 |
ドキュメント作成ワークフロー
新しいドキュメントを作成して入力するのは簡単です。 心配する必要はなく、コンテンツに変更を加えることができる ドキュメントの状態。概念的には、この流れは次のようになります。 図:
図 1 では、Google Chat と通信する
documents
リソースには次のものがあります。
情報のフロー:
- アプリは
documents.create
メソッドがオン 作成します。 - ウェブサーバーが、ウェブサーバーから
documents
リソースとしてドキュメントを作成しました。 - 必要に応じて、アプリは
documents.batchUpdate
メソッドを呼び出して、一連の編集リクエストをアトミックに実行し、ドキュメントにデータを入力します。 - ウェブサーバーが HTTP レスポンスを送信します。一部の
documents.batchUpdate
メソッド 適用されたリクエストに関する情報をレスポンスの本文に提供しますが、 それ以外のユーザーには空の回答が表示されます。
ドキュメント更新ワークフロー
既存のドキュメントの更新はより複雑です。意味のあるものにするには、 呼び出しを行ってドキュメントを更新する場合は、その現在の状態、つまりどのような要素が 要素に含まれる内容、要素の順序など、 できます。次のシーケンス図に、この仕組みを示します。
図 2 では、documents
リソースを操作しているユーザーに
次のような流れになります。
- アプリは
documents.get
メソッド(ウェブの場合) 検索するファイルのdocumentId
に置き換えます。 - ウェブサーバーが、ウェブサーバーから
documents
リソースとして指定します。返される JSON には、ドキュメントのコンテンツ、フォーマット、その他の機能が含まれます。 - このアプリが JSON を解析して、ユーザーはコンテンツまたは形式を決定できます。 更新されます
- アプリは
documents.batchUpdate
メソッドを呼び出して、一連の編集リクエストをアトミックに実行し、ドキュメントを更新します。 - ウェブサーバーが HTTP レスポンスを送信します。一部の
documents.batchUpdate
メソッド 適用されたリクエストに関する情報をレスポンスの本文に提供しますが、 それ以外のユーザーには空の回答が表示されます。
この図では、他の Google Cloud サービスによる同時更新が 同じドキュメントで共同編集者が作られる。詳しくは、 プラクティスのセクション コラボレーション。