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."
}