Quadrato

Il connettore Square ti consente di eseguire azioni di inserimento, eliminazione, aggiornamento e lettura sui dati di Square.

Versioni supportate

Questo connettore supporta Square versione 1.0.

Prima di iniziare

Prima di utilizzare il connettore Square, esegui le seguenti operazioni:

  • Nel tuo progetto Google Cloud:
    • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
    • Concedi i seguenti ruoli IAM al account di servizio che vuoi utilizzare per il connettore:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente non umano che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Per ulteriori informazioni, vedi Creazione di un service account.

    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Per capire come abilitare i servizi, consulta Abilitazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti viene chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione separata per ciascuna. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e poi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
  3. Nella sezione Posizione, scegli la posizione per la connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su AVANTI.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona Square dall'elenco dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono superare i 49 caratteri.
    4. Descrizione: inserisci una descrizione per l'istanza di connessione.
    5. (Facoltativo) Abilita Cloud Logging, quindi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
    6. Service Account: seleziona un account di servizio con i ruoli richiesti.
    7. Schema: specifica lo schema per la connessione, ad esempio v1 o v2.
    8. Utilizza sandbox: specifica se utilizzare l'ambiente sandbox per la connessione.
    9. ID località: specifica l'ID località per la connessione.
    10. (Facoltativo) Configura le impostazioni del nodo di connessione:

      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, viceversa, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta la sezione Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una migliore disponibilità) e i nodi massimi sono impostati su 50.

    11. + AGGIUNGI ETICHETTA Fai clic qui per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    12. Fai clic su AVANTI.
  5. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.

      La connessione Square supporta i seguenti tipi di autenticazione:

      • OAuth 2.0 - Authorization Code
      • Token di accesso personale

      Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

    2. Fai clic su AVANTI.
  6. Rivedi: rivedi i dettagli di connessione e autenticazione.
  7. Fai clic su Crea.

Configura l'autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

  • OAuth 2.0 - Codice di autorizzazione
    • ID client: inserisci l'ID client da utilizzare per la connessione.
    • Ambiti: inserisci un elenco separato da virgole degli ambiti che ti interessano.
    • Client secret: inserisci il client secret da utilizzare per la connessione a Square.
    • Versione del secret: seleziona la versione del secret per il secret selezionato in precedenza.
    • URL di autorizzazione: inserisci l'URL di autorizzazione generato durante la creazione del client.
    • Enable Authentication Override (Abilita override autenticazione): specifica se abilitare l'override dell'autenticazione per la connessione.
  • Token di accesso personale
    • Token di accesso personale: inserisci il token di accesso personale da utilizzare per la connessione.
    • Versione del secret: seleziona la versione del secret per il secret selezionato in precedenza.
    • Enable Authentication Override (Abilita override autenticazione): specifica se abilitare l'override dell'autenticazione per la connessione.

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

OAuth 2.0 - Tipo di connessione con codice di autorizzazione

Nome campo Dettagli
Località us-central1
Connettore Quadrato
Versione del connettore 1
Nome collegamento square-oauth-ai
Abilita Cloud Logging true
Service account my-service-account@my-project.iam.gserviceaccount.com
Schema v2
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione OAuth 2.0 - Authorization Code
ID client CLIENT_ID
Ambiti BANK_ACCOUNTS_READ, CASH_DRAWER_READ, CUSTOMERS_READ, CUSTOMERS_WRITE, DEVICE_CREDENTIAL_MANAGEMENT, EMPLOYEES_READ, EMPLOYEES_WRITE, INVENTORY_READ, INVENTORY_WRITE, ITEMS_READ, ITEMS_WRITE, LOYALTY_READ, LOYALTY_WRITE, MERCHANT_PROFILE_READ, ORDERS_READ, ORDERS_WRITE, PAYMENTS_READ, PAYMENTS_WRITE, PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS, PAYMENTS_WRITE_IN_PERSON, SETTLEMENTS_READ, TIMECARDS_READ, TIMECARDS_WRITE, TIMECARDS_SETTINGS_READ, TIMECARDS_SETTINGS_WRITE, APPOINTMENTS_READ, APPOINTMENTS_WRITE, APPOINTMENTS_BUSINESS_SETTINGS_READ, INVOICES_READ, INVOICES_WRITE, SUBSCRIPTIONS_READ, SUBSCRIPTIONS_WRITE, DISPUTES_READ, DISPUTES_WRITE, GIFTCARDS_READ, GIFTCARDS_WRITE, ONLINE_STORE_SNIPPETS_WRITE, ONLINE_STORE_SNIPPETS_READ, ONLINE_STORE_SITE_READ, PAYMENTS_WRITE_SHARED_ONFILE, APPOINTMENTS_ALL_READ, APPOINTMENTS_ALL_WRITE, MERCHANT_PROFILE_WRITE, VENDOR_READ, VENDOR_WRITE, PAYOUTS_READ, DEVICES_READ
Client secret CLIENT_SECRET
Versione secret 1
URL di autorizzazione https://connect.squareup.com/oauth2/authorize

Tipo di connessione con token di accesso personale

Nome campo Dettagli
Località asia-east1
Connettore Quadrato
Versione del connettore 1
Nome collegamento square-pat-prod-conn
Abilita Cloud Logging true
Service account my-service-account@my-project.iam.gserviceaccount.com
Schema v2
Utilizzare la sandbox true
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione Token di accesso personale
Token di accesso personale PERSONAL_ACCESS_TOKEN
Versione secret 1

Limitazioni di sistema

Il connettore Square può elaborare un massimo di 16 transazioni al secondo, per nodo e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Utilizzare la connessione Square in un'integrazione

Una volta creata la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per capire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
  • Per capire come creare e utilizzare l'attività Connettori in Application Integration, vedi Attività Connettori.

Azioni

Questa sezione mostra come eseguire alcune delle azioni in questo connettore.

Azione CancelPayment

Questa azione annulla un pagamento.

Parametri di input dell'azione CancelPayment

Nome parametro Tipo di dati Obbligatorio Descrizione
PaymentId Stringa Vero L'ID del pagamento da annullare.

Per un esempio su come configurare l'azione CancelPayment, consulta Esempi.

Azione CompletePayment

Questa azione completa un pagamento.

Parametri di input dell'azione CompletePayment

Nome parametro Tipo di dati Obbligatorio Descrizione
PaymentId Stringa Vero L'ID del pagamento da completare.

Per un esempio su come configurare l'azione CompletePayment, consulta Esempi.

Azione CancelPaymentByIdempotencyKey

Questa azione annulla un pagamento utilizzando la relativa chiave di idempotenza.

Parametri di input dell'azione CancelPaymentByIdempotencyKey

Nome parametro Tipo di dati Obbligatorio Descrizione
IdempotencyKey Stringa Vero La chiave di idempotenza utilizzata per identificare il pagamento da annullare.

Per un esempio su come configurare l'azione CancelPaymentByIdempotencyKey, consulta Esempi.

Azione CancelInvoice

Questa azione annulla una fattura.

Parametri di input dell'azione CancelInvoice

Nome parametro Tipo di dati Obbligatorio Descrizione
InvoiceId Stringa Vero L'ID della fattura da annullare.
InvoiceVersion Stringa Vero La versione della fattura da annullare.

Per un esempio su come configurare l'azione CancelInvoice, consulta Esempi.

Azione PublishInvoice

Questa azione pubblica una fattura.

Parametri di input dell'azione PublishInvoice

Nome parametro Tipo di dati Obbligatorio Descrizione
InvoiceId Stringa Vero L'ID della fattura da pubblicare.
InvoiceVersion Int32 Vero La versione della fattura da pubblicare. Deve corrispondere alla versione attuale della fattura, altrimenti la richiesta viene rifiutata.

Per un esempio su come configurare l'azione PublishInvoice, consulta Esempi.

Azione DeleteInvoiceAttachment

Questa azione elimina un allegato della fattura.

Parametri di input dell'azione DeleteInvoiceAttachment

Nome parametro Tipo di dati Obbligatorio Descrizione
InvoiceId Stringa Vero L'ID della fattura che contiene l'allegato da eliminare.
AttachmentId Stringa Vero L'ID dell'allegato da eliminare.

Per un esempio su come configurare l'azione DeleteInvoiceAttachment, consulta Esempi.

Azione CancelSubscriptions

Questa azione annulla un abbonamento.

Parametri di input dell'azione CancelSubscriptions

Nome parametro Tipo di dati Obbligatorio Descrizione
ID Stringa Vero L'ID dell'abbonamento da annullare.

Per un esempio su come configurare l'azione CancelSubscriptions, consulta Esempi.

Esempi di azioni

Questa sezione mostra come eseguire alcuni degli esempi di azioni in questo connettore.

Esempio: annullare un pagamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CancelPayment, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "PaymentId": "P7eOGiuAYV8CfcLxSXHuUsedBRMZY"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [
  {
    "Success": true
  }
]

Esempio: completare un pagamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CompletePayment, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "PaymentId": "JiZRuypGuu4B7OOoPhL3kYg9YZaZY"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [{
"Success": true
}]

Esempio: annullamento di un pagamento utilizzando una chiave di idempotenza

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CancelPaymentByIdempotencyKey, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "IdempotencyKey": "8b3e387b-a4d8-480c-a871-1c5fdcfd82cd"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [{
"Success": true
}]

Esempio: annullare una fattura

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CancelInvoice, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
"InvoiceId": "inv:0-ChCdONOpvkOxnZ64VuiDwLQ4EPgO",
"InvoiceVersion": "2"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [
  {
    "invoice_id": "inv:0-ChCdONOpvkOxnZ64VuiDwLQ4EPgO",
    "invoice_version": "3",
    "invoice_location_id": "LSHW80WV4KB06",
    "invoice_order_id": "dfChzstnmPfPGdEIFQ6ulRFdOf4F",
    "invoice_payment_requests_uid": "28ff79b1-16de-4c82-bb88-3f4e02be68c5",
    "invoice_payment_requests_request_type": "BALANCE",
    "invoice_payment_requests_due_date": "2025-11-26",
    "invoice_payment_requests_tipping_enabled": "true",
    "invoice_payment_requests_computed_amount_money_amount": "60",
    "invoice_payment_requests_computed_amount_money_currency": "USD",
    "invoice_payment_requests_total_completed_amount_money_amount": "0",
    "invoice_payment_requests_total_completed_amount_money_currency": "USD",
    "invoice_payment_requests_reminders_uid": "ae64a254-d516-4014-aea2-5fee42ec7457",
    "invoice_payment_requests_reminders_relative_scheduled_days": "1",
    "invoice_payment_requests_reminders_message": "Your invoice is almost due",
    "invoice_payment_requests_reminders_status": "NOT_APPLICABLE",
    "invoice_payment_requests_automatic_payment_source": "NONE",
    "invoice_primary_recipient_customer_id": "5BH2SYXX0G87A7NBYZKKJJTDVG",
    "invoice_primary_recipient_given_name": "Postman",
    "invoice_primary_recipient_family_name": "Test",
    "invoice_primary_recipient_email_address": "Charlie.Cruz@altostrat.com",
    "invoice_primary_recipient_phone_number": "1-212-555-4240",
    "invoice_primary_recipient_company_name": "Square",
    "invoice_primary_recipient_address_address_line_1": "500 Electric Ave",
    "invoice_primary_recipient_address_address_line_2": "Suite 600",
    "invoice_primary_recipient_address_locality": "New York",
    "invoice_primary_recipient_address_administrative_district_level_1": "NY",
    "invoice_primary_recipient_address_postal_code": "10003",
    "invoice_primary_recipient_address_country": "US",
    "invoice_invoice_number": "00000001",
    "invoice_title": "Invoice Update",
    "invoice_description": "Updating invoice",
    "invoice_public_url": "https://app.squareupsandbox.com/pay-invoice/invtmp:8779596a-2c13-4cf0-ab21-05eb6a1d03ef",
    "invoice_status": "CANCELED",
    "invoice_timezone": "UTC",
    "invoice_created_at": "2025-06-11T09:19:10Z",
    "invoice_updated_at": "2025-06-11T09:57:24Z",
    "invoice_accepted_payment_methods_card": "true",
    "invoice_accepted_payment_methods_square_gift_card": "true",
    "invoice_accepted_payment_methods_bank_account": "true",
    "invoice_accepted_payment_methods_buy_now_pay_later": "true",
    "invoice_accepted_payment_methods_cash_app_pay": "true",
    "invoice_delivery_method": "EMAIL",
    "invoice_store_payment_method_enabled": "true",
    "success": true
  }
]

Esempio: pubblicare una fattura

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione PublishInvoice, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "InvoiceId": "inv:0-ChCdONOpvkOxnZ64VuiDwLQ4EPgO",
  "InvoiceVersion": 1
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [
  {
    "invoice_id": "inv:0-ChCdONOpvkOxnZ64VuiDwLQ4EPgO",
    "invoice_version": "2",
    "invoice_location_id": "LSHW80WV4KB06",
    "invoice_order_id": "dfChzstnmPfPGdEIFQ6ulRFdOf4F",
    "invoice_payment_requests_uid": "28ff79b1-16de-4c82-bb88-3f4e02be68c5",
    "invoice_payment_requests_request_type": "BALANCE",
    "invoice_payment_requests_due_date": "2025-11-26",
    "invoice_payment_requests_tipping_enabled": "true",
    "invoice_payment_requests_computed_amount_money_amount": "60",
    "invoice_payment_requests_computed_amount_money_currency": "USD",
    "invoice_payment_requests_total_completed_amount_money_amount": "0",
    "invoice_payment_requests_total_completed_amount_money_currency": "USD",
    "invoice_payment_requests_reminders_uid": "ae64a254-d516-4014-aea2-5fee42ec7457",
    "invoice_payment_requests_reminders_relative_scheduled_days": "1",
    "invoice_payment_requests_reminders_message": "Your invoice is almost due",
    "invoice_payment_requests_reminders_status": "PENDING",
    "invoice_payment_requests_automatic_payment_source": "NONE",
    "invoice_primary_recipient_customer_id": "5BH2SYXX0G87A7NBYZKKJJTDVG",
    "invoice_primary_recipient_given_name": "Postman",
    "invoice_primary_recipient_family_name": "Test",
    "invoice_primary_recipient_email_address": "Charlie.Cruz@altostrat.com",
    "invoice_primary_recipient_phone_number": "1-212-555-4240",
    "invoice_primary_recipient_company_name": "Square",
    "invoice_primary_recipient_address_address_line_1": "500 Electric Ave",
    "invoice_primary_recipient_address_address_line_2": "Suite 600",
    "invoice_primary_recipient_address_locality": "New York",
    "invoice_primary_recipient_address_administrative_district_level_1": "NY",
    "invoice_primary_recipient_address_postal_code": "10003",
    "invoice_primary_recipient_address_country": "US",
    "invoice_invoice_number": "00000001",
    "invoice_title": "Invoice Update",
    "invoice_description": "Updating invoice",
    "invoice_public_url": "https://app.squareupsandbox.com/pay-invoice/invtmp:8779596a-2c13-4cf0-ab21-05eb6a1d03ef",
    "invoice_next_payment_amount_money_amount": "60",
    "invoice_next_payment_amount_money_currency": "USD",
    "invoice_status": "UNPAID",
    "invoice_timezone": "UTC",
    "invoice_created_at": "2025-06-11T09:19:10Z",
    "invoice_updated_at": "2025-06-11T09:52:13Z",
    "invoice_accepted_payment_methods_card": "true",
    "invoice_accepted_payment_methods_square_gift_card": "true",
    "invoice_accepted_payment_methods_bank_account": "true",
    "invoice_accepted_payment_methods_buy_now_pay_later": "true",
    "invoice_accepted_payment_methods_cash_app_pay": "true",
    "invoice_delivery_method": "EMAIL",
    "invoice_store_payment_method_enabled": "true",
    "success": true
  }
]

Esempio: eliminare un allegato di fattura

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DeleteInvoiceAttachment, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "InvoiceId": "inv:0-ChBGMewfnhndQBmYdpW0sp3uEPgO",
  "AttachmentId": "inva:0-ChBsWWogZxWt0bRCqCdHkJJO"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [{
"Success": true
}]

Esempio: annullare un abbonamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CancelSubscriptions, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "Id": "40da986b-08e4-45bf-9ba2-d11cf9f589fb"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [{
"Success": true,
"Status": "CANCELED"

}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elencare tutti i pagamenti

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Payments dall'elenco Entity.
  3. Seleziona l'operazione List, poi fai clic su Fine.
  4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base ai tuoi requisiti di filtraggio.

    5. Devi utilizzare gli apici singoli ("'") per racchiudere il valore di una filterClause. Puoi utilizzare filterClause per filtrare i record in base alle colonne.

Esempio: visualizzare i dettagli di pagamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Payments dall'elenco Entity.
  3. Seleziona l'operazione Get, quindi fai clic su Fine.
  4. Imposta entityId su "bb4756c7-38c0-426b-97aa-03b6443e7f16", ovvero la chiave da trasferire.
  5. Per impostare entityId, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci "bb4756c7-38c0-426b-97aa-03b6443e7f16" nel campo Input Value e scegli entityId come variabile locale.

    6. Il valore di entityId deve essere passato direttamente, ad esempio "bb4756c7-38c0-426b-97aa-03b6443e7f16". Qui, "bb4756c7-38c0-426b-97aa-03b6443e7f16" è il valore univoco della chiave primaria.

    Se il passaggio di un singolo entityId genera un errore a causa della presenza di due chiavi composite, puoi utilizzare filterClause per passare il valore.

Esempio: eliminare un pagamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Payments dall'elenco Entity.
  3. Seleziona l'operazione Delete, quindi fai clic su Fine.
  4. Imposta entityId su "62008bbe-effa-4341-9d29-eac7f67b84fe", ovvero la chiave da trasferire.
  5. Per impostare entityId, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, poi inserisci "62008bbe-effa-4341-9d29-eac7f67b84fe" nel campo Valore di input e scegli entityId come variabile locale.

    6. Se l'entità ha due chiavi aziendali o primarie composite, anziché specificare entityId, puoi anche impostare filterClause su id='62008bbe-effa-4341-9d29-eac7f67b84fe'.

Esempio: creare un pagamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Payments dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli entityId o connectorInputPayload come variabile locale. 
    {
  "ShippingAddressLine1": "Paris",
  "BillingAddressFirstName": "Charlie",
  "SourceId": "cnon:card-nonce-ok",
  "BankName": "Altostrat bank",
  "MoneyAmount": 7,
  "MoneyCurrency": "USD",
  "IdempotencyKey": "ab5c8c43-eaba-474e-935c-268ea3ae453a"
}

    Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    {
  "Id": "BY8GnuLixAdrbr93m8nYHDgONxZZY"
}

Esempio: creare un rimborso

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Refunds dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli entityId o connectorInputPayload come variabile locale. 
    {
  "PaymentId": "50yXsd0oousMgYUv0372RkIdJnRZY",
  "RefundedMoneyAmount": 72,
  "RefundedMoneyCurrency": "USD"
}

    Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    {
  "Success": true
}

Esempio: creare un abbonamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Subscriptions dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli entityId o connectorInputPayload come variabile locale. 
    {
  "LocationId": "LSHW80WV4KB06",
  "CustomerId": "TE9VCZMC369HVA2RVBCEKTDQ6G",
  "PlanId": "OEVRZUHD5C42W7VQUT22WURN",
  "Ordinal": 0,
  "OrderTemplateId": "d9ZVzcjiHVc2Ugd0bzlE7yZT9g4F"
}

    Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    {
  "Id": "40da986b-08e4-45bf-9ba2-d11cf9f589fb"
}

Esempio: creare un cliente

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Customers dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli entityId o connectorInputPayload come variabile locale. 
    {
  "FamilyName": "LastName",
  "GivenName": "FirstName"
}

    Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    {
  "Id": "X8883DFR5M4AXGEKRSCFE3F2M9"
}

Esempio: creare una carta regalo

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona GiftCards dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli entityId o connectorInputPayload come variabile locale. 
    
{
  "Type": "DIGITAL",
  "LocationId": "LSHW80WV4KB06"
}

    Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    {
  "Id": "X8883DFR5M4AXGEKRSCFE3F2M0"
}

Esempio: aggiornare una fattura

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Invoices dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale. 
    {
  "Title": "Invoice Update",
  "Description": "Update Invoice",
  "Version": 0
}
  5. Imposta entityId in Data Mapper sull'entità delle fatture.
  6. Per impostare entityId, fai clic su Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su 'inv:0-ChCdONOpvkOxnZ64VuiDwLQ4EPgO'.

    L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

    { }

Esempio: aggiornare un abbonamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Subscriptions dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale. 
    {
  "Note": "Update Subscription"
}
  5. Imposta entityId in Data Mapper sull'entità degli abbonamenti.
  6. Per impostare entityId, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su '40da986b-08e4-45bf-9ba2-d11cf9f589fb'.

    L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

    { }

Esempio: aggiornare i dettagli di pagamento

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona PayOuts dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale. 
    {
  "Version": 1,
  "Description": "Update Payout"
}
  5. Imposta entityId in Data Mapper sull'entità dei pagamenti.
  6. Per impostare entityId, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su '181352d9-94ef-4e86-8bb9-e3759472325f'.

    L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

    { }

Ricevere assistenza dalla community di Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.

Passaggi successivi