はじめに - Drive and Photo Service - Alibaba Cloud ドキュメントセンター

aliyun-pds-js-sdk は、Photo and Drive Service (PDS) によって提供される JavaScript 用の SDK です。この SDK を使用すると、PDS リソースに対する基本的な操作を実行できます。開発者はこの SDK を使用して、PDS アプリケーションを簡単に開発できます。この SDK では、アップロード、ダウンロード、コピー、移動、削除などの基本的なファイル操作に加えて、ドライブ、共有ディレクトリ、グループなどのリソースに対する基本的な操作を実行できます。SDK は、ブラウザと Node.js プラットフォーム（Electron や Node など）の両方で使用できます。

GitHub リポジトリ: https://github.com/aliyun/aliyun-pds-js-sdk。

重要

注: Drive and Photo Service SDK for JavaScript V1.0.0 以降では、hosting mode の機能はサポートされていません。

説明

Node.js 依存関係のバージョンは、16.15.0 以降である必要があります。

Drive and Photo Service リソース

次の構造は、ドメイン内のリソースを示しています。

Domain/
  |-- Group                // グループまたはチーム。
  |-- User                 // ユーザー。
  |-- Account              // アカウント。
  |-- Drive                // ドライブ。
  |-- ShareLink            // 共有リンク。
  |-- File                 // ファイル関連のリソース。新しい共有権限とごみ箱が含まれます。

ユーザーは複数のアカウントに関連付けることができます。アカウントは、ユーザーがログオンするために使用されます（例: DingTalk ログオン）。
グループまたはユーザーは、別のグループに入れ子にすることができます。ユーザーはメンバーとしてグループに追加できます。

Group/
  |-- Group
  |-- User

ドライブの所有者は、グループまたはユーザーにすることができます。
ファイルはドライブに属している必要があります。

Drive/          // ドライブ。
  |-- File

インストール

aliyun-pds-js-sdk をインストールするには、次のコマンドを実行します。

npm i -S aliyun-pds-js-sdk

注: Node.js 16.15.0 以降がインストールされていることを確認してください。

インポート

1. Vue または React プロジェクトで SDK を使用する

import {PDSClient} from 'aliyun-pds-js-sdk/browser'

2. Node.js 環境で SDK を使用する

const {PDSClient} = require('aliyun-pds-js-sdk')

3. ブラウザで script タグを使用して SDK をインポートする

npm を使用して SDK をインストールした後、node_modules/aliyun-pds-js-sdk/dist/browser/ ディレクトリにある aliyun-pds-js-sdk.umd.cjs ファイルを静的サーバーまたは Alibaba Cloud CDN (CDN) サービスにコピーし、script タグを使用して SDK をインポートできます。

<script src="/path/to/dist/browser/aliyun-pds-js-sdk.umd.cjs"></script>

const { PDSClient } = window.PDS_SDK

サンプルコード

Drive and Photo Service API の機能は、PDSClient クラスのメソッドを使用して実装されます。機能を使用するには、PDSClient インスタンスを作成する必要があります。その後、インスタンスのメソッドを使用して、Drive and Photo Service の API 操作を呼び出すことができます。

const domain_id = "ドメインの ID" // 例: bj123。
const config = {
   token_info: {...},
   api_endpoint: `https://${domain_id}.api.aliyunpds.com`,
}

const pds = new PDSClient(config)

let { items=[], next_marker } = await pds.listDrives({ limit:10 })

config パラメータを構築する方法の詳細については、PDSClient を参照してください。