Set-ShopifyCollection #

ÜBERSICHT #

Legt eine Shopify Custom Collection an oder aktualisiert sie (Upsert per Title).

SYNTAX #

Set-ShopifyCollection [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-Title] <string>
    [[-BodyHtml] <string>] [[-Published] <bool>] [[-Handle] <string>] [[-BreadcrumbPath] <string>]
    [[-CollectionId] <long>] [[-MaxRetries] <int>] [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG #

Prüft über Get-ShopifyCollectionList, ob bereits eine Collection mit dem angegebenen Title existiert. Falls ja, wird eine collectionUpdate-Mutation ausgeführt, andernfalls eine collectionCreate-Mutation (GraphQL Admin API).

Optional wird ein Metafield ’eulanda.breadcrumb_path’ gesetzt, das den vollständigen EULANDA-Merkmalbaum-Pfad speichert.

EULANDA-Merkmalbaum-Knoten werden flach (eine Ebene unter dem Hauptmerkmal) als Shopify Custom Collections abgebildet. Shopify unterstützt keine hierarchischen Collections. Der Sonderfall Title=‘Startseite’ sollte mit Handle=‘frontpage’ angelegt werden (Shopify Featured Collection für die Homepage).

PARAMETER #

-Shop #

Type: string

Shopify-Shop-Domain, z.B. ‘mein-shop.myshopify.com’.

-Token #

Type: string

Admin API Access Token (shpat_…) der Custom App.

-ApiVersion #

Type: string

API-Version, z.B. ‘2025-01’.

-Title #

Type: string

Name der Collection (wird als Lookup-Schlüssel für Upsert verwendet).

-BodyHtml #

Type: string
Default: ''

Optionale HTML-Beschreibung der Collection.

-Published #

Type: bool
Default: $true

Ob die Collection veröffentlicht werden soll. Standard: $true.

-Handle #

Type: string

Optionaler URL-freundlicher Name (Slug). Spezialfall: ‘frontpage’ für Homepage.

-BreadcrumbPath #

Type: string

Optionaler EULANDA-Merkmalbaum-Pfad, wird als Metafield gespeichert.

-CollectionId #

Type: long

Optionale Shopify-Collection-ID. Wenn angegeben, wird direkt aktualisiert ohne vorherige Suche.

-MaxRetries #

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec #

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN #

pscustomobject

BEISPIELE #

# Neue Collection anlegen
Set-ShopifyCollection -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' `
  -Title 'NPK Dünger' -BreadcrumbPath '\Shop\Düngemittel\NPK Dünger'

# Bestehende Collection aktualisieren
Set-ShopifyCollection -Shop $shop -Token $token -ApiVersion '2025-01' `
  -Title 'Schaufeln' -CollectionId 123456789