MCP Tools Reference: paydeveloper.googleapis.com

Strumento: list_google_pay_integrations

Restituisce lo stato attuale e i dettagli di configurazione per tutte le integrazioni di Google Pay associate a un ID commerciante specifico. Fornisce un feedback immediato sullo stato dell'integrazione e delle revisioni dei documenti. Inoltre, DEVI informare l'utente che l'integrazione può essere creata/aggiornata in Google Pay & Wallet Console (https://pay.google.com/business/console/).

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP list_google_pay_integrations.

Richiesta 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
}'

Schema di input

Messaggio di richiesta per elencare le integrazioni di Google Pay per un commerciante specifico.

ListGooglePayIntegrationsRequest

Rappresentazione JSON 
{
  "merchantId": string
}
Campi
merchantId

string

Obbligatorio. L'ID commerciante per il quale elencare le integrazioni.

Schema di output

Messaggio di risposta per l'elenco delle integrazioni di Google Pay.

ListGooglePayIntegrationsResponse

Rappresentazione JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Campi
googlePayIntegrations[]

object (GooglePayIntegration)

Le integrazioni di Google Pay del commerciante.

GooglePayIntegration

Rappresentazione 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.
}
Campi
integrationState

enum (IntegrationState)

Solo output. Lo stato di integrazione di Google Pay del commerciante.
createTime

string (Timestamp format)

Solo output. La data di creazione della risorsa di integrazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Data e ora dell'ultimo aggiornamento della risorsa di integrazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Obbligatorio. Il tipo di integrazione dell'integrazione con Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Obbligatorio. Solo input. Documenti di integrazione per l'integrazione con Google Pay.
Campo unione item. L'elemento di integrazione. Uno di questi deve essere impostato. item può essere solo uno dei seguenti tipi:
webDomain

string

Il dominio web del commerciante.
androidAppPackage

string

Il nome del pacchetto app per Android del commerciante.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC trascorsi dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

IntegrationDocument

Rappresentazione JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Campi
name

string

Obbligatorio. Il nome del documento.
data

string (bytes format)

Obbligatorio. I dati del documento.

Una stringa con codifica in base64.
documentType

enum (DocumentType)

Obbligatorio. Il tipo di documento.
mimeType

enum (MimeType)

Obbligatorio. Il tipo MIME del documento.

IntegrationState

Lo stato di integrazione di Google Pay di un dominio web del commerciante o di un'app per Android.

Enum
INTEGRATION_STATE_UNSPECIFIED Lo stato dell'integrazione non è specificato.
NOT_STARTED Questo stato indica che l'app per Android è associata allo sviluppatore (sul Play Store) e che lo sviluppatore non ha avviato alcuna procedura di integrazione.
INCOMPLETE Lo sviluppatore non ha ancora inviato l'integrazione per la revisione e non è completa (ad es. mancano documenti di supporto).
READY_FOR_REVIEW Lo sviluppatore non ha ancora inviato l'integrazione per la revisione, ma è pronta (ad esempio, sono stati caricati i documenti di supporto).
UNDER_REVIEW La richiesta di attivazione dell'integrazione è in attesa di revisione da parte dell'amministratore.
NEED_INFO Durante la revisione, l'integrazione richiede ulteriori informazioni da parte dell'amministratore gTech.
ACTIVE L'integrazione è attualmente attiva.
DELETED L'integrazione viene eliminata dal commerciante.
REJECTED L'integrazione viene rifiutata.

IntegrationType

Il tipo di integrazione di un'integrazione Google Pay.

Enum
INTEGRATION_TYPE_UNSPECIFIED Il tipo di integrazione non è specificato.
DIRECT_INTEGRATION Il tipo di integrazione è l'integrazione diretta.
PAYMENT_SERVICE_PROVIDER Il tipo di integrazione è il fornitore di servizi di pagamento.

DocumentType

Il tipo di documento.

Enum
DOCUMENT_TYPE_UNSPECIFIED Il tipo di documento non è specificato.
ITEM_SELECTION_SCREENSHOT Quando un utente sta sfogliando un articolo o un servizio.
PRE_PURCHASE_SCREENSHOT Quando un utente è pronto per effettuare un acquisto.
PAYMENT_METHOD_SCREENSHOT Quando un utente seleziona Google Pay come metodo di pagamento.
PAYMENT_INFO_SCREENSHOT Quando a un utente vengono mostrati i dati di pagamento che ha salvato su Google Pay. Suggerimento: Android non ti consente di acquisire uno screenshot di questa schermata, quindi scatta una foto della schermata utilizzando un altro dispositivo.
POST_PURCHASE_SCREENSHOT Quando un utente ha effettuato un acquisto.
PCI_ATTESTATION_DOCUMENT Documento di attestazione PCI in formato PDF.

MimeType

Il tipo MIME di un documento.

Enum
MIME_TYPE_UNSPECIFIED Il tipo MIME non è specificato.
JPEG Il tipo MIME è JPEG.
PNG Il tipo MIME è PNG.
WEBP Il tipo MIME è WEBP.
PDF Il tipo MIME è PDF.

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare a un utente una richiesta di conferma.

Oltre alla stringa del titolo, sono definiti i seguenti suggerimenti booleani:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se il valore è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, chiamare ripetutamente lo strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌