リソース: Integration
統合に関する情報。
JSON 表現 |
---|
{ "name": string, "status": enum ( |
フィールド | |
---|---|
name |
出力のみ。統合の一意の識別子。読み取り専用。プラットフォームで定義されます。 |
status |
出力のみ。統合ステータス。 |
共用体フィールド integration_info 。統合に関する詳細情報。integration_info は次のいずれかになります。 |
|
dialogflowEsIntegration |
関連する Dialogflow ES プロジェクトに関する情報(https://cloud.google.com/dialogflow/es/docs) |
dialogflowCxIntegration |
関連する Dialogflow CX プロジェクトに関する情報(https://cloud.google.com/dialogflow/cx/docs/basics) |
agentWebhookIntegration |
エージェントの Webhook に関する情報。エージェント レベルで構成された Webhook は、パートナー レベルで Webhook をオーバーライドします。 |
IntegrationStatus
統合のステータス。
列挙型 | |
---|---|
INTEGRATION_STATUS_UNSPECIFIED |
統合ステータスが指定されていません。 |
ENABLED |
有効です。 |
DISABLED |
無効です。 |
DialogflowEsIntegration
ビジネス メッセージ エージェントと Dialogflow ES プロジェクトの関連付けに関する情報。
JSON 表現 |
---|
{ "dialogflowProjectId": string, "autoResponseStatus": enum ( |
フィールド | |
---|---|
dialogflowProjectId |
必須。Dialogflow プロジェクト ID。 編集できません。この値を変更するには、このエージェントから Dialogflow プロジェクトを削除してから、新しいインテグレーションを作成する必要があります。 |
autoResponseStatus |
必須。 |
dialogflowServiceAccountEmail |
出力のみ。Dialogflow プロジェクトで「Dialogflow コンソール エージェント編集者」ロールと「Dialogflow API クライアント」ロールを付与して構成する必要があるサービス アカウント。これは、Dialogflow API へのアクセスに必要です。 |
operationInfo |
出力のみ。Dialogflow インテグレーションの動作状態に関する情報。 |
dialogflowKnowledgeBases[] |
Dialogflow プロジェクトに関連付けられたナレッジベース。 任意 |
AutoResponseStatus
Dialogflow の自動レスポンスのステータス。
列挙型 | |
---|---|
AUTO_RESPONSE_STATUS_UNSPECIFIED |
自動応答が指定されていません。 |
ENABLED |
自動応答が有効になっています。 |
DISABLED |
自動応答は無効になっています。 |
OperationInfo
Dialogflow のオペレーション情報。
JSON 表現 |
---|
{ "operationName": string, "operationType": enum ( |
フィールド | |
---|---|
operationName |
出力のみ。サーバーによって割り当てられた名前(オペレーション ID)。これは、最初に返された同じサービス内でのみ一意です。 |
operationType |
出力のみ。Dialogflow オペレーション タイプ。 |
operationState |
出力のみ。Dialogflow のオペレーションの状態。 |
error |
出力のみ。エラーの結果(ある場合)。 |
OperationType
Dialogflow オペレーション タイプ。
列挙型 | |
---|---|
OPERATION_TYPE_UNSPECIFIED |
未指定のタイプ。 |
ASSOCIATE_DIALOGFLOW |
Dialogflow を関連付けます。 |
DISSOCIATE_DIALOGFLOW |
Dialogflow を分離します。 |
ADD_DOCUMENT_TO_KNOWLEDGEBASE |
ドキュメントをナレッジベースに追加します。 |
DELETE_DOCUMENT_FROM_KNOWLEDGEBASE |
ナレッジベースからドキュメントを削除します。 |
OperationState
Dialogflow でのオペレーションのステータス。
列挙型 | |
---|---|
OPERATION_STATE_UNSPECIFIED |
未指定の状態 |
PROCESSING |
処理しています。 |
COMPLETED |
完了しました。 |
FAILED |
失敗しました。 |
ステータス
Status
型は、REST API や RPC API など、さまざまなプログラミング環境に適した論理エラーモデルを定義します。gRPC により使用されます。各 Status
メッセージには、エラーコード、エラー メッセージ、エラーの詳細という 3 種類のデータが含まれます。
このエラーモデルと操作方法について詳しくは、API 設計ガイドをご覧ください。
JSON 表現 |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
フィールド | |
---|---|
code |
ステータス コード。 |
message |
デベロッパー向けのエラー メッセージ。英語で記述します。ユーザー向けのエラー メッセージは、ローカライズして |
details[] |
エラーの詳細を保持するメッセージのリスト。API が使用する共通のメッセージ タイプのセットがあります。 任意のデータ型のフィールドを含むオブジェクト。タイプを識別する URI を含むフィールド |
DialogflowKnowledgebase
ナレッジベース情報。ナレッジベースには、よくある質問の URL を複数含めることができます。
JSON 表現 |
---|
{
"name": string,
"displayName": string,
"documents": [
{
object ( |
フィールド | |
---|---|
name |
出力のみ。ナレッジベース ID。 ナレッジベースの作成後に Dialogflow サービスから返される一意の識別子。ブランド ID が「1234」、エージェント ID が「5678」、統合 ID が「9092」、ナレッジベース ID が「1111」の場合、このパラメーターは「brands/1234/agents/5678/integrations/9092/knowledgebases/1111」に解決されます。 |
displayName |
必須。ナレッジベースの表示名。 |
documents[] |
ナレッジベース ドキュメント。 任意 |
updateTime |
出力のみ。ナレッジベースが作成または更新された時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
DialogflowDocument
ナレッジベース ドキュメント。ドキュメントには、ウェブサイトの URL または CSV ファイルの URL を使用できます。URL は一般公開されている必要があります。CSV ファイルには、質問と回答のペアが 1 つ以上含まれ、ペアごとに 1 行ずつ記述する必要があります。
JSON 表現 |
---|
{ "name": string, "displayName": string, "updateTime": string, "operationInfo": { object ( |
フィールド | |
---|---|
name |
システムが生成したドキュメント ID。 ブランド ID が「1234」、エージェント ID が「5678」、統合 ID が「9092」、ナレッジベース ID が「1111」、ドキュメント ID が「2222」の場合、このパラメーターは「brands/1234/agents/5678/integrations/documents2base2/1edge1edge1」に解決されます。 |
displayName |
必須。よくある質問ドキュメントの表示名。 |
updateTime |
出力のみ。ドキュメントが作成または更新された時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
operationInfo |
出力のみ。オペレーション情報は、ドキュメントが既存のナレッジベースに追加された場合にのみ入力されます。 |
共用体フィールド content 。ドキュメントのコンテンツ。content は次のいずれかになります。 |
|
faqUrl |
よくある質問ドキュメントの URL。 |
rawContent |
ドキュメントの未加工のコンテンツ。 Base64 でエンコードされた文字列。 |
DialogflowCxIntegration
ビジネス メッセージ エージェントと Dialogflow CX プロジェクトの関連付けに関する情報。
JSON 表現 |
---|
{ "dialogflowProjectId": string, "dialogflowAgentId": string, "autoResponseStatus": enum ( |
フィールド | |
---|---|
dialogflowProjectId |
必須。Dialogflow プロジェクト ID。 編集できません。この値を変更するには、このエージェントから Dialogflow プロジェクトを削除してから、新しいインテグレーションを作成する必要があります。 |
dialogflowAgentId |
必須。Dialogflow エージェント ID。 |
autoResponseStatus |
必須。 |
dialogflowServiceAccountEmail |
出力のみ。Dialogflow プロジェクトで「Dialogflow コンソール エージェント編集者」ロールと「Dialogflow API クライアント」ロールを付与して構成する必要があるサービス アカウント。これは、Dialogflow API へのアクセスに必要です。 |
operationInfo |
出力のみ。Dialogflow インテグレーションの動作状態に関する情報。 |
AgentWebhookIntegration
ビジネス メッセージ エージェントの Webhook に関する情報。
JSON 表現 |
---|
{ "webhookUri": string, "verificationToken": string } |
フィールド | |
---|---|
webhookUri |
必須。メッセージが配信される Webhook URL。 |
verificationToken |
入力のみ。確認トークン。 |
Methods |
|
---|---|
|
統合を作成する |
|
統合を削除します。 |
|
統合を取得する。 |
|
統合を一覧表示します。 |
|
統合を更新します。 |