VitaCloud Quotes (プレビュー)
インスピレーションを与える引用文を毎日アプリケーションやウェブサイトに配信します。 さまざまなテーマや著者からお選びいただけます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | VitaCloud サポート |
| [URL] | https://www.vitacloud.co.uk |
| メール | support@vitacloud.co.uk |
| Connector Metadata | |
|---|---|
| 発行者 | VitaCloud Limited |
| Web サイト | https://www.vitacloud.co.uk |
| プライバシー ポリシー | https://www.vitacloud.co.uk/PrivacyPolicy |
| カテゴリー | ライフスタイルおよびエンターテインメント; 生産性 |
VitaCloud Quotes API は、信仰、神、幸福、希望、ユーモア、インスピレーション、知識、人生の教訓、愛、モチベーション、哲学、詩、人間関係、宗教、ロマンス、科学、時間、真実、知恵などのさまざまなテーマでタグ付けされた、有名な作家や著名人による厳選された名言セットを提供します。 VitaCloud Quotes API コネクタは、VitaCloud Quotes API のラッパーであり、Microsoft Power Automate、Microsoft Power Apps、Azure と Office 365 サブスクリプションの Azure Logic Apps を使用して、カスタマイズされた毎日のランダムな VitaCloud Quote をワークスペースに取り込むことができます。
前提条件
続行するには、次のものが必要です。
- VitaCloud API ベース URL
- VitaCloud API キー
- カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
資格情報の入手方法
このビデオでは、VitaCloud Quotes API をサブスクライブし、API を製品と公式 Office 365 コネクターおよび Web パーツに統合するために必要なサブスクリプション キーとベース URL を取得するプロセスを説明します。
ベース製品 URL と API キーを生成する手順
製品カタログから無料または有料の製品のいずれかを購読する
ポータルでサブスクライブした製品を選択し、 ベース製品URL をコピーします
プロファイル メニューをクリックし、サブスクリプション セクションで同じ製品を選択し、 主 または 副キー の 表示 ボタンをクリックしてコピーします。 これは自分の API キー です
Power Automate と Power Apps の Quotes コネクタに接続するには、ベース商品 URL と API キー が必要です。
VitaCloud Quotes コネクタで開始する
Power Automate で VitaCloud Quotes コネクタからアクションを選択します。
コネクタを初めて使用するときは、次の詳細を提供して接続を作成するように求められます。
- 接続名。 接続の一意の名前を入力します。 E.g. VitaCloud Quotes
- 基本製品 URL。 上のセクションの API ベース URL を生成するビデオと手順を参照してください。
- API キー。 上のセクションの API キー を生成するビデオと手順を参照してください。
プロンプトが表示されたら、選択したアクションのパラメータを入力します。
作成者を取得 アクションとテーマを取得 アクションを使用して、利用可能な authorTags と themeTags を取得できます。
アダプティブ カードを作成してチームのチャネルやグループ チャットに投稿するなど、ダウンストリーム アクションで出力を使用します
またはメールボックスに投稿してください。
コネクタは Power Apps でも使われます。
既知の問題と制限事項
- サブスクリプション製品によっては、一部の機能が制限される場合があることに注意してください。 E.g. VitaCloud Free Quotes 製品のみサブスクライブされた場合、今日の見積もりを取得する アクションと ランダム見積もりを取得する アクションはコネクタで機能します。
- すべてのロックを解除するには、通話割り当て制限に基づいて VitaCloud Quotes Premium または VitaCloud Quotes Ultimate 製品に登録することをお勧めします。コネクタのオプション。
- 引用符の数が必要な操作に指定されていない場合、応答では最大 5 つの引用符が返されます。
- 返される見積もりの数は最大 10 に制限されています。
- 著者によっては、対応する Wikipedia リンクがない場合があります。
- 著者の画像は変更される場合がありますが、同じサイズとアスペクト比が維持されます。
一般的なエラーと解決策
間違ったベース プロダクト URL または API キーが指定された場合、以下のような応答とともに HTTP ステータス コード
404 - not foundが返されます
{"requestId": long string, "message": "No data product found. Please contact your data provider"}
API ポータルから正しいベース プロダクト URL と API キーを使用して接続を更新してください。 上のビデオをご覧ください。ベースプロダクト URL に対応するプロダクトに含まれないアクションが使用された場合、HTTP ステータスコード
403 - forbiddenが返され、以下のような応答が返されます
{"requestId": long string, "message": "Endpoint not available"}
要求された エンドポイント を含む製品に対応する ベース製品 URL を使用して接続を更新します。
よくあるご質問
Web サイトまたはアプリでAPIを直接使用するにはどうすればよいですか ?
製品の API タブで、サブスクライブした API の OpenAPI 3.0 仕様をダウンロードします。
エンドポイントへのリクエストのヘッダーに API キーを含めてください。 API タブで エンドポイントを選択し、ポータルでリクエストを試します。
どのようなテーマと著者が含まれていますか? Quotes コネクタ
Get Themesアクションでは、ユーモア、知恵、科学、インスピレーション、哲学、幸福などの人気のあるテーマを含む 20 以上のテーマから選択できます。 このGet Authorsアクションでは、700 人を超える作家、著名人、著名人の詳細が提供されます。 ほとんどのエンドポイントには、可能な場合は著者の画像とウィキペディアへのリンクも含まれています。
製品に関する質問がある場合、またはサポートが必要な場合はどこに問い合わせればよいですか?
お問い合わせは VitaCloud サポート に送信するか、VitaCloud Web サイト のお問い合わせフォームにご記入ください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| 基本製品 URL | string | https://apis.vitacloud.co.uk または https://apis.vitacloud.co.uk/free | True |
| API Key | securestring | あなたのサブスクリプション キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべてのテーマを取得する |
サンプルリクエスト: GET /Themes |
| すべての作成者を取得する |
更新リクエスト: GET /Authors |
| テーマに対して最大 5 つのランダムな引用を取得します |
リクエストの例: GET /Quotes/Theme/loveまたはGET /Quotes/Theme/love,inspiration |
| テーマの指定された数のランダムな引用符を取得します |
サンプルリクエスト: GET /Quotes/Theme/love,inspire/5 |
| テーマを取得する |
サンプルリクエスト: GET /Themes/happiness |
| ランダムな見積もりを 5 つ入手 |
サンプルリクエスト: GET /Quotes |
| ランダムな見積もりを取得する |
サンプルリクエスト: GET /Quotes/random |
| 今日の見積もりを取得する |
サンプルリクエスト: GET /Quotes/today |
| 作成者の指定された数のランダムな引用符を取得します |
サンプルリクエスト: GET /Quotes/Author/aamilne/5 |
| 作成者を取得する |
更新リクエスト: GET /Authors/aamilne |
| 指定された数のランダムな引用符を取得します |
サンプルリクエスト: GET /Quotes |
| 著者のランダムな引用を 5 つ取得します |
サンプルリクエスト: GET /Quotes/Author/aamilne,mahatmagandhi |
すべてのテーマを取得する
すべての作成者を取得する
テーマに対して最大 5 つのランダムな引用を取得します
リクエストの例: GET /Quotes/Theme/loveまたはGET /Quotes/Theme/love,inspiration
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーマタグ
|
themetag | True | string |
テーマタグまたはテーマ タグのコンマ区切り一覧 |
戻り値
テーマの指定された数のランダムな引用符を取得します
サンプルリクエスト: GET /Quotes/Theme/love,inspire/5
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーマタグ
|
themetag | True | string |
テーマタグまたはテーマ タグのコンマ区切り一覧。 |
|
見積もりの数 (最大 10)
|
number | True | integer |
返すランダム見積もりの数 (最大 10) |
戻り値
テーマを取得する
サンプルリクエスト: GET /Themes/happiness
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーマタグ
|
themetag | True | string |
テーマタグ。 利用可能なテーマタグのリストについては、すべてのテーマを取得アクションを使用してください |
戻り値
- Theme
- VwTheme
ランダムな見積もりを 5 つ入手
ランダムな見積もりを取得する
今日の見積もりを取得する
作成者の指定された数のランダムな引用符を取得します
サンプルリクエスト: GET /Quotes/Author/aamilne/5
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
作成者タグ
|
authortag | True | string |
著者のタグ、または著者タグのカンマ区切りリスト |
|
見積もりの数 (最大 10)
|
number | True | integer |
返すランダム見積もりの数 (最大 10) |
戻り値
作成者を取得する
更新リクエスト: GET /Authors/aamilne
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
作成者タグ
|
authortag | True | string |
作成者タグ。 利用可能な著者タグのリストについては、すべての著者を取得アクションを使用してください |
戻り値
- Author
- VwAuthor
指定された数のランダムな引用符を取得します
サンプルリクエスト: GET /Quotes
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
見積もりの数 (最大 10)
|
number | True | integer |
返すランダム見積もりの数 (最大 10) |
戻り値
著者のランダムな引用を 5 つ取得します
サンプルリクエスト: GET /Quotes/Author/aamilne,mahatmagandhi
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
作成者タグ
|
authortag | True | string |
著者のタグ、または著者タグのカンマ区切りリスト |
戻り値
定義
VwAuthor
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Tag
|
AuthorTag | string |
作成者のタグ |
|
件名
|
AuthorName | string |
作成者の名前 |
|
Image
|
AuthorImage | string |
作成者の画像 |
|
Link
|
AuthorLink | string |
作成者のウィキペディアへのリンク |
VwQuote
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
作成者タグ
|
AuthorTag | string |
作成者のタグ |
|
著者名
|
AuthorName | string |
作成者の名前 |
|
作成者の画像
|
AuthorImage | string |
作成者の画像 |
|
作成者リンク
|
AuthorLink | string |
作成者のウィキペディアへのリンク |
|
Text
|
Quote | string |
見積もりテキスト |
|
Length
|
Length | integer |
見積もりの長さ |
|
テーマタグ
|
ThemeTag | string |
テーマタグ |
|
テーマ名
|
ThemeName | string |
テーマ名 |
VwTheme
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Tag
|
ThemeTag | string |
テーマタグ |
|
件名
|
ThemeName | string |
テーマ名 |
|
見積もりの数
|
ThemeQuotes | integer |
見積もりの数 |