Set-ShopifyFile

ÜBERSICHT

Lädt eine Datei in den Shopify Files-Bereich hoch (Staged Upload + fileCreate).

SYNTAX

Set-ShopifyFile [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-FilePath] <string>
    [[-AltText] <string>] [[-MaxRetries] <int>] [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG

Führt einen dreistufigen Upload-Prozess durch:

1. stagedUploadsCreate (GraphQL) -- Upload-URL und Parameter anfordern

2. HTTP POST -- Datei an die staged URL hochladen

3. fileCreate (GraphQL) -- Datei in Shopify registrieren

Unterstützt gängige Dateitypen (PDF, XML, PNG, JPG, ZIP, CSV, JSON, TXT). Bei HTTP 429 oder GraphQL-Throttling wird automatisch wiederholt.

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

-FilePath

Type: string

Vollständiger Pfad zur hochzuladenden Datei.

-AltText

Type: string
Default: ''

Optionaler Alternativtext für die Datei.

-MaxRetries

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN

pscustomobject -- Objekt mit Id, Url, Alt, FileName.

BEISPIELE

$file = Set-ShopifyFile -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' `
  -FilePath 'C:\Rechnungen\RE-2025-001.pdf' -AltText 'Rechnung RE-2025-001'