--- title: "Grant Tokenの生成" url: https://docs.catalyst.zoho.com/ja/api/oauth2/generate-grant-token/ description: "保護されたCatalystリソースへの安全なアクセスを得るために、ユーザーが行うAPIリクエストを認証・認可するCatalystが準拠するOAuth 2.0業界標準プロトコルについて" last_updated: 2026-08-17T12:16:04Z service: All Services type: api --- # ステップ2: Grant Tokenの生成 `client\_id`と`client\_secret`を生成した後、アプリケーションのGrant Tokenまたは`code`を生成する必要があります。 > **注意:** Grant Tokenの生成は、Grant Tokenの有効期間内に`access\_token`と`refresh\_token`を生成すれば、1回限りのプロセスです。 ### Self Clientアプリケーションの場合 以前 _Self Client_ タイプを選択した場合、以下の方法でGrant Token（`code`）を生成する必要があります: 1. アプリケーションを登録した後、[APIコンソール](https://api-console.zoho.com/)の _Applications_ リストから**Self Client**を選択し、**Generate Code**をクリックしてください。 ![](https://catalyst-docs-development.zohostratus.in/images/api/catalyst_api_5.webp) 2. 有効なスコープを入力してください。Catalystで利用可能なスコープの一覧は[こちらのセクション](https://docs.catalyst.zoho.com/ja/api/oauth2/scopes/#Scopes)で確認できます。 3. ドロップダウンリストから期間を選択してください。このステップで生成されたGrant Tokenは、この期間後に失効します。 > **注意:** Grant Tokenが失効する前に、次のステップで説明するように`refresh\_token`を生成する必要があります。 4. スコープの説明を入力してください。 5. **Generate**をクリックしてください。 APIコンソールに、_Self Client_ アプリケーション用に生成されたGrant Tokenまたは`code`の値が表示されます。 ![](https://catalyst-docs-development.zohostratus.in/images/api/catalyst_api_6.webp) ### その他のアプリケーションの場合 以前 _Self Client_ タイプ以外のクライアントタイプを選択した場合、リダイレクト方式でGrant Tokenを生成する必要があります: 1. Grant Token（`code`）を生成するために、以下のURIに指定のパラメーターを付けてリクエストを送信してください: `https://accounts.zoho.com/oauth/v2/auth?` > **注意:** 他の[データセンター](https://docs.catalyst.zoho.com/ja/api/introduction/multi-dc-support/#Multi-DCSupport)については、それぞれのドメインにアクセスする必要があります: * **EU:** `https://accounts.zoho.eu/` * **AU:** `https://accounts.zoho.au/` * **IN:** `https://accounts.zoho.in/` * **CA:** `https://accounts.zohocloud.ca/` * **JP:** `https://accounts.zohocloud.jp/` * **SA:** `https://accounts.zohocloud.sa/`
パラメーター 説明
`**scope\***` Grant Tokenを生成するスコープ。カンマで区切ることで複数のスコープを指定できます。Catalystで利用可能なスコープの一覧は[こちらのセクション](https://docs.catalyst.zoho.com/ja/api/oauth2/scopes/#Scopes)で確認できます。
`**client\_id\*** ` クライアント登録時に生成されたClient ID
`**state** ` プロトコル内でラウンドトリップされる不透明な文字列。ここで指定した値がそのまま返されます
`**response\_type\***` `code `（この文字列リテラルを値として指定してください）
`**redirect\_uri\*** ` 前のステップでクライアントを登録する際に指定した認可済みリダイレクトURIの1つ。未登録のredirect URIは指定できません。
`**access\_type** ` 指定可能な値は`offline`と`online`です。onlineの`access\_type`は、1時間有効な`Access Token`のみをアプリケーションに提供します。`offline access\_type`は、`Access Token`と`Refresh Token`の両方をアプリケーションに提供します。デフォルト値は`online`です。
`**prompt** ` `Consent`（この文字列リテラルを値として指定してください）アプリケーションがユーザー資格情報にアクセスしようとするたびに、ユーザーの同意を求めるプロンプトが表示されます。このパラメーターを指定しない場合、ユーザーにはアプリケーションが初めてアクセスをリクエストした時にのみ資格情報の入力が求められます。
> **注意:** * *が付いたフィールドは必須です。 * セキュリティ強化のため、リクエストのボディに`form-data`としてパラメーターを渡すことができます。 **リクエスト例** ```bash https://accounts.zoho.com/oauth/v2/auth?scope=ZohoCatalyst.tables.rows.CREATE,ZohoCatalyst.tables.rows.READ,ZohoCatalyst.tables.rows.UPDATE,ZohoCatalyst.tables.rows.DELETE&client_id=1000.0SRSxxxxxxxxxxxxxxxxx&state=testing&response_type=code&redirect_uri=https://www.zylker.com/ShipmentTracking/&access_type=offline ``` 2. このリクエストで`prompt`パラメーターを送信した場合、ユーザー同意ページが開きます。 **Accept**をクリックすると、Zohoは`code`パラメーターにGrant Tokenを含めて`redirect\_uri`にリダイレクトします。次のステップのために`code`の値を保存してください。 ![](https://catalyst-docs-development.zohostratus.in/images/api/catalyst_api_7.webp) ログイン情報に基づいて、システムが自動的にドメインを検出し、ドメイン固有の認証URLを使用してGrant Tokenを生成します。`state`パラメーターもURLに含まれます。 **Reject**をクリックすると、ブラウザーは`error=access\_denied`パラメーター付きでredirect URIにリダイレクトされます。 > **注意:** このcodeは60秒間のみ有効です。この時間内に次のステップを完了する必要があります。