ファイルをBox Doc Genテンプレートとして設定
ファイルをBox Doc Genテンプレートとして設定
既存のドキュメントをBox Doc Genテンプレートとして設定し、それを使用してドキュメントを生成できます。
開始する前に
Before you start using Box Doc Gen API, follow the steps listed in the get started with Box Doc Gen guide to create a platform app and a Box Doc Gen template.
リクエストの送信
質問を含むリクエストを送信するには、POST /2.0/docgen_templates
エン ドポイントを使用し、必須のパラメータを指定します。
パラメータ
コールを実行するには、以下のパラメータを渡す必要があります。必須のパラメータは太字で示されています。
パラメータ | 説明 | 例 |
---|---|---|
file.id | Box Doc Genテンプレートとして設定するファイルのID。 | 12345678 |
file.type | 指定した入力データの種類。値は常に**file **になります。 | file |
ユースケース
ファイルをBox Doc Genテンプレートとして設定する
次のサンプルでは、ファイルがBox Doc Genテンプレートとして認識されるように設定する方法を示します。
cURL
curl -L 'https://api.box.com/2.0/docgen_templates' \
-H 'box-version: 2025.0' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-D '{
"file": {
"id": "12345678",
"type": "file"
}
}'
TypeScript Gen
await client.docgenTemplate.createDocgenTemplateV2025R0({
file: new FileReferenceV2025R0({ id: file.id }),
} satisfies DocGenTemplateCreateRequestV2025R0);
Python Gen
client.docgen_template.create_docgen_template_v2025_r0(FileReferenceV2025R0(id=file.id))
.NET Gen
await client.DocgenTemplate.CreateDocgenTemplateV2025R0Async(requestBody: new DocGenTemplateCreateRequestV2025R0(file: new FileReferenceV2025R0(id: file.Id)));
ファイルからBox Doc Genテンプレートの設定を削除する
ファイルのBox Doc Genテンプレートの設定が解除されるようにするには、DELETE 2.0/docgen_templates/:template_id
リクエストを使用します。
cURL
curl -L -X DELETE 'https://api.box.com/2.0/docgen_templates/12345678' \
-H 'box-version: 2025.0' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
TypeScript Gen
await client.docgenTemplate.deleteDocgenTemplateByIdV2025R0(
createdDocgenTemplate.file!.id,
);
Python Gen
client.docgen_template.delete_docgen_template_by_id_v2025_r0(
created_docgen_template.file.id
)
.NET Gen
await client.DocgenTemplate.DeleteDocgenTemplateByIdV2025R0Async(templateId: NullableUtils.Unwrap(createdDocgenTemplate.File).Id);