VitaCloud Quotes (プレビュー)

インスピレーションを与える引用文を毎日アプリケーションやウェブサイトに配信します。 さまざまなテーマや著者からお選びいただけます。

このコネクタは、次の製品および地域で利用可能です:

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 キーを生成する手順

1. VitaCloud API ポータルにサインアップまたはログインします
   

2. 製品カタログから無料または有料の製品のいずれかを購読する
   

3. ポータルでサブスクライブした製品を選択し、 ベース製品URL をコピーします
   

4. プロファイル メニューをクリックし、サブスクリプション セクションで同じ製品を選択し、 主 または 副キー の 表示 ボタンをクリックしてコピーします。 これは自分の API キー です
   

Power Automate と Power Apps の Quotes コネクタに接続するには、ベース商品 URL と API キー が必要です。

VitaCloud Quotes コネクタで開始する

1. Power Automate で VitaCloud Quotes コネクタからアクションを選択します。
   

2. コネクタを初めて使用するときは、次の詳細を提供して接続を作成するように求められます。
   

   • 接続名。 接続の一意の名前を入力します。 E.g. VitaCloud Quotes
   • 基本製品 URL。 上のセクションの API ベース URL を生成するビデオと手順を参照してください。
   • API キー。 上のセクションの API キー を生成するビデオと手順を参照してください。

3. プロンプトが表示されたら、選択したアクションのパラメータを入力します。
   

   作成者を取得 アクションとテーマを取得 アクションを使用して、利用可能な authorTags と themeTags を取得できます。

4. アダプティブ カードを作成してチームのチャネルやグループ チャットに投稿するなど、ダウンストリーム アクションで出力を使用します
   
   またはメールボックスに投稿してください。
   

5. コネクタは 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 が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

アクション

すべてのテーマを取得する

すべての作成者を取得する

テーマに対して最大 5 つのランダムな引用を取得します

テーマの指定された数のランダムな引用符を取得します

テーマを取得する

ランダムな見積もりを 5 つ入手

ランダムな見積もりを取得する

今日の見積もりを取得する

作成者の指定された数のランダムな引用符を取得します

作成者を取得する

指定された数のランダムな引用符を取得します

著者のランダムな引用を 5 つ取得します

定義

VwAuthor

VwQuote

VwTheme