Skip to content

Commit

Permalink
Moji: Update translations
Browse files Browse the repository at this point in the history
  • Loading branch information
@boxmoji
boxmoji committed May 13, 2024
1 parent 61d7693 commit c29702a
Show file tree
Hide file tree
Showing 12 changed files with 212 additions and 212 deletions.
20 changes: 10 additions & 10 deletions guides/api-calls/api-versioning-strategy.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,29 +21,29 @@ fullyTranslated: true

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

Box provides versioning capabilities for selected API endpoints. The version control system guarantees seamless functioning of existing endpoint versions, even if Box introduces new ones.
Boxでは、特定のAPIエンドポイントに対してバージョン管理機能を提供しています。このバージョン管理システムにより、Boxがエンドポイントのバージョンを新しく導入した場合でも、既存のエンドポイントのバージョンに対してシームレスな機能が保証されます。

API versioning empowers Box to continually enhance its platform, while also offering third-party developers a reliable avenue for feature updates and deprecations.
APIのバージョン管理により、Boxは、自社のプラットフォームを継続的に強化できると同時に、機能の更新や廃止のための信頼できる手段をサードパーティの開発者に提供することもできます。

<Message type="tip">

To stay informed about the forthcoming API modifications, monitor the [Changelog](https://developer.box.com/changelog/) and maintain a current email address in the Developer Console's App Info section.
今後予定されているAPIの変更について常に最新情報を把握できるように、[変更ログ](https://developer.box.com/changelog/)を監視し、開発者コンソールの \[アプリ情報] セクションで現在のメールアドレスを指定しておいてください。

</Message>

## Box APIのバージョン管理の仕組み

<Message type="notice">

Box API supports versioning in URL `path` and `header`. To determine which version to use, look at the API reference and included sample requests.
Box APIは、URLの`path`と`header`でバージョン管理をサポートしています。どのバージョンを使用するかを決定するには、APIリファレンスとそこに記載されているサンプルリクエストを参照してください。

</Message>

The default version of the API used in any requests is specified in the URL of the endpoint you call. An example flow looks like this:
リクエストで使用されるAPIのデフォルトのバージョンは、呼び出すエンドポイントのURLで指定します。フローの例を以下に示します。

1. When calling the [upload](`https://upload.box.com/api/2.0/files/content`) endpoint without any version header specified, you hit the `2.0` version defined in the URL.
1. バージョンヘッダーを指定せずに[アップロード](`https://upload.box.com/api/2.0/files/content`)エンドポイントを呼び出すと、URLで定義されている`2.0`バージョンが使用されます。

2. Box API processes the `Box-Version` header which should:
2. Box APIでは、以下に該当する`Box-Version`ヘッダーを処理します。

* `Box-Version: 2025.0`のような有効なバージョン名を含む
* `https://api.box.com/2.0/files/:file_id/metadata`に送信される
Expand Down Expand Up @@ -72,7 +72,7 @@ APIの新しいバージョンは、リリースされた暦年に従ってラ

Boxは、1年に1回、APIエンドポイントに新しく重大な変更を行う場合がありますが、セキュリティやプライバシーに関する懸念に対処するためにさらに重大な変更をリリースする権利を留保します。このような場合、新しいバージョンではサフィックスが1ずつ増加します。たとえば、以前にリリースされた署名リクエストのバージョン`2025.0`でセキュリティの問題に対処する必要がある場合、新しいバージョンには`2025.1`というラベルが付きます。

Each stable version is supported for a minimum of 12 months. This means that when a new version is released, the previous version becomes deprecated and will be available for use, but no new features will be added. It also means, that a new version cannot be released sooner than every 12 months.
安定した各バージョンは最低12か月間サポートされます。つまり、新しいバージョンがリリースされると、以前のバージョンは非推奨となり、使用することはできますが、新機能が追加されなくなります。また、12か月経たずに新しいバージョンがリリースされることはありません。

アプリを更新して最新の安定したAPIバージョンにリクエストを実行することを強くお勧めします。ただし、アプリで使用している安定したバージョンがサポートされなくなると、HTTPエラーコード`404 - Not Found`を含むレスポンスが返されます。詳細については、[バージョン管理のエラー](#versioning-errors)を参照してください。

Expand All @@ -91,7 +91,7 @@ curl --location 'https://api.box.com/2.0/sign_requests' \
クライアントは、作成されたすべての署名リクエストのリストを取得し、バージョン`2025.0`を要求します。使用可能なAPIにはサポートされているバージョンがいくつかあるため、使用するバージョンを`Box-Version`ヘッダーで指定します。APIのバージョンには、**安定**、**非推奨**、**不安定**の3種類があります。
## Versioning errors
## バージョン管理のエラー
### URLでの正しくないAPIバージョンの呼び出し
Expand Down Expand Up @@ -206,7 +206,7 @@ Boxでは、[oasdiff](https://github.com/Tufin/oasdiff/blob/main/BREAKING-CHANGE

## サポートポリシーと非推奨情報

When new versions of the Box APIs and Box SDKs are released, earlier versions will be retired. Box marks a version as `deprecated` at least 24 months before retiring it. In other words, a deprecated version cannot become end-of-life sooner than after 24 months. Similarly, for individual APIs that are generally available (GA), Box declares an API as `deprecated` at least 24 months in advance of removing it from the GA version.
Box APIとBox SDKの新しいバージョンがリリースされると、それより前のバージョンは廃止されます。Boxでは、バージョンを廃止する少なくとも24か月前に、そのバージョンを`deprecated`とマークします。つまり、非推奨バージョンの公式サポートが24か月経たずに終了することはありません。同様に、一般提供 (GA) されている個々のAPIについても、GAバージョンから削除する少なくとも24か月前にそのAPIを`deprecated`と宣言します。

Boxは、APIのメジャーバージョンを上げる際 (`2024.0`から`2025.0`など)、現在のバージョン (この例では`2024.0`) が即座に非推奨となることを発表し、その発表から24か月後にサポートを終了します。サービスのセキュリティや状態の信頼性に問題がある場合は、このポリシーに例外を認めることがあります。

Expand Down
6 changes: 3 additions & 3 deletions guides/api-calls/permissions-and-errors/scopes.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -166,14 +166,14 @@ GET https://account.box.com/api/oauth2/authorize?scope=root_readonly&client_id=.

このスコープでは、アプリケーションに読み取り/書き込みスコープも設定する必要があります。これらのスコープは、有効にしたときに自動的に選択されます。さらに、企業ではSignが有効になっている必要があります。

### Manage Box AI API
### Box AI APIを管理する

| | |
| ---------------- | -------------- |
| **OAuthスコープ** | `AI.readwrite` |
| **アプリケーションスコープ** | Manage AI |
| **アプリケーションスコープ** | AIを管理する |

Gives an application permission to send requests to Box AI API.
アプリケーションには、Box AI APIにリクエストを送信するための権限が付与されます。

### Box Relayを管理する

Expand Down
28 changes: 14 additions & 14 deletions guides/box-ai/ask-questions.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -19,41 +19,41 @@ source_url: >-
https://github.com/box/developer.box.com/blob/main/content/guides/box-ai/ask-questions.md
fullyTranslated: true
---
# Ask questions to Box AI
# Box AIに質問する

<Message type="notice">

Box AI API is a beta feature, which means the available capabilities may change. Box AI API is available to all **Enterprise Plus** customers.
Box AI APIはベータ機能のため、利用可能な機能は変更される可能性があります。Box AI APIは、**Enterprise Plus**をご利用のすべてのお客様が利用できます。

</Message>

Box AI API allows you to ask a question about a supplied file or a set of files, and get a response based on the content. For example, while viewing a document in Box, you can ask Box AI to summarize the content.
Box AI APIを使用すると、指定した1ファイルまたは一連のファイルについて質問し、そのコンテンツに基づいた応答を得ることができます。たとえば、Boxでドキュメントを表示している場合に、Box AIに対して、コンテンツの要約を求めることができます。

## Send a request
## リクエストの送信

To send a request containing your question, use the `POST /2.0/ai/ask` endpoint and provide the mandatory parameters.
質問を含むリクエストを送信するには、`POST /2.0/ai/ask`エンドポイントを使用し、必須のパラメータを指定します。

<Samples id="post_ai_ask">

</Samples>

### 認証

Make sure you have generated the developer token to authorize your app. See [Getting Started with Box AI][prereq] for details.
アプリを承認するための開発者トークンを生成済みであることを確認します。詳細については、[Box AI入門ガイド][prereq]を参照してください。

### パラメータ

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

To make a call, you need to pass the following parameters. Mandatory parameters are in **bold**.
コールを実行するには、以下のパラメータを渡す必要があります。必須のパラメータは**太字**で示されています。

| パラメータ | 説明 | Available values | 例 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`mode`** | The type of request. It can be a question about a single file or a set of files. For multiple files, Box AI API supports up to 1MB of text representation and up to 25 files. | `single_item_qa`, `multiple_item_qa` | `single_item_qa` |
| **`prompt`** | The question about your document or content. | | "What is this document about?" |
| **`items.id`** | The Box file ID you want to provide as input. | | `112233445566` |
| **`items.type`** | The type of the provided input. Currently, it can be a single file or multiple files. | `file` | `file` |
| `items.content` | The content of the item, often the text representation. | | “An application programming interface (API) is a way for two or more computer programs or components to communicate with each other. It is a type of software interface……” |
| パラメータ | 説明 | 使用可能な値 | 例 |
| ---------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------- |
| **`mode`** | リクエストのタイプ。1つのファイルと一連のファイルのどちらに関する質問かを指定できます。複数のファイルの場合、Box AI APIは、最大1 MBのテキストレプリゼンテーション、最大25ファイルをサポートします。 | `single_item_qa`, `multiple_item_qa` | `single_item_qa` |
| **`prompt`** | ドキュメントまたはコンテンツに関する質問。 | | 「これは何に関するドキュメントですか?」 |
| **`items.id`** | 入力データとして指定するBoxファイルID。 | | `112233445566` |
| **`items.type`** | 指定した入力データのタイプ。現在は、1つのファイルまたは複数のファイルを指定できます。 | `file` | `file` |
| `items.content` | 項目のコンテンツ (多くの場合はテキストレプリゼンテーション)。 | | 「アプリケーションプログラミングインターフェース (API) とは、2つ以上のコンピュータプログラムやコンポーネントが互いに通信するための手段です。ソフトウェアインターフェースの一種で......」 |

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

Expand Down
Loading

0 comments on commit c29702a

Please sign in to comment.