Get-ShopifyProduct #

ÜBERSICHT #

Ruft ein einzelnes Shopify-Produkt anhand der SKU ab.

SYNTAX #

Get-ShopifyProduct [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-Sku] <string>
    [[-MaxRetries] <int>] [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG #

Durchsucht die Shopify-Produkte über die GraphQL Admin API nach einem Produkt, dessen Variante die angegebene SKU trägt. Gibt das erste gefundene Produkt als PSCustomObject zurück oder $null, wenn kein Produkt mit dieser SKU existiert.

Die Funktion wird typischerweise verwendet, um vor einem Upload zu prüfen, ob ein Produkt bereits existiert (Upsert-Logik).

Das Ergebnis wird in ein REST-kompatibles Format normalisiert: GIDs werden in numerische IDs umgewandelt, edges in flache Arrays.

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’.

-Sku #

Type: string

Die SKU (Artikelnummer), nach der gesucht wird.

-MaxRetries #

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec #

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN #

pscustomobject

BEISPIELE #

# Produkt per SKU suchen
$product = Get-ShopifyProduct -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' -Sku '1100'

# Prüfen ob Produkt existiert
$existing = Get-ShopifyProduct -Shop $shop -Token $token `
  -ApiVersion '2025-01' -Sku 'ART-001'
if ($null -eq $existing) {
  Write-Host "Produkt nicht vorhanden, wird neu angelegt."
}