MCP Tools Reference: paydeveloper.googleapis.com

ツール: list_google_pay_integrations

特定の販売者 ID に関連付けられているすべての Google Pay 統合の現在のステータスと構成の詳細を返します。統合とドキュメントの審査のステータスに関するフィードバックが即座に提供されます。また、Google Pay & ウォレット コンソール（https://pay.google.com/business/console/)で統合を作成または更新できることをユーザーに伝える必要があります。

次のコードサンプルは、curl を使用して list_google_pay_integrations MCP ツールを呼び出す方法を示しています。

Curl リクエスト 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_google_pay_integrations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

特定の販売者の Google Pay 統合のリストを取得するためのリクエスト メッセージ。

ListGooglePayIntegrationsRequest

JSON 表現 
{
  "merchantId": string
}
フィールド
merchantId

string

必須。統合のリストを取得する販売者 ID。

出力スキーマ

Google Pay 統合のリストを取得するためのレスポンス メッセージ。

ListGooglePayIntegrationsResponse

JSON 表現 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
フィールド
googlePayIntegrations[]

object (GooglePayIntegration)

販売者の Google Pay 統合。

GooglePayIntegration

JSON 表現 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
フィールド
integrationState

enum (IntegrationState)

出力専用。販売者の Google Pay 統合ステータス。
createTime

string (Timestamp format)

出力専用。統合リソースが作成された日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

出力専用。統合リソースが最後に更新された日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
integrationType

enum (IntegrationType)

必須。Google Pay 統合の統合タイプ。
integrationDocuments[]

object (IntegrationDocument)

必須。入力専用。Google Pay 統合の統合ドキュメント。
共用体フィールド item。統合アイテム。次のいずれかを設定する必要があります。item は次のいずれかになります。
webDomain

string

販売者のウェブ ドメイン。
androidAppPackage

string

販売者の Android アプリ パッケージ名。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0 ～ 999,999,999 にする必要があります（両端を含む）。

IntegrationDocument

JSON 表現 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
フィールド
name

string

必須。ドキュメントの名前です。
data

string (bytes format)

必須。ドキュメントのデータ。

Base64 でエンコードされた文字列。
documentType

enum (DocumentType)

必須。ドキュメントのタイプ。
mimeType

enum (MimeType)

必須。ドキュメントの MIME タイプ。

IntegrationState

販売者のウェブ ドメインまたは Android アプリの Google Pay 統合ステータス。

列挙型
INTEGRATION_STATE_UNSPECIFIED 統合ステータスが指定されていません。
NOT_STARTED このステータスは、Android アプリがデベロッパーに関連付けられていて（Google Play ストア）、デベロッパーが統合プロセスを開始していない場合に適用されます。
INCOMPLETE デベロッパーが統合を審査のために送信しておらず、統合が完了していない（サポート ドキュメントが不足しているなど）場合。
READY_FOR_REVIEW デベロッパーが統合を審査のために送信していないが、審査の準備ができている（サポート ドキュメントがアップロードされているなど）場合。
UNDER_REVIEW 統合の有効化リクエストが管理者の審査待ちの場合。
NEED_INFO 審査中に gTech 管理者から統合に関する詳細情報の提供を求められている場合。
ACTIVE 統合が現在有効になっている場合。
DELETED 販売者によって統合が削除された場合。
REJECTED 統合が拒否された場合。

IntegrationType

Google Pay 統合の統合タイプ。

列挙型
INTEGRATION_TYPE_UNSPECIFIED 統合タイプが指定されていません。
DIRECT_INTEGRATION 統合タイプが直接統合の場合。
PAYMENT_SERVICE_PROVIDER 統合タイプが決済サービス プロバイダの場合。

DocumentType

ドキュメントのタイプ。

列挙型
DOCUMENT_TYPE_UNSPECIFIED ドキュメントのタイプが指定されていません。
ITEM_SELECTION_SCREENSHOT ユーザーが商品またはサービスを閲覧している場合。
PRE_PURCHASE_SCREENSHOT ユーザーが購入する準備ができた場合。
PAYMENT_METHOD_SCREENSHOT ユーザーがお支払い方法として Google Pay を選択した場合。
PAYMENT_INFO_SCREENSHOT ユーザーが Google Pay に保存したお支払い情報が表示された場合。ヒント: Android ではこの画面のスクリーンショットを撮影できないため、別のデバイスで画面を撮影してください。
POST_PURCHASE_SCREENSHOT ユーザーが購入手続きを完了した場合。
PCI_ATTESTATION_DOCUMENT PDF 形式の PCI 証明書。

MimeType

ドキュメントの MIME タイプ。

列挙型
MIME_TYPE_UNSPECIFIED MIME タイプが指定されていません。
JPEG MIME タイプが JPEG の場合。
PNG MIME タイプが PNG の場合。
WEBP MIME タイプが WEBP の場合。
PDF MIME タイプが PDF の場合。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを判断するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されています。

  • readOnlyHint: true の場合、ツールはその環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルトは true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌