MCP Tools Reference: paydeveloper.googleapis.com

ツール: create_google_pay_integration

特定の販売者の Google Pay 統合を作成します。この操作を行うには、ユーザーが Business Console 利用規約と Google Pay API 利用規約に同意している必要があります。これらを事前に確認する必要はありません。同意していない場合、ツール呼び出しは失敗し、エラー メッセージには同意する必要がある特定の利用規約の URL が含まれます。この場合は、同意を求める URL をユーザーに提示し、同意したらもう一度試すように伝えます。ツールを呼び出す前に、次の手順でユーザーとやり取りします。1. まず、統合アイテムをユーザーに尋ねます（現時点ではウェブ統合のみがサポートされています）。 - ウェブサイトの URL を尋ねます。 # - 統合アイテムがアプリ統合の場合は、Android アプリのパッケージ名を尋ねます。2. 次に、統合タイプをユーザーに尋ねます。 - サポートされている支払いサービス プロバイダ（PSP: https://developers.google.com/pay/api#participating-processors）のいずれかを使用している場合は [Gateway] を選択し、それ以外の場合は [Direct] を選択するように伝えます。3. すべての統合タイプ（Direct または Gateway）の場合: - Google Pay API と統合された購入フローのスクリーンショット（最大 1 MB）をアップロードするように伝えます。購入フローが審査され、承認されてから、本番環境へのフルアクセスが付与されます。例: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together- ユーザーに 5 つの補足スクリーンショットを提供するよう依頼する必要があります。正しいマッピングを確保するため、1 つずつ尋ねます。尋ねる際は、わかりやすい列挙型の説明のみを使用します。4. 統合タイプが Direct の場合: - PCI 証明書ドキュメントを PDF 形式で提供するようユーザーに依頼する必要があります。尋ねる際は、わかりやすい列挙型の説明のみを使用します。5. 提供されたファイルごとに、現在のディレクトリにある場合はドキュメントのパスまたは名前を提供するようユーザーに依頼します。正しい DocumentType にマッピングし、リクエストの name フィールドにわかりやすい名前（item_selection.png や pci_attestation.pdf など）を設定します。選択した統合タイプに必要なドキュメントを収集するまで、このツールを呼び出さないでください。

次のサンプルは、curl を使用して create_google_pay_integration 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": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

CreateGooglePayIntegration に対するリクエスト メッセージです。

CreateGooglePayIntegrationRequest

JSON 表現 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
フィールド
merchantId

string

必須。Google Pay 統合を追加する販売者の販売者 ID。
googlePayIntegration

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。統合アイテム。このうちの 1 つを設定する必要があります。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 です。

出力スキーマ

CreateGooglePayIntegration に対するレスポンス メッセージです。

CreateGooglePayIntegrationResponse

JSON 表現 
{
  "integrationState": enum (IntegrationState)
}
フィールド
integrationState

enum (IntegrationState)

Google Pay 統合の統合の状態。

IntegrationState

販売者のウェブ ドメインまたは Android アプリの Google Pay 統合の状態。

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

ツールのアノテーション

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