---
title: "サードパーティアプリケーションへのSDK統合"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/integrate-sdk-in-third-party-apps/
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
related_links:
  - name: "Catalyst Environments"
    url: /ja/deployment-and-billing/environments/introduction/
  - name: "Catalyst Cloud Scale Authentication"
    url: /ja/cloud-scale/help/authentication/introduction/
  - name: "Catalyst Cloud Scale Stratus"
    url: /ja/cloud-scale/help/stratus/introduction/
---

# サードパーティアプリケーションへのCatalyst Python SDKの統合

Catalyst環境外にデプロイされたアプリケーションで、Catalyst Python SDKのメソッドを統合して使用できます。たとえば、Flaskバックエンド（Catalyst外で実行）を使用するVercelにホストされたReactアプリケーションが、それぞれのPython SDK操作を使用して[Catalyst Cloud Scale Stratus](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/introduction/)にドキュメントをアップロードしたり、Amazon Web Services EC2上で実行されるデータパイプラインが[Catalyst Cloud Scale ZCQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/introduction/)クエリを使用して[Catalyst Cloud Scale Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction/)に顧客データをプッシュしたりできます。

これらは、外部アプリケーションがCatalystプラットフォーム内にデプロイされることなく、Catalystコンポーネントと安全にやり取りできる一般的なユースケースのほんの一例です。

外部アプリケーションとCatalyst Python SDKを統合するためのコードスニペットを提供しています。ただし、アプリケーションにコードを実装する前に、以下の前提条件を確認してください。

### SDK統合の前提条件

外部アプリケーションにCatalyst Python SDKを統合するには、以下の情報が必要です：

* **Project ID:**

[Catalystプロジェクト](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/)の一意の識別子です。

* **ZAID (Zoho Account ID):**

プロジェクトを[Catalyst環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)（[development](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)または[production](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)）にリンクするためにCatalystによって割り当てられる一意のポータル識別子です。

* **Environment:**

Catalystプロジェクトの[ターゲット環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)（[development](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)または[production](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)）です。

* **OAuth資格情報:**

外部アプリケーションがCatalystのセルフクライアントポータルを通じてCatalystコンポーネントにアクセスするための認証と認可に必要です。以下の情報が必要になります：

1. Client ID
2. Client Secret
3. Refresh Token

これらの値を取得した後、アプリケーションへのPython SDKの統合に進むことができます。

### 統合手順

では、これらの値をそれぞれ取得し、コードスニペットで設定する方法を見ていきましょう。

以下に記載された手順に従ってください：

1. **Catalystコンソールでプロジェクトを作成する:** [コンソール](https://console.catalyst.zoho.com/)で、[こちらのヘルプページ](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#create-a-catalyst-project)に記載されている手順を使用して、新しい[Catalystプロジェクト](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#introduction-to-catalyst-projects)を作成できます。

2. **Project IDを取得する:** プロジェクトを作成したら、**Project ID**を控えておく必要があります。Project IDは、プロジェクトの作成時に自動的に作成されるプロジェクトの一意のIDです。

Catalystコンソールの右上にある**Settings**アイコンをクリックすると確認できます。

![click-settings](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-settings.webp)

**Settings**画面で、**Project Settings**に移動し、**General**を選択します。以下のスクリーンショットに示すように、このセクションからProject IDを確認して控えることができます。

![project-id](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/project-id.webp)

3. **ZAIDを取得する:** このセクションで提供されるコードスニペットに、プロジェクトの**ZAID**を含める必要があります。**ZAID**は、プロジェクトを必要なCatalyst環境（[development](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)または[production](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)）にリンクするためにCatalystによって割り当てられる一意のポータル識別子です。

[Catalyst環境の詳細はこちら](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)

ZAIDを取得するには、[Catalyst CloudScale Authentication](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/introduction/)コンポーネントのセットアップが必須です。ただし、アプリケーションの認証フローに使用するかどうかは任意です。ZAIDを取得するには：

i. コンソールで[Catalyst CloudScale](https://docs.catalyst.zoho.com/ja/cloud-scale/)サービスに移動し、**Security & Identity**の下にある**Authentication**を選択します。

![select-authentication](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/select-authentication.webp)

ii. [Native Catalyst Authentication](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/native-catalyst-authentication/introduction/)をセットアップする必要があります。これにより、Catalystが認証プロセス全体を管理し、追加のコーディングやインフラストラクチャ管理が不要になります。

iii. **Set Up**をクリックします。

![click-setup](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-setup.webp)

iv. **Hosted authentication**タイプを選択します。これにより、アプリケーションの専用ページでログイン要素をホストできます。コンソールから認証を設定・デザインすると、Catalystがアプリケーション用にレンダリングし、すべてのバックエンド要件を処理します。

![hosted-authentication](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/hosted-authentication.webp)

v. ログインコンポーネントにサインアップ機能を表示し、新しいユーザーがアプリケーションに登録してアクセスできるようにするには、[Public Signup](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/public-signup/)オプションを有効にする必要があります。詳細なステップバイステップのセットアップガイドについては、[ホスト認証ヘルプページ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/native-catalyst-authentication/hosted-authentication-type/introduction/)を参照してください。

![public-signup](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/public-signup.webp)

vi. 確認画面で、**Yes, proceed**をクリックします。

![confirmation](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/confirmation.webp)

vii. 以下に記載されているサポートされているソーシャルログインオプションのいずれかを有効にし、選択したプロバイダーから対応する**ZAID**値を取得できます。

[特定のソーシャルログインのZAIDを取得する方法はこちら](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/social-logins/configuring-social-logins/)

> **注意:** Google、Microsoft、LinkedIn、FacebookなどのソーシャルログインプロバイダーはZAIDの取得に対応していますが、ZohoログインはこのZAID取得の目的には対応していません。

![socials](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/socials.webp)

[このホスト認証タイプの詳細はこちら](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/native-catalyst-authentication/hosted-authentication-type/introduction/)

4. **セルフクライアントアプリケーションを登録する:** アプリケーションのユーザーに代わってCatalystリソースにアクセスするために、アプリケーションの認証と認可に必要な**Refresh Token**、**Client ID**、**Client Secret**を取得する必要があります。

上記の必要な項目を取得するには、まず[APIコンソール](https://api-console.zoho.com)でアプリケーションをセルフクライアントとして登録する必要があります。

i. APIコンソールにログインし、**Self-client**をクリックします。

![self-client](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/self-client.webp)

ii. アプリケーションがCatalystで実行する必要がある操作に基づいて、セルフクライアントアプリケーションのスコープを設定します。

[利用可能なスコープの詳細はこちら](https://docs.catalyst.zoho.com/ja/api/oauth2/scopes/#Scopes)

iii. 必要なスコープを指定し、適切な説明を追加して、**Create**をクリックします。

![create](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/create.webp)

iv. グラントトークンが生成されます。これは一度きりのプロセスであり、コンソールから再度取得することはできないため、必ずコピーして安全に保存してください。

[グラントトークンの生成の詳細はこちら](https://docs.catalyst.zoho.com/ja/api/oauth2/generate-grant-token/#GenerateGrantToken)

![generated-code](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/generated-code.webp)

v. **Client Secret**タブに切り替えて、Client IDとClient Secretの詳細を控えます。

![client-secret](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/client-secret.webp)

vi. [こちらのヘルプページ](https://docs.catalyst.zoho.com/ja/api/oauth2/generate-access-and-refresh-token/#GenerateAccessandRefreshToken)のリクエストを使用して、アクセストークンとリフレッシュトークンを生成できます。また、[こちらのページ](https://docs.catalyst.zoho.com/ja/api/oauth2/refresh-access-token/#RefreshAccessToken)に記載されている手順を使用して、アクセストークンを更新することもできます。

上記のすべての値を控えた後、以下に示すようにコードスニペットで設定し、Python SDKをアプリケーションに統合できます。以下のコードは、[Catalyst CloudScale Stratus](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/introduction/)からバケットを取得する例で説明しています。

### コードスニペット

```python
import zcatalyst_sdk 
from zcatalyst_sdk import credentials 
from zcatalyst_sdk import types 
from zcatalyst_sdk.types import ICatalystOptions 
from flask import Flask, Request, make_response, jsonify 
from typing import Dict, Literal 
app = Flask(__name__) 
def list_all_buckets(): 
Cred = { 
        "refresh_token": "YOUR_REFRESH_TOKEN", //ここにリフレッシュトークンを入力してください
        "client_id": "CLIENT_ID", //ここにクライアントIDを入力してください
        "client_secret": "CLIENT_SECRET", //ここにクライアントシークレットを入力してください
    } 
project_id = PROJECT_ID //ここにプロジェクトIDを入力してください
project_key = ZAID //ここにZAIDを入力してください
environment = "Development" //"Development"または"Production"を指定してください
catalyst_credential = credentials.RefreshTokenCredential(Cred) 
catalyst_options = ICatalystOptions( 
project_id=project_id, 
project_key=project_key, 
project_domain="https://api.catalyst.zoho.com", 
environment=environment, 
) 
catalystApp = zcatalyst_sdk.initialize_app( 
credential=catalyst_credential, options=catalyst_options, 
name="TaskSDKPython" 
 ) 
stratus = catalystApp.stratus() 
buckets = stratus.list_buckets() 
print(buckets) 
return jsonify({"message": "Success", "bucket_data": buckets}) 
@app.route("/listbuckets", methods=["GET"]) 
def handle_list_all_buckets(): 
return list_all_buckets() 
if __name__ == "__main__": 
with app.app_context(): 
response = handle_list_all_buckets() 
port = 3006 
printf("Server running on http://localhost:{port}") 
app.run(port=port) 

```