Creazione/Aggiornamento Metaobjects

L'endpoint consente di creare o aggiornare (Upsert) un metaobject su Shopify. Un metaobject è una struttura dati personalizzata in Shopify che consente di creare oggetti riutilizzabili con più campi definiti dal gestore dello store. Inoltre il sistema gestisce anche le traduzioni dei singoli campi definiti precedentemente.

Configurazione del Flusso di Creazione/Aggiornamento Metaobject

Oltre alla configurazione base del flusso dati, è necessario aggiungere le seguenti impostazioni nei Settings Override:

Campo	Valore	Note
Base Url	https://adapt.flowlyze.com	url degli adapter
Resource Path	api/adp/shopify/egress/sync-metaobject-to-shopify	Path dell'adapter per il flusso di upsert metaobject.
Headers :: x-api-key	**********	L'api key di verifica per l'interazione con l'endpoint
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret della custom app creata per l'integrazione
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Url dello shopify con cui connettersi

Messaggio di Input

L’endpoint lavora in modalità upsert: è possibile inviare JSON parziali e solo i campi specificati verranno aggiornati su Shopify. I campi non inclusi nella richiesta non subiranno modifiche.

Campi disponibili

• isPublished
  Tipo: boolean
  Indica se il metaobject è pubblicato (true) o in stato di bozza (false). Quando pubblicato, può essere referenziato nello storefront o nelle app. Default: false.

• handle
  Tipo: string
  Identificatore univoco leggibile (slug). Serve per collegare il metaobject via Liquid, Storefront API o tramite metafield di tipo riferimento. Campo required.

• type
  Tipo: string
  Specifica il tipo o la definizione del metaobject, corrispondente al modello usato (es. "meta_type"). Determina la struttura e i campi disponibili. Si noti che il tipo deve essere definito prima dal gestore dello store. Campo required.

• fields
  Tipo: object
  Contiene i valori definiti dall’utente per i campi del modello (esclusi quelli di tipo file). È un dizionario chiave-valore.

  Esempio:

  "fields": {
    "key1": "value1",
    "key2": "value2"
  }

• files Tipo: object Contiene i valori dei campi di tipo file definiti dall’utente. È un dizionario chiave-valore.

  Esempio:

    "files": {
        "key3": "http://example-value-3.jpg",
        "key4": "http://example-value-4.pdf"
      }

• translations Tipo: object Contiene le traduzioni localizzate per i campi del metaobject. La struttura è organizzata per campo e lingua.

  Esempio:

    "translations": {
        "key1": {
            "fr": "valeur-fr",
            "it": "valore-it"
        }
    }

Tracciato

Di seguito è riportato un esempio completo di tracciato in input per l'upsert del metaobject

{
    "isPublished": true,
    "handle": "summer-collection-banner",
    "type": "promo_banner",
    "fields": {
      "title": "Summer Sale 2025",
      "subtitle": "Up to 50% off on selected items"
    },
    "files": {
      "file_pdf": "http://example/Pdf/file_pdf.pdf",
      "file_video": "http://example/Video/file_video.mp4",
      "file_image": "http://example/Images/file_image.jpg"
    },
    "translations": {
      "title": {
        "fr": "Soldes d'été 2025",
        "it": "Saldi Estivi 2025"
      },
      "subtitle": {
        "fr": "Jusqu'à 50% de réduction sur une sélection d'articles",
        "it": "Fino al 50% di sconto su articoli selezionati"
      }
    }
}