> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 概要

> ドキュメントの自動生成、コンテンツ同期、スマートライティングなどのシナリオに適した、コンテンツの一括操作などの機能を提供します。

DingTalkドキュメント OpenAPI は、RESTful スタイルの API を提供しており、開発者はプログラム経由で DingTalkドキュメントを操作できます。これらの API を使用することで、ドキュメントコンテンツの自動読み書き、ブロック要素の追加・削除・更新・取得、コンテンツの一括操作などの機能を実現でき、ドキュメントの自動生成、コンテンツ同期、スマートライティングなどのシナリオに適しています。

## DingTalkドキュメントとは

DingTalkドキュメントは、Alibaba Group の DingTalk が独自開発した企業向けコラボレーションオフィススイートで、ドキュメント、スプレッドシート、マインドマップなどのオンライン作成ツールを含みます。日常的な利用では、ドキュメントをダウンロードすることなく、PC、スマートフォン、タブレットから直接ドキュメントコンテンツを編集・閲覧でき、内容はリアルタイムで自動保存されます。

また、DingTalkドキュメントは DingTalk と深く統合されており、組織関係に基づいて同僚と効率的にコラボレーションできます。DingTalkドキュメントは、情報収集、プロジェクト管理、会議、業務報告、新人オンボーディングなど、日常業務のさまざまなシナリオでも活用できます。その他の機能紹介については、[DingTalk 使い方ガイド-DingTalkドキュメント](https://docs.dingtalk.io/i/p/Y7kmbokZp3pgGLq2/docs/od245kZmnOeW4D4L73YEWYbzxL6R0wMQ)をご参照ください。

## オープン概要

### 公開 API リスト

DingTalkドキュメントは豊富な API 機能を提供しており、開発者は API を通じてドキュメントのベーシック操作を実現できます。

| **API**                                                           | **API 説明**                                                                                                       | **API バージョン** |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------- |
| [ドキュメントを上書き（個人権限付与）](/ja/open/development/api-docupdatecontent)   | Markdown 形式でドキュメント全体のコンテンツを上書きします。  **説明**  この方式では、ユーザーによる権限付与後に API を呼び出すことができます。                               | 新バージョン        |
| [ドキュメントを上書き（アプリ認可）](/ja/open/development/api-doc-updatecontent)   | Markdown 形式でドキュメント全体のコンテンツを上書きします。  **説明**  この方式では、アプリ認証情報の appKey、appSecret を使用してアクセストークンを取得後、API を呼び出すことができます。 | 新バージョン        |
| [リソースアップロード情報を取得](/ja/open/development/api-getresourceuploadinfo) | ドキュメントの指定リソースのアップロード先 URL を取得します。                                                                                | 新バージョン        |
| [コンテンツを挿入](/ja/open/development/api-insertcontent)                | ドキュメントの指定位置に Markdown コンテンツを挿入します。                                                                               | 新バージョン        |
| [ブロック要素を取得](/ja/open/development/api-docblocksquery)              | ドキュメントのルートノード配下の第一階層ブロック要素リストを取得します。                                                                             | 新バージョン        |
| [ブロック要素を挿入](/ja/open/development/api-docinsertblocks)             | ドキュメントの指定位置に 1 つのブロック要素を挿入します。                                                                                   | 新バージョン        |
| [ブロック要素を更新](/ja/open/development/api-docblocksmodify)             | ドキュメント内の任意のブロック要素 1 つのコンテンツまたは属性を更新します。                                                                          | 新バージョン        |
| [ブロック要素を削除](/ja/open/development/api-docdeleteblock)              | ドキュメント内の特定のブロック要素 1 つを削除します。                                                                                     | 新バージョン        |
| [段落の末尾にテキストを追加](/ja/open/development/api-docappendtext)           | 指定段落の末尾にテキストを追加します。                                                                                              | 新バージョン        |
| [段落の末尾にインライン要素を追加](/ja/open/development/api-docappendparagraph)   | 指定段落の末尾にインライン要素を追加します。                                                                                           | 新バージョン        |

### コールバックイベントリスト

* ドキュメントエクスポートタスク完了イベント

## 用語解説

DingTalkドキュメント OpenAPI を使用する前に、以下のコア概念を理解する必要があります。

### dentryUuid

ドキュメントの一意な識別子です。例として`https://docs.dingtalk.io/i/nodes/Z90D4da-id`の場合、`dentryUuid`は`Z90D4da-id`となります。

### blockId

ブロック要素の一意な識別子で、「ブロック要素を取得」API から取得できます。

### operatorId

操作者の`unionId`で、操作を実行するユーザーの本人確認および権限検証に使用されます。

### BlockElement

ブロック要素は、ドキュメントコンテンツの基本構成単位であり、段落、見出し、ハイライトブロック、テーブルなどがあります。

### InlineElement

インライン要素は、ブロック要素の内部にネストされる要素で、ステッカー、画像、リンク、スロットなどがあります。