Führe Luau-Skripte headless in einem Roblox-Platz über Open Cloud für automatisierte Tests, Spielkonfiguration und prozedurale Generierung aus, mit vollem Zugriff auf die DataModel- und Engine-Luau-APIs. Aufgaben können bis zu 5 Minuten laufen, mit einer Begrenzung von 10 gleichzeitigen Aufgaben pro Platz. Du kannst Änderungen mit [`SavePlaceAsync`](/reference/engine/classes/AssetService#SavePlaceAsync) speichern, große binäre Nutzlasten übergeben und [`SerializationService`](/reference/engine/classes/SerializationService) nutzen, um RBXM-Inhalte zu deserialisieren. Für eine Referenzimplementierung siehe [Roblox/place-ci-cd-demo](https://github.com/Roblox/place-ci-cd-demo) auf GitHub.

Workflow:

1. [Erstelle eine Aufgabe](#Cloud_CreateLuauExecutionSessionTask__Using_Universes) mit deiner universeId, placeId und dem auszuführenden Luau-Skript
2. Ein Server wird gestartet, lädt den Platz und führt deinen Code aus
3. [Überwache den Abschluss](#Cloud_GetLuauExecutionSessionTask) und erhalte die Rückgabewerte des Skripts und [Protokolle](#Cloud_ListLuauExecutionSessionTaskLogs)

Häufige Anwendungsfälle sind:

- Automatisierte Tests: Führe Test-Skripte gegen spezifische Platzversionen im Rahmen eines CI/CD-Pipelines aus
- Spielkonfiguration: Aktualisiere Preise, Statistiken und Gleichgewichtswerte außerhalb von Studio


Stellt einen dynamisch typisierten Wert dar, der entweder null, eine Zahl, eine Zeichenfolge, ein Boolean, einen rekursiven Strukturwert oder eine Liste von Werten sein kann.

Eine Liste von LuauExecutionSessionTaskLogs in der übergeordneten Sammlung.

Die LuauExecutionSessionTaskLogs aus der angegebenen
LuauExecutionSessionTask.

Ein Token, das Sie als `pageToken`-Parameter senden können, um die nächste
Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Eine `LuauExecutionSessionTask` (kurz "Aufgabe") führt ein gegebenes Luau-Skript
im Kontext einer bestimmten Version eines Ortes aus.

In einer Aufgabe läuft keine Physiksimulation. Server- und lokale Skripte innerhalb
des Ortes laufen ebenfalls nicht automatisch.

Das Skript kann auf das Datenmodell des Ortes zugreifen und es aktualisieren, einschließlich
der Aufruf von Modul-Skripten. Änderungen am Datenmodell sind jedoch lokal für die
Aufgabe und können nicht gespeichert werden.

Das Skript kann auch API-Funktionen des Engines aufrufen, die Daten, die in der
Cloud gespeichert sind, lesen und/oder modifizieren, wie zum Beispiel die für DataStores. Gehen
Sie vorsichtig mit diesen APIs um.

Skripte können bis zu 4 MB groß sein und bis zu 5 Minuten laufen. Skripte, die länger
als das Zeitlimit laufen, enden mit einem Fehler.

Skripte werden so ausgeführt, wie sie sind, und müssen nicht in einer Funktion eingekapselt sein.

Skripte können Werte zurückgeben (unter Verwendung des Luau `return`-Schlüsselworts). Rückgabewerte
werden in JSON serialisiert und können mit der API `Get
LuauExecutionSessionTask` nach Abschluss der Aufgabe abgerufen werden. Die Gesamtheit der
Rückgabewerte nach der JSON-Serialisierung darf 4 MB nicht überschreiten. Wenn das Limit
überschritten wird, endet die Aufgabe mit einem Fehler.

Wenn das Skript einen nicht behandelten Fehler auslöst, endet die Aufgabe. Die Fehlerinformation
kann mit der API `GetLuauExecutionSessionTask` abgerufen werden.

Die Standardausgabe (generiert von der Luau `print`-Funktion) kann mit der Methode
`ListLuauExecutionSessionTaskLogs` nach Abschluss der Aufgabe abgerufen werden.
Es werden maximal 450 KB Protokolle behalten. Wenn die Protokollmenge das Limit
überschreitet, werden ältere Protokolle verworfen.

Informationen über eine Aufgabe werden 24 Stunden nach Abschluss der Aufgabe gespeichert.

Maximal zehn unvollständige Aufgaben sind pro Ort erlaubt. Der Versuch, weitere Aufgaben zu erstellen,
während die ersten zehn unvollständig sind, führt zu einer HTTP 429-Antwort.

Ressourcenpfad der binären Eingabe für diese Aufgabe. Weitere Informationen finden Sie in der Dokumentation für
das
`LuauExecutionSessionTaskBinaryInput`-Ressource.

URI für die binäre Ausgabe dieser Aufgabe. Weitere Informationen finden Sie im Feld `enableBinaryOutput`.

Zeit, zu der diese Aufgabe erstellt wurde.

Wenn auf true gesetzt, ermöglicht die Aufgabe die Ausgabe eines großen binären Objekts zusätzlich
zu den Standard-Rückgabewerten.

Wenn `enable_binary_output` auf true gesetzt ist, muss das Skript der Aufgabe ein
`LuauExecutionTaskOutput` (oder äquivalente Tabelle) zurückgeben und keine anderen Rückgabewerte.

Nachfolgend ein Beispielcode dafür:

```luau
local buf: buffer = buffer.create(10)
local result: LuauExecutionTaskOutput = {
  BinaryOutput = buf,
  ReturnValues = { "hello world", 123 }
}
return result
```

Der `BinaryOutput`-Puffer darf nicht größer als 256 MiB sein.

Das `ReturnValues`-Array, falls angegeben, wird in JSON serialisiert und im Feld `output` der
`LuauExecutionSessionTask`-Ressource verfügbar gemacht,
ähnlich zu regulären Rückgabewerten, wenn `enable_binary_output` nicht verwendet wird.

Die binäre Ausgabe kann nach Abschluss der Aufgabe über die URI im Feld `binaryOutputUri`
abgerufen werden. Die `binaryOutputUri` ist 15 Minuten nach Abschluss der Aufgabe gültig.

Der Ressourcenpfad der Luau-Ausführungssitzungsaufgabe.

Formate:
* `universes/{universe_id}/places/{place_id}/luau-execution-session-tasks/{luau_execution_session_task_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-session-tasks/{luau_execution_session_task_id}`
* `universes/{universe_id}/places/{place_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}`

Das Skript, das im Rahmen dieser Aufgabe ausgeführt werden soll.

Beispiel:

```luau
local x = 3
local y = 4
return x + y
```

Der Status der Aufgabe. Siehe das Status-Enum für Informationen über jeden möglichen
Wert.

Mögliche Werte:

  | Wert | Beschreibung |
  | --- | --- |
  | STATE_UNSPECIFIED | UNBESTIMMT |
  | QUEUED | Die Aufgabe wartet darauf, verarbeitet zu werden. |
  | PROCESSING | Die Aufgabe wurde zur Verarbeitung übernommen. |
  | CANCELLED | Die Aufgabe wurde vom Benutzer gestoppt. |
  | COMPLETE | Die Aufgabe hat die Verarbeitung beendet. Das Ausgabefeld enthält die Ausgabe. |
  | FAILED | Die Aufgabe ist gescheitert. Das Fehlerfeld enthält Details über den Fehler. |

Grenze, wie lange das Skript laufen darf.

Die Aufgabe schlägt fehl, wenn das Skript nicht innerhalb der
angegebenen Dauer abgeschlossen ist.

Standardmäßig 5 Minuten.

Zeit, zu der sich der Status dieser Aufgabe zuletzt geändert hat.

Der Benutzer, der den API-Schlüssel erstellt hat, der zur Erstellung dieser Aufgabe verwendet wurde.

Stellt einen großen Binäreingang dar, der einer
`LuauExecutionSessionTask` gegeben werden kann.

Jeder `LuauExecutionSessionTaskBinaryInput` ist mit einer vorab signierten URL
verbunden, die verwendet werden kann, um ein beliebiges Objekt hochzuladen. Nach dem Hochladen des Objekts
kann der Pfad des `LuauExecutionSessionTaskBinaryInput` beim Erstellen einer `LuauExecutionSessionTask`
übergeben werden, um das Objekt der Aufgabe verfügbar zu machen.

Innerhalb der Aufgabe werden die Inhalte des Objekts in einer Tabelle verfügbar gemacht,
die als erstes Argument an das Skript übergeben wird, mit dem Schlüssel `BinaryInput`. Das
folgende Beispiel zeigt, wie die Daten abgerufen werden:

```
local taskInput: LuauExecutionTaskInput = ({...})[1]
local buf: buffer = taskInput.BinaryInput
```

Jeder `LuauExecutionSessionTaskBinaryInput` ist 15 Minuten ab dem Zeitpunkt der Erstellung gültig. In dieser Zeit,
sofern gewünscht, können Sie ihn verwenden, um mehrere Aufgaben für dasselbe Universum zu erstellen.

Das hochgeladene Binärobjekt darf nicht größer als 100 MiB sein.

Der Ressourcenpfad des Binäreingangs der Luau-Ausführungsaufgabe.

Format:
`universes/{universe_id}/luau-execution-session-task-binary-inputs/{luau_execution_session_task_binary_input_id}`

Die Größe des hochzuladenden Binäreingangsobjekts.

Die maximal erlaubte Größe beträgt 100 MiB.

Laden Sie das Binäreingangsobjekt über diese URI hoch.

Stellt einen Block von Protokollnachrichten dar, die durch eine
`LuauExecutionSessionTask` generiert wurden.

Die Menge an Protokollen, die gespeichert wird, ist begrenzt. Weitere Einzelheiten finden Sie in der Dokumentation
zur Ressource `LuauExecutionSessionTask`.

Protokolle haben die gleiche Aufbewahrungszeit wie die übergeordnete Aufgabe.

Eine Liste von Protokollnachrichten, die durch die Ausführung der Aufgabe generiert wurden.
Jeder Aufruf der Luau `print()`-Funktion aus dem Skriptcode der Aufgabe führt zu einem einzelnen Listenelement hier,
auch wenn die Nachricht selbst Zeilenumbrüche enthält. Dieses Feld wird gefüllt, wenn die Ansicht FLACH ist (was der
Standard ist).

Der Ressourcenpfad des Luau-Ausführungsprotokolls der Aufgabe.

Formate:
* `universes/{universe_id}/places/{place_id}/luau-execution-session-tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-session-tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`
* `universes/{universe_id}/places/{place_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`

Eine Liste von Protokollnachrichten, die durch die Ausführung der Aufgabe generiert wurden und zugehörige
Metadaten.
Jeder Aufruf der Luau `print()`-Funktion aus dem Skriptcode der Aufgabe führt zu einem einzelnen Listenelement hier,
auch wenn die Nachricht selbst Zeilenumbrüche enthält. Dieses Feld wird gefüllt, wenn die Ansicht STRUKTURIERT ist.

Eine einzelne Protokollnachricht zusammen mit den zugehörigen Metadaten

Der Zeitpunkt, zu dem die Protokollnachricht erzeugt wurde

Der `MessageType` der Protokollnachricht.

Mögliche Werte:

  | Wert | Beschreibung |
  | --- | --- |
  | MESSAGE_TYPE_UNSPECIFIED | UNBESTIMMT |
  | OUTPUT | Entspricht dem Wert des `MessageOutput`-Enums der Engine-API. |
  | INFO | Entspricht dem Wert des `MessageInfo`-Enums der Engine-API. |
  | WARNING | Entspricht dem Wert des `MessageWarning`-Enums der Engine-API. |
  | ERROR | Entspricht dem Wert des `MessageError`-Enums der Engine-API. |

Enthält Fehlermeldungsdetails im Falle einer fehlgeschlagenen Ausführung.

Ein Fehlercode, der die Kategorie des Fehlers angibt.

Mögliche Werte:

  | Wert | Beschreibung |
  | --- | --- |
  | ERROR_CODE_UNSPECIFIED | UNBESTIMMT |
  | SCRIPT_ERROR | Das Skript der Aufgabe hat einen nicht behandelten Fehler ausgelöst. |
  | DEADLINE_EXCEEDED | Die Aufgabe hat die maximal erlaubte Ausführungsdauer überschritten. |
  | OUTPUT_SIZE_LIMIT_EXCEEDED | Die Ausgaben der Aufgabe waren zu groß. |
  | INTERNAL_ERROR | Die Aufgabe ist aufgrund eines internen Systemfehlers fehlgeschlagen. |

Eine Fehlermeldung, die weitere Details über den Fehler enthält.

Enthält die Ausgaben der Ausführung einer Aufgabe.

Rückgabewerte aus dem ausgeführten Skript. Rückgabewerte, die nicht
JSON-seriell sind (wie Datenmodellinstanzen), werden als
nulls zurückgegeben.

Ein konfigurierbarer Schlüssel, der granularen Zugriff auf Roblox-Ressourcen ermöglicht. Siehe https://create.roblox.com/docs/cloud/auth/api-keys für weitere Informationen.

x-api-key

Ein Browser-Cookie, das die Identität eines Roblox-Nutzers darstellt. TEILE DIES NICHT. Das Teilen hiervon erlaubt es jemandem, sich als Sie einzuloggen und Ihre Robux sowie Gegenstände zu stehlen. Wir empfehlen nicht, Cookies zum Aufruf von Endpunkten zu verwenden. Verwenden Sie nach Möglichkeit API-Keys mit dem x-api-key-Header oder OAuth 2.0 zur Authentifizierung.

.ROBLOSECURITY

Bauen oder autorisieren Sie Apps, um auf Roblox-Ressourcen zuzugreifen. Siehe https://create.roblox.com/docs/cloud/auth/oauth2-overview für weitere Informationen.

Die Roblox API. Siehe https://create.roblox.com/docs/cloud/open-cloud für weitere Details.

Roblox API

Erstellt eine neue `LuauExecutionSessionTaskBinaryInput`.

universe_id

Erstelle Luau-Ausführungssitzungsaufgaben-Binär-Eingabe

LuauExecutionSessionTaskBinaryInput

universe.place.luau-execution-session:write

Erstellt eine Aufgabe, wartet jedoch nicht auf den Abschluss der Aufgabe. Um zu überprüfen, ob eine Aufgabe abgeschlossen ist, rufen Sie die Methode `GetLuauExecutionSessionTask` auf und inspizieren Sie das `state`-Feld der zurückgegebenen Ressource.

place_id

Luau-Ausführungssitzung Aufgabe erstellen

LuauExecutionSessionTask

version_id

luau_execution_session_id

task_id

Der Ansicht, in der die luau-Ausführungs-Sitzungsaufgabe abgerufen werden soll.

Unterstützt BASIC und FULL.

Standardmäßig auf BASIC.

Mögliche Werte:

  | Wert | Beschreibung |
  | --- | --- |
  | VIEW_UNSPECIFIED | Die Ansicht der luau-Ausführungs-Sitzungsaufgabe ist nicht angegeben; der Standardwert wird verwendet. |
  | BASIC | Schließt das Feld `script` aus. |
  | FULL | Enthält alle Felder. |

view

universe.place.luau-execution-session:read

Listet Protokollstücke auf, die von einem `LuauExecutionSessionTask` generiert wurden.

Quoten:
* 45 Aufrufe pro Minute pro API-Schlüsselbesitzer oder IP-Adresse

Die maximale Anzahl von luau-Ausführungs-Sitzungsprotokollen, die zurückgegeben werden sollen. Der
Dienst kann weniger als diesen Wert zurückgeben. Falls nicht angegeben, werden maximal 10000
luau-Ausführungs-Sitzungsprotokolle zurückgegeben. Der maximale Wert ist 10000
und höhere Werte werden auf 10000 gesetzt.

maxPageSize

Ein Seiten-Token, das von einem vorhergehenden Aufruf empfangen wurde, um eine nachfolgende Seite abzurufen.

Bei der Paginierung müssen alle anderen Parameter, die beim nachfolgenden Aufruf angegeben werden, mit dem
Aufruf übereinstimmen, der das Seiten-Token bereitgestellt hat.

pageToken

Die Ansicht, in der das luau-Ausführungs-Sitzungsprotokoll abgerufen werden soll.

Unterstützt FLAT und STRUCTURED.

Standardmäßig auf FLAT.

Mögliche Werte:

  | Wert | Beschreibung |
  | --- | --- |
  | VIEW_UNSPECIFIED | Die Ansicht des luau-Ausführungs-Sitzungsprotokolls ist nicht angegeben; der Standardwert wird verwendet. |
  | FLAT | Wenn diese Ansicht ausgewählt wird, wird das Feld `messages` gefüllt (und das Feld `structuredMessages` nicht). Jeder Eintrag des Arrays `messages` enthält nur die Protokollnachricht, ohne zusätzliche Metadaten. Dies ist der Standard. |
  | STRUCTURED | Wenn diese Ansicht ausgewählt wird, wird das Feld `structuredMessages` gefüllt (und das Feld `messages` nicht). Jeder Eintrag des Arrays `structuredMessages` enthält die Protokollnachricht plus zusätzliche Metadaten (siehe `LogMessage` für Details). |

Liste Luau-Ausführungs-Sitzungsprotokolle

LuauExecutionSessionTaskLog

Luau Execution

Experiences

Avatar

Objekte

Beispiele und Projekte

Engine-API

Open-Cloud-API

Studio

Analytics

Plattform

Tutorials

Creator-Programme

Bildung

Kurse

Lernen

Diese Methode ist asynchron und gibt eine `Operation` zurück, die den aktuellen Status der Operation darstellt. Sie enthält einen Endpunktpfad, den du abfragen kannst, um die tatsächliche Antwort und die entsprechenden Metadaten zu erhalten. Weitere Informationen findest du in der [Dokumentation]({longRunningOperationsLink}).

Die folgenden Abschnitte beschreiben die Antwort- und Metadatenobjekte, die bereitgestellt werden, wenn eine Operation abgeschlossen ist.

Beta-Endpunkte sind bereit für die öffentliche Nutzung. Bahnbrechende Änderungen sind möglich, aber selten.

Diese Open-Cloud-Dokumentationsseiten werden am 31. März 2026 entfernt. Du wirst zu diesem Zeitpunkt automatisch zur neuen Open-Cloud-Dokumentation weitergeleitet. {linkStart}Mehr erfahren{linkEnd}

Diese alten Open-Cloud-Seiten werden am 31. März 2026 entfernt und umgeleitet. {linkStart}Mehr erfahren{linkEnd}

Experimentelle Endpunkte sind für die öffentliche Nutzung bereit, können jedoch gelegentlich Änderungen unterliegen, wenn der API-Vertrag abgeschlossen ist.

Dieser Endpunkt kann innerhalb der Experience über {httpServiceLinkStart}HTTPService{httpServiceLinkEnd} mit einem API-Schlüssel aufgerufen werden.

Dieses Feld kann beim Erstellen einer Ressource festgelegt werden, kann jedoch durch spätere Anfragen nicht geändert werden.

Diese Felder können beim Erstellen einer Ressource festgelegt werden, kann jedoch durch spätere Anfragen nicht geändert werden.

Dieses Feld kann in Anfragen zur Verfügung gestellt werden, wird aber niemals in Antworten enthalten sein.

Legacy-Authentifizierungsmethode. Verwende immer den API-Schlüssel oder OAuth 2.0, wenn verfügbar.

Pro API-Schlüssel: {maxInPeriod} Anfoderungen pro {periodInSeconds} Sekunden pro IP-Adresse

Erfordert keine Authentifizierung zum Aufrufen. Hat in der Regel deutlich niedrigere Ratenbegrenzungen. Verwende immer den API-Schlüssel oder OAuth 2.0, wenn verfügbar.

Für jede Gruppierung muss nur eines der folgenden Felder im Schema angegeben werden, die übrigen können ausgeschlossen werden.

Du kannst dich jederzeit wieder anmelden. {linkStart}Feedback geben.{linkEnd}

Du siehst gerade die alten Dokumente an. {linkStart}Feedback geben.{linkEnd}

Du kannst dich jederzeit wieder abmelden und wirst dann zu den alten Referenzseiten weitergeleitet. {linkStart}Gib uns Feedback.{linkEnd}

Du siehst gerade die überarbeiteten Dokumente an. {linkStart}Feedback geben.{linkEnd}

Dieses Feld kann in Antworten zur Verfügung gestellt werden, wird aber bei Anfragen ignoriert.

Hinweis: In Zeiten mit viel Datenverkehr können die Ratenbegrenzungen niedriger sein. Für bestimmte Endpunkte gelten zusätzliche Ratenbegrenzungen. [Erfahre mehr über Ratenbegrenzungen]({link}).

{limit} Anfragen pro Tag über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Stunde über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Minute über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Sekunde über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Minute pro API-Schlüsselbesitzer

{limit} Anfragen pro Tag pro App-Benutzer

{limit} Anfragen pro Stunde pro App-Benutzer

{limit} Anfragen pro Minute pro App-Benutzer

{limit} Anfragen pro Sekunde pro App-Benutzer

{limit} Anfrage(n) pro Sekunde pro API-Schlüsselbesitzer

Mit Bereichen wird festgelegt, welche Berechtigungen du mit deinen Anmeldeinformationen hast. Über deine Anmeldeinformationen kannst du nur auf die Endpunkte zugreifen, die von den ausgewählten Bereichen unterstützt werden.

Stabile Endpunkte sind produktionsbereit und unterliegen während ihrer Lebensdauer fast nie Änderungen.

Mit diesem Ziel kannst du den Zugriff deines Schlüssels auf ausgewählte {requiredParts} festlegen.

Mit diesem Ziel kannst du den Zugriff deines Schlüssels auf ausgewählte {requiredParts} und {optionalParts} festlegen.

Mit Zielarten kannst du die Ressourcen einschränken, für die deine Anmeldeinformationen verwendet werden können. Auch wenn dein Konto über Berechtigungen für weitere Ressourcen verfügt, kannst du nur auf die ausgewählten Ressourcen zugreifen. Einige Bereiche haben keine Zielelemente. In diesen Fällen kannst du auf alle relevanten Ressourcen zugreifen.

Das universale Top-Level-Teil muss nicht für benutzerdefinierte API-Schlüssel ausgewählt werden. In diesem Fall hat dein API-Schlüssel Zugriff auf alle deine benutzerdefinierten Experiences und gruppenbasierten Experiences, für die du die richtigen Gruppenberechtigungen hast.

Probier’s aus wird noch nicht für Endpunkte unterstützt, die einen API-Schlüssel oder eine OAuth 2.0-Authentifizierung erfordern

Die Cookie-Authentifizierung ist aus Sicherheitsgründen für Vorgänge mit hohem Risiko deaktiviert.

Kritische Risiko-Endpunkte sind extrem sensibel und „Probier’s aus“ ist aus Sicherheitsgründen deaktiviert.

Hinweis: Authentifizierungs-Header sind in diesem Codebeispiel nicht enthalten. Möglicherweise musst du einen Authentifizierungs-Header hinzufügen, damit dieser Befehl funktioniert.

Dies ist ein Endpunkt mit hohem Risiko, der kritische Daten ändern oder löschen kann. Sei beim Testen äußerst vorsichtig.

Dieser API-Endpunkt wurde als HOCHRISIKO eingestuft und kann Live-Daten oder Benutzerkonten beeinträchtigen.

Authentifizierte Anfragen an risikoreiche APIs können Änderungen vornehmen, die nicht rückgängig gemacht werden können. Bitte überprüfe deine Anfrageparameter sorgfältig, bevor du fortfährst.

Bitte melde dich an, um die Cookie-Authentifizierung zu verwenden

Dies ist ein Endpunkt mit geringem Risiko, der Daten abruft. Dies ist im Allgemeinen sicher zu testen.

Dies ist ein Endpunkt mit mittlerem Risiko, der Daten ändert. Teste ihn sorgfältig mit nicht kritischen Konten, da Änderungen dauerhaft sein können.

Um dein Konto zu schützen, solltest du hier niemals Text aus anderen Quellen einfügen oder Informationen von dieser Seite an andere senden.

Du bist im Begriff, Live-API-Endpunkte mit deinen tatsächlichen Kontoanmeldeinformationen zu testen.

Fahre nur fort, wenn du die Auswirkungen der API-Aufrufe, die du durchführen möchtest, verstehst. Lies die API-Dokumentation sorgfältig durch, bevor du sie testest.

API-Aufrufe werden über deine authentifizierte Sitzung durchgeführt.

Dies sind echte API-Aufrufe, die sich auf dein Konto oder deine Daten auswirken können.

Es gelten Ratenbegrenzungen und andere API-Einschränkungen.

Bei einigen Vorgängen können Daten geändert oder gelöscht werden.

Dieser Endpunkt wurde durch diese empfohlenen alternativen Endpunkte ersetzt:

Die folgenden Bereiche sind erforderlich, um diesen Endpunkt aufzurufen. Weitere
Informationen zum Generieren der richtigen Schlüssel findest du unter [API-Schlüssel verwalten]({apiKeyReferenceDocLink}).

Weitere Informationen zum Generieren von Schlüsseln findest du unter [API-Schlüssel verwalten]({apiKeyReferenceDocLink}).

Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.

Dieser String ist als [FieldMask](/cloud/reference/types#fieldmask) formatiert.

Ein JSON-Wert kann `null`, `boolean`, `string`, `number`, `array` oder `object` sein.

Um diesen Endpunkt nutzen zu können, werden folgende Anwendungsbereiche für deine OAuth 2.0 App benötigt. Weitere Informationen zur Registrierung einer OAuth 2.0-App findest du unter [App Registration and Review]({oauth2ReferenceDocLink}).

Weitere Informationen zur Registrierung einer OAuth 2.0-Anwendung findest du unter [App-Registrierung und Überprüfung]({oauth2ReferenceDocLink}).

Die folgenden Objekte beschreiben Nutzlasten, die akzeptiert oder zurückgegeben werden. Die einzelnen Endpunkte zeigen weitere Informationen darüber an, wann diese Objekte verwendet werden.

Die folgenden Bereiche sind erforderlich, um diesen Endpunkt aufzurufen.

Ressourcen-Pfade

Dieser String ist als [Zeitstempel](/cloud/reference/types#timestamp) formatiert.

Nicht empfohlen

Dir wird die überarbeitete Open-Cloud-Referenz angezeigt.

Du hast dich von der neuen Open-Cloud-Referenz abgemeldet.

Sieh dir deine Werbe-Abrechnungskonten an.

Sieh dir deine Werbekampagnen und deren Leistung an.

Erstelle, aktualisiere und verwalte deine Werbekampagnen.

Dies ermöglicht das Anzeigen von Informationen über deine Objekte.

Dies ermöglicht das Hochladen und Aktualisieren von Objekten auf Roblox.

Damit kannst du Objektberechtigungen für Subjekte (einschließlich Gruppen und Experiences) sowie für Objekte anzeigen, auf die dein Konto Zugriff hat.

Damit kannst du Objektberechtigungen an beliebige Subjekte (einschließlich Gruppen und Experiences) sowie an Objekte vergeben, auf die dein Konto Zugriff hat.

Damit kannst du den Status und die Ergebnisse von Jobs zur automatischen Avatareinrichtung in deinem Namen anzeigen.

Damit kannst du Jobs zur automatischen Avatareinrichtung in deinem Namen erstellen und verwalten.

Bietet die Möglichkeit, die Abzeichen des Nutzers zu aktualisieren.

Dies ermöglicht das Anzeigen von Informationen über deine Handelsartikel.

So kannst du Änderungen an deinen synchronisierten Handelsartikeln vornehmen.

Damit kannst du Informationen zu deinen Händlerverbindungen anzeigen.

Dies ermöglicht das Bearbeiten deiner Kommerzhändlerverbindungen.

Hiermit kannst du Informationen zu deinen Creator-Store-Produkten ansehen.

Hiermit kannst du Informationen zu deinen Creator-Store-Produkten ändern.

Damit kannst du Informationen über deine Creator-Store-Speichervorgänge anzeigen.

Damit kannst du Informationen zu deinen Creator-Store-Speichervorgängen ändern.

Dies gewährt Zugriff zum Erstellen von Datenspeichern in deinem Namen.

Dies gewährt Zugriff zum Löschen von Datenspeichern in deinem Namen.

Dies gewährt Zugriff zum Lesen einer Liste von Datenspeichern.

Dies gewährt Zugriff zum Erstellen eines Snapshots deiner Datenspeicher.

Dies gewährt Zugriff zum Erstellen von Einträgen in deinen Datenspeichern.

Dies gewährt Zugriff zum Markieren bestimmter Einträge zum Löschen.

Dies gewährt Zugriff zum Auflisten deiner Datenspeichereinträge.

Dies gewährt Zugriff zum Lesen bestimmter Einträge in deinen Datenspeichern.

Dies gewährt Zugriff zum Aktualisieren des Werts, der Attribute und der Benutzer eines Eintrags.

Dies gewährt Zugriff zum Löschen von Überprüfungen deiner Datenspeichereinträge.

Dies gewährt Zugriff zum Auflisten von Überprüfungen deiner Datenspeichereinträge.

Gewährt Zugriff auf die Ansicht von Konfigurationsdetails für Entwicklerprodukte des autorisierten Benutzers.

Gewährt Zugriff zum Bearbeiten der Entwicklerprodukte des autorisierten Benutzers.

Dies ermöglicht das Anzeigen von Informationen über deine Universumsumgebungen.

Dies ermöglicht das Bearbeiten deiner Universumsumgebungen.

Gewährt Zugriff auf die Ansicht von Konfigurationsdetails für die Spielpässe des autorisierten Benutzers.

Gewährt Zugriff zum Bearbeiten der Spielpässe des autorisierten Benutzers.

Gewährt Zugriff auf die Ansicht von Informationen über Community-Foren für dein Konto.

Gewährt Zugriff auf die Verwaltung von Informationen über Community-Foren für dein Konto.

Dies ermöglicht das Anzeigen von Informationen über deine Communitys.

Damit kannst du Community-Beitrittsanfragen und Rollenänderungen von Community-Mitgliedern mit niedrigerem Rang für dein Konto verwalten.

Damit kannst du die Eigenschaftsdaten einer Instanz anzeigen.

Damit kannst du die Eigenschaftsdaten von Instanzen ändern (unterstützt derzeit nur Skripts).

Dies ermöglicht das Anzeigen von Informationen über dein Inventar.

Gewährt Zugriff auf die Verwaltung von Benutzer-Objekten.

Gewährt Zugriff auf die Verwaltung deiner Abzeichen.

Gewährt Zugriff auf die Verwaltung deiner Abzeichen und das Ausgeben von Robux.

Gewährt Zugriff zum Aktualisieren der Abzeichen des autorisierten Benutzers.

Gewährt Zugriff auf die Verwaltung deiner Entwicklerprodukte.

Ermöglicht den Lesezugriff auf Informationen über die Experiences, für die du Benachrichtigungen aktiviert hast.

Ermöglicht es, Benachrichtigungen für Experiences in deinem Namen ein- oder auszuschalten.

Gewährt Zugriff auf die Verwaltung deiner Pässe.

Gewährt Zugriff auf die Verwaltung deiner Communitys.

Gewährt die Erlaubnis, Community-Informationen zu lesen.

Gewährt Community-Verwaltungsberechtigungen.

Gewährt Zugriff zum Lesen und Schreiben deiner Lokalisierungstabellen

Gewährt Zugriff auf die Verwaltung der Teamzusammenarbeit für alle deine Experiences.

Gewährt Zugriff auf die Verwaltung deiner Experiences und bestimmte Informationen, die mit deiner Experience verbunden sind (z.B. Lokalisierungsinformationen).

Gewährt Zugriff zum Lesen der Lokalisierungsinformationen deiner Experiences.

Gewährt Zugriff zum Ändern der Lokalisierungspräferenzen deiner Experiences.

Gewährt Zugriff auf die Verwaltung deines Nutzerkontos.

Gewährt Zugriff zum Ändern der Lokalisierungspräferenzen des Nutzers.

Damit kannst du den Status, die Protokolle und die Ergebnisse der Luau-Ausführungsaufgaben für den zugehörigen Ort anzeigen.

Damit kannst du neue Luau-Ausführungsaufgaben für den zugehörigen Ort erstellen.

Dies gewährt Zugriff zum asynchronen Leeren aller Datenstrukturen im Universum.

Dies gewährt Zugriff zum Erstellen neuer Warteschlangenelemente.

Dies gewährt Zugriff zum Entfernen ausgelesener Elemente vom Anfang der Warteschlange.

Dies gewährt Zugriff zum Lesen von Elementen am Anfang der Warteschlange.

Dies gewährt Zugriff zum Lesen deiner Arbeitsspeicherelemente.

Dies gewährt Zugriff zum Lesen von Kartenelementen.

Dies gewährt Zugriff zum Erstellen, Aktualisieren und Löschen von Kartenelementen.

Dies gewährt die Fähigkeit, Nachrichten im Namen von Nutzern zu veröffentlichen.

Damit können Benachrichtigungen an Nutzer von deiner Experience aus gesendet werden.

(Veraltet) Dies gewährt Zugriff zum Lesen einer Liste von Einträgen in einem geordneten Datenspeicher.

(Veraltet) Dies gewährt Zugriff zum Erstellen eines neuen Eintrags in einem geordneten Datenspeicher.

Dies gewährt Zugriff auf Listeneinträge aus einem geordneten Datenspeicher.

Dies gewährt Zugriff zum Erstellen von Einträgen in einem geordneten Datenspeicher.

Dies ermöglicht es, Geheimnisse im Zusammenhang mit deiner Experience aufzulisten.

Damit kannst du Geheimnisse erstellen und aktualisieren, die mit deiner Experience verbunden sind.

Mit dieser Berechtigung kannst du einen Bewertungsauftrag einreichen und das Auftragsergebnis anzeigen.

Ermöglicht den Zugriff auf deine Abonnementprodukte.

Damit kannst du Informationen zu Vorschaubildern in deinem Namen lesen.

Gewährt die Fähigkeit, Spielanalysen zu lesen.

Gewährt die Fähigkeit, Ortsinformationen zu lesen.

Gewährt die Fähigkeit, Ortsinformationen zu bearbeiten.

Gewährt Zugriff für die Veröffentlichung neuer Versionen von Experiences auf Roblox.

Gewährt die Fähigkeit,Experience-Informationen zu lesen.

Gewährt Zugriff zum Bearbeiten der Experiences des autorisierten Benutzers.

Ermöglicht es dir, Benutzerbeschränkungen in der Experience zu sehen.

Ermöglicht es dir, Benutzerbeschränkungen in der Experience zu bearbeiten.

Damit kannst du Benachrichtigungen anzeigen, die an dein Konto gesendet wurden.

Erlaubt das Lesen des Premium- und Verifizierungs-Status des berechtigten Benutzers.

Damit kannst du die Social-Media-Konten des autorisierten Benutzers anzeigen.

Dies aktiviert Single Sign-On-Funktionalität.

Dies gewährt Zugriff auf das Lesen deiner Profilinformationen.

Luau Execution

Places