MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: list_google_pay_integrations

Trả về trạng thái hiện tại và thông tin chi tiết về cấu hình cho tất cả các hoạt động tích hợp Google Pay được liên kết với một Mã người bán cụ thể. Tính năng này cung cấp ý kiến phản hồi ngay lập tức về trạng thái tích hợp và đánh giá tài liệu. Ngoài ra, BẠN PHẢI thông báo cho người dùng rằng họ có thể tạo/cập nhật chế độ tích hợp trong Bảng điều khiển Google Pay và Wallet (https://pay.google.com/business/console/).

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ list_google_pay_integrations MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu liệt kê các dịch vụ tích hợp Google Pay cho một người bán cụ thể.

ListGooglePayIntegrationsRequest

Biểu diễn dưới dạng JSON 
{
  "merchantId": string
}
Trường
merchantId

string

Bắt buộc. Mã người bán để liệt kê các mối tích hợp.

Giản đồ đầu ra

Thông báo phản hồi để liệt kê các công cụ tích hợp Google Pay.

ListGooglePayIntegrationsResponse

Biểu diễn dưới dạng JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Trường
googlePayIntegrations[]

object (GooglePayIntegration)

Các dịch vụ tích hợp Google Pay của người bán.

GooglePayIntegration

Biểu diễn dưới dạng 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.
}
Trường
integrationState

enum (IntegrationState)

Chỉ có đầu ra. Trạng thái tích hợp Google Pay của người bán.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo tài nguyên tích hợp.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm gần đây nhất tài nguyên tích hợp được cập nhật.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Bắt buộc. Loại tích hợp của tính năng tích hợp Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Bắt buộc. Chỉ có đầu vào. Tài liệu tích hợp của tính năng tích hợp Google Pay.
Trường nhóm item. Mục tích hợp. Bạn phải đặt một trong những giá trị này. item chỉ có thể là một trong những trạng thái sau:
webDomain

string

Miền web của người bán.
androidAppPackage

string

Tên gói ứng dụng Android của người bán.

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây theo giờ UTC kể từ thời gian Unix 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của thời lượng, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

IntegrationDocument

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Trường
name

string

Bắt buộc. Tên của tài liệu.
data

string (bytes format)

Bắt buộc. Dữ liệu của tài liệu.

Một chuỗi được mã hoá base64.
documentType

enum (DocumentType)

Bắt buộc. Loại tài liệu.
mimeType

enum (MimeType)

Bắt buộc. Loại MIME của tài liệu.

IntegrationState

Trạng thái tích hợp Google Pay của một miền web hoặc ứng dụng Android của người bán.

Enum
INTEGRATION_STATE_UNSPECIFIED Trạng thái tích hợp chưa được chỉ định.
NOT_STARTED Trạng thái này là khi ứng dụng Android được liên kết với nhà phát triển (trên Cửa hàng Play) và nhà phát triển chưa bắt đầu quy trình tích hợp nào cho ứng dụng đó.
INCOMPLETE Nhà phát triển chưa gửi yêu cầu xem xét việc tích hợp và việc tích hợp này cũng chưa hoàn tất (ví dụ: thiếu tài liệu hỗ trợ).
READY_FOR_REVIEW Nhà phát triển chưa gửi yêu cầu xem xét việc tích hợp nhưng đã sẵn sàng để xem xét (ví dụ: đã tải tài liệu hỗ trợ lên).
UNDER_REVIEW Yêu cầu bật tính năng tích hợp đang chờ quản trị viên xem xét.
NEED_INFO Quá trình tích hợp cần thêm thông tin của quản trị viên gTech trong quá trình xem xét.
ACTIVE Tiện ích tích hợp hiện đang hoạt động.
DELETED Người bán đã xoá chế độ tích hợp.
REJECTED Yêu cầu tích hợp bị từ chối.

IntegrationType

Loại tích hợp của một chế độ tích hợp Google Pay.

Enum
INTEGRATION_TYPE_UNSPECIFIED Chưa xác định loại tích hợp.
DIRECT_INTEGRATION Loại tích hợp là tích hợp trực tiếp.
PAYMENT_SERVICE_PROVIDER Loại tích hợp là nhà cung cấp dịch vụ thanh toán.

DocumentType

Loại tài liệu.

Enum
DOCUMENT_TYPE_UNSPECIFIED Loại giấy tờ chưa được chỉ định.
ITEM_SELECTION_SCREENSHOT Khi người dùng đang duyệt xem một mặt hàng hoặc dịch vụ.
PRE_PURCHASE_SCREENSHOT Khi người dùng đã sẵn sàng mua hàng.
PAYMENT_METHOD_SCREENSHOT Khi người dùng chọn Google Pay làm phương thức thanh toán.
PAYMENT_INFO_SCREENSHOT Khi người dùng nhìn thấy thông tin thanh toán mà họ đã lưu vào Google Pay. Lưu ý: Android sẽ không cho phép bạn chụp ảnh màn hình này, vì vậy, hãy dùng một thiết bị khác để chụp ảnh màn hình.
POST_PURCHASE_SCREENSHOT Khi người dùng đã thực hiện giao dịch mua thành công.
PCI_ATTESTATION_DOCUMENT Tài liệu chứng thực PCI ở định dạng PDF.

MimeType

Loại MIME của một tài liệu.

Enum
MIME_TYPE_UNSPECIFIED Loại mime chưa được chỉ định.
JPEG Loại MIME là JPEG.
PNG Loại MIME là PNG.
WEBP Loại mime là WEBP.
PDF Loại MIME là PDF.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌