Skip to content

Commit

Permalink
Moji: Update translations
Browse files Browse the repository at this point in the history
  • Loading branch information
boxmoji committed May 29, 2024
1 parent 8347eeb commit d18da3c
Show file tree
Hide file tree
Showing 228 changed files with 6,021 additions and 6,139 deletions.
4 changes: 2 additions & 2 deletions guides/api-calls/allowing-domain-access.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
rank: 5
rank: 6
related_endpoints:
- get_files_id_content
- post_files_content
Expand All @@ -14,7 +14,7 @@ subcategory_id: null
is_index: false
id: api-calls/allowing-domain-access
type: guide
total_steps: 8
total_steps: 9
sibling_id: api-calls
parent_id: api-calls
next_page_id: api-calls/suppress-notifications
Expand Down
249 changes: 249 additions & 0 deletions guides/api-calls/api-versioning-strategy.md

Large diffs are not rendered by default.

16 changes: 4 additions & 12 deletions guides/api-calls/ensure-consistency.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
rank: 4
rank: 5
related_endpoints:
- post_files_id_content
- put_files_id
Expand All @@ -20,7 +20,7 @@ subcategory_id: null
is_index: false
id: api-calls/ensure-consistency
type: guide
total_steps: 8
total_steps: 9
sibling_id: api-calls
parent_id: api-calls
next_page_id: api-calls/allowing-domain-access
Expand Down Expand Up @@ -63,8 +63,8 @@ curl https://api.box.com/2.0/files/12345 \

```curl
curl https://api.box.com/2.0/files/12345 \
-H "authorization: Bearer ACCESS_TOKEN" \
-H "if-none-match: 1"
-H "authorization: Bearer ACCESS_TOKEN" \
-H "if-none-match: 1"
```

Expand All @@ -76,8 +76,6 @@ curl https://api.box.com/2.0/files/12345 \

このヘッダーは、以下のエンドポイントでサポートされます。

<!-- markdownlint-disable line-length -->

| `if-match`対応のエンドポイント | |
| ------------------------------------------------------------- | ------------------- |
| [`POST /files/:id/content`](endpoint://post_files_id_content) | 新しいファイルバージョンをアップロード |
Expand All @@ -88,8 +86,6 @@ curl https://api.box.com/2.0/files/12345 \
| [`PUT /web_links/:id`](endpoint://put_web_links_id) | ウェブリンクの情報を更新 |
| [`DELETE /web_links/:id`](endpoint://delete_web_links_id) | ウェブリンクを削除 |

<!-- markdownlint-enable line-length -->

これらのAPIコールのレスポンスは、項目が存在するかどうか、および`etag`値が最新バージョンと一致するかどうかによって異なります。

| 項目があるか? | Etagが一致するか? | HTTPステータス |
Expand All @@ -111,17 +107,13 @@ curl https://api.box.com/2.0/files/12345 \

`if-none-match`ヘッダーを使用すると、アプリケーションは、最後に調べてから変更されていない項目の情報がダウンロードされないようにすることができます。これにより、不要な情報がダウンロードされなくなるため、アプリケーションの速度が向上し、帯域幅が節約されます。

<!-- markdownlint-disable line-length -->

| `if-none-match`対応のエンドポイント | |
| --------------------------------------------------- | ------------ |
| [`GET /files/:id`](endpoint://get_files_id) | ファイルの情報を取得 |
| [`GET /folders/:id`](endpoint://get_folder_id) | フォルダの情報を取得 |
| [`GET /web_links/:id`](endpoint://get_web_links_id) | ウェブリンクの情報を取得 |
| [`GET /shared_items`](endpoint://get_shared_items) | 共有項目の情報を取得 |

<!-- markdownlint-enable line-length -->

これらのAPIコールのレスポンスは、項目が存在するかどうか、および`etag`値が最新バージョンと一致するかどうかによって異なります。

| 項目があるか? | Etagが一致するか? | HTTPステータス |
Expand Down
4 changes: 2 additions & 2 deletions guides/api-calls/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@ subcategory_id: null
is_index: true
id: api-calls
type: guide
total_steps: 8
total_steps: 9
sibling_id: guides
parent_id: guides
next_page_id: ''
previous_page_id: api-calls/language-codes
previous_page_id: api-calls/api-versioning-strategy
source_url: >-
https://github.com/box/developer.box.com/blob/main/content/guides/api-calls/index.md
fullyTranslated: true
Expand Down
6 changes: 3 additions & 3 deletions guides/api-calls/language-codes.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
rank: 7
rank: 8
related_endpoints: []
related_guides: []
required_guides: []
Expand All @@ -10,10 +10,10 @@ subcategory_id: null
is_index: false
id: api-calls/language-codes
type: guide
total_steps: 8
total_steps: 9
sibling_id: api-calls
parent_id: api-calls
next_page_id: api-calls
next_page_id: api-calls/api-versioning-strategy
previous_page_id: api-calls/suppress-notifications
source_url: >-
https://github.com/box/developer.box.com/blob/main/content/guides/api-calls/language-codes.md
Expand Down
12 changes: 0 additions & 12 deletions guides/api-calls/pagination/marker-based.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,16 +54,12 @@ curl https://api.box.com/2.0/folders/0/items?limit=100&usemarker=true \

エントリの次のページを取得するには、APIレスポンスで受け取った`next_marker`値の値に等しい`marker`パラメータを指定して、APIを呼び出す必要があります。

<!-- markdownlint-disable line-length -->

```curl
curl https://api.box.com/2.0/folders/0/items?marker=34332423&limit=100&usemarker=true \
-H "authorization: Bearer ACCESS_TOKEN"
```

<!-- markdownlint-enable line-length -->

次の`next_marker`値がレスポンスオブジェクト内で`null`になっている場合、項目の最終ページはリクエスト済みです。この時点では、これ以上取得する項目がありません。

<Message type="notice">
Expand All @@ -76,30 +72,22 @@ curl https://api.box.com/2.0/folders/0/items?marker=34332423&limit=100&usemarker

以下のクエリパラメータは、コレクションのページ割りに使用されます。

<!-- markdownlint-disable line-length -->

| クエリパラメータ || デフォルト | |
| ----------- | ------- | ---------- | ---------------------------------------------------------------------------------------------------- |
| `marker` | String | | コレクション内で最初に結果を返す位置。これは前のリクエストで返された値です。 |
| `limit` | Integer | APIによって異なる | 返される最大エントリ数。値が最大値を超える場合は、最大値が使用されます。 |
| `usemarker` | Boolean | | ページ割りのタイプを選択するために、両タイプのページ割りをサポートするAPIエンドポイントで使用可能なクエリパラメータ (省略可)。`true`に設定すると、マーカーベースのページ割りが適用されます。 |

<!-- markdownlint-enable line-length -->

## コレクション

コレクションのページ割りを行うと、APIによって、結果のセットを配列として含むオブジェクトのほか、結果の現在のページに関する情報が返されます。

<!-- markdownlint-disable line-length -->

| フィールド || |
| ------------- | ------- | ------------------------------------------------------------------------------- |
| `entries` | Array | このページの項目を含むページ。結果がない場合は空の配列になります。 |
| `next_marker` | String | 結果の次のページを取得するために`marker`値として使用できる値。この値が`null`または空の文字列の場合は、これ以上取得する結果がありません。 |
| `limit` | Integer | 結果の現在のページに使用される制限。この制限は、このAPIエンドポイントに許可されている最大値を超えない限り、`limit`クエリパラメータと同じになります。 |

<!-- markdownlint-enable line-length -->

## エンドポイントの例

以下は、マーカーベースのページ割りをサポートするエンドポイントの例です。
Expand Down
12 changes: 2 additions & 10 deletions guides/api-calls/pagination/offset-based.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,15 +44,15 @@ fullyTranslated: true

```curl
curl https://api.box.com/2.0/folders/0/items?offset=0&limit=100 \
-H "authorization: Bearer ACCESS_TOKEN"
-H "authorization: Bearer ACCESS_TOKEN"
```

エントリの次のページを取得するには、以前の`offset`値と以前の結果で返された制限の合計 (`previous_offset + previous_limit`) と等しい`offset`パラメータを指定して、APIを呼び出す必要があります。

```curl
curl https://api.box.com/2.0/folders/0/items?offset=100&limit=100 \
-H "authorization: Bearer ACCESS_TOKEN"
-H "authorization: Bearer ACCESS_TOKEN"
```

Expand All @@ -68,15 +68,11 @@ curl https://api.box.com/2.0/folders/0/items?offset=100&limit=100 \

以下のクエリパラメータは、コレクションのページ割りに使用されます。

<!-- markdownlint-disable line-length -->

| クエリパラメータ || デフォルト | |
| -------- | ------- | ---------- | ---------------------------------------------------------- |
| `offset` | Integer | `0` | コレクションで最初に返される項目の (ゼロベースの) オフセット。ゼロベースのオフセットでは、`0`は適切な値です。 |
| `limit` | Integer | APIによって異なる | 返される最大エントリ数。値が最大値を超える場合は、最大値が使用されます。 |

<!-- markdownlint-enable line-length -->

<Message type="notice">

オフセットベースのページ割りの最大`offset``9999`です。さらに大きいオフセットが必要な場合はマーカーベースのページ割りをお勧めします。
Expand All @@ -87,17 +83,13 @@ curl https://api.box.com/2.0/folders/0/items?offset=100&limit=100 \

コレクションのページ割りを行うと、APIによって、結果のセットを配列として含むオブジェクトのほか、結果の現在のページに関する情報が返されます。

<!-- markdownlint-disable line-length -->

| フィールド || |
| ------------- | ------- | ------------------------------------------------------------------------------- |
| `entries` | Array | このページの項目を含むページ。結果がない場合は空の配列になります。 |
| `offset` | Integer | 結果の現在のページに使用されるオフセット |
| `limit` | Integer | 結果の現在のページに使用される制限。この制限は、このAPIエンドポイントに許可されている最大値を超えない限り、`limit`クエリパラメータと同じになります。 |
| `total_count` | Integer | コレクション全体の最後の項目のオフセットに1を加算した値。コレクション内の項目の合計数は、`total_count`よりも少ない場合があります。 |

<!-- markdownlint-enable line-length -->

## エンドポイントの例

以下は、オフセットベースのページ割りをサポートするエンドポイントの例です。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -115,8 +115,6 @@ App Diagnosticsレポートを実行するには、[開発者コンソール][co

このレポートには列が9個あります。

<!-- markdownlint-disable line-length -->

|| 説明 | |
| ---------------- | ----------------------- | - |
| アプリ名 | アプリケーションの名前 | |
Expand Down
Loading

0 comments on commit d18da3c

Please sign in to comment.