Creazione/Aggiornamento Metafield Definitions

L'endpoint consente di creare o aggiornare (Upsert) una lista di definizioni di metafield su Shopify. Un metafield definition definisce la struttura e il tipo di dato dei metafield associati a prodotti, collezioni, clienti o altri oggetti Shopify.

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/shared/metafield-definitions	Path dell'adapter per il flusso di upsert metafield definitions.
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
Headers :: x-metafield-upsert	true	Per indicare se effettuare l'upsert di definizioni metafield già esistenti (default false)

Messaggio di Input

L’endpoint accetta un array di definizioni di metafield, con tutti i seguenti campi:

Campi disponibili

• name (required)
  Tipo: string
  Nome leggibile della definizione metafield.

• namespace (required)
  Tipo: string
  Namespace del metafield.

• key (required)
  Tipo: string
  Identificatore univoco del metafield all’interno del namespace.

• type (required)
  Tipo: object
  Tipo di dato del metafield. Vedi la sezione Tipi di Metafield supportati per l’elenco completo.

• ownerType (required)
  Tipo: string
  Tipo di oggetto Shopify a cui il metafield è associato. Vedi la sezione OwnerType disponibili per l’elenco completo.

• pin (default: false)
  Tipo: boolean
  Indica se il metafield deve essere "pinned".

Tracciato

Di seguito è riportato un esempio completo di tracciato in input

[
  {
    "name": "Product Metafield",
    "namespace": "flowlyze",
    "key": "productMetafield",
    "type": "boolean",
    "ownerType": "PRODUCT",
    "description": "Metafield per indicare se il prodotto è in promozione",
    "pin": true
  },
  {
    "name": "Collection Metafield1",
    "namespace": "flowlyze",
    "key": "collectionMetafield1",
    "type": "single_line_text_field",
    "ownerType": "COLLECTION",
    "description": "Metafield testuale per la collezione",
    "pin": true
  }
]

Tipi di Metafield supportati

Tipo	Listabile
article_reference	✅
boolean	❌
color	✅
collection_reference	✅
company_reference	❌
customer_reference	✅
date	✅
date_time	✅
dimension	✅
file_reference	✅
id	✅
json	❌
link	✅
metaobject_reference	✅
mixed_reference	✅
money	❌
multi_line_text_field	❌
number_decimal	✅
number_integer	✅
page_reference	✅
product_reference	✅
product_taxonomy_value_reference	✅
rating	✅
rich_text_field	❌
single_line_text_field	✅
url	✅
variant_reference	✅
volume	✅
weight	✅

OwnerType disponibili

I metafield possono essere associati a diversi oggetti Shopify. Di seguito l’elenco completo dei valori accettati per il campo ownerType:

• API_PERMISSION
• ARTICLE
• BLOG
• CARTTRANSFORM
• COLLECTION
• COMPANY
• COMPANY_LOCATION
• • CUSTOMER
• DELIVERY_CUSTOMIZATION
• DISCOUNT
• DRAFTORDER
• FULFILLMENT_CONSTRAINT_RULE
• GIFT_CARD_TRANSACTION
• LOCATION
• MARKET
• ORDER
• ORDER_ROUTING_LOCATION_RULE
• PAGE
• PAYMENT_CUSTOMIZATION
• PRODUCT
• PRODUCTVARIANT
• SELLING_PLAN
• SHOP
• VALIDATION