Ein `Logger` gibt strukturierte Protokolleinträge aus, die mit einem hierarchischen
Namen versehen sind, sodass Sie verwandte Nachrichten nach Subsystem oder Funktion gruppieren können. Erhalten Sie einen
obersten Logger von `Class.LogService:GetLogger()`, und erstellen Sie dann verschachtelte Kind-Loggers mit `Class.Logger:GetLogger()`. Jeder Logger hat einen kurzen
`Class.Logger.Name` und einen durch Punkte verbundenen `Class.Logger.FullPath`, der aus seiner
Abstammung erstellt wird (zum Beispiel hat ein Logger namens `Damage`, der von einem Logger namens
`Combat` erstellt wurde, den vollständigen Pfad `Combat.Damage`).

```lua
local LogService = game:GetService("LogService")

local combat = LogService:GetLogger("Combat")
local damage = combat:GetLogger("Damage")

print(damage.Name)      --> Damage
print(damage.FullPath)  --> Combat.Damage

damage:Info("Fügte {amount} Schaden zu {target} hinzu", {amount = 25, target = "Goblin"})
```
Logger verhalten sich genauso wie die strukturierten Protokollierungs-Methoden auf
`Class.LogService`: Nachrichten fließen in das **Output**-Fenster, die Entwicklerkonsole und `Class.LogService.MessageOut` und sind enthalten in
`Class.LogService:GetLogHistory()`, gekennzeichnet mit dem vollständigen Pfad des Loggers.

#### Hierarchie und Propagation

Wenn eine Nachricht auf einem Logger protokolliert wird, wird das `Class.Logger.MessageOut`-Ereignis
auf diesem Logger **und** auf jedem Vorfahren bis zur Wurzel ausgelöst. Dies ermöglicht es Ihnen,
einen Listener auf einem übergeordneten Logger anzuhängen, um alle Nachrichten zu beobachten, die von seinen
Nachkommen ausgegeben werden. Die Nachricht wird genau einmal an das Ausgabesystem der Engine gesendet,
gekennzeichnet mit dem vollständigen Pfad des ursprünglichen Loggers.

#### Vorlagen-Syntax und Kontext

Die Protokollierungs-Methoden akzeptieren die gleichen `{key}`-Vorlagenplatzhalter und
`context`-Tabellen wie die strukturierten Protokollierungs-Methoden auf `Class.LogService`. Siehe
`Class.LogService` für Details zur Vorlagen-Syntax und wie Kontextwerte gespeichert werden.

#### Lebensdauer

Ein Logger bleibt gültig, solange Sie eine Referenz darauf halten. Sobald alle
Referenzen zu einem Logger (und seinen Nachkommen) freigegeben werden, wird er zurückgefordert,
und das Aufrufen einer Methode auf einem veralteten Logger löst einen Fehler aus. Die Anzahl der aktiven
Logger und die Länge des vollständigen Pfades eines Loggers sind beide begrenzt; das Überschreiten
irgendeines Limits löst einen Fehler von `Class.Logger:GetLogger()` aus.

#### Warnung

Diese Klasse könnte unerwartetes oder unzuverlässiges Verhalten aufweisen, und der Inhalt könnte
abgeschnitten werden. Verlassen Sie sich nicht auf den Inhalt von Ereignissen und Nachrichten, die von Loggers
für wichtige Spiel-Logik ausgegeben werden.


Wird jedes Mal ausgelöst, wenn eine Nachricht über diesen Logger oder einen Logger
unter ihm in der Hierarchie protokolliert wird. Da eine protokollierte Nachricht `MessageOut`
auf dem ursprünglichen Logger und jedem seiner Vorfahren auslöst, beobachtet ein Listener, der an
einen übergeordneten Logger angehängt ist, jede Nachricht, die von seinen Nachkommen ausgegeben wird. Der
`message`-Parameter enthält den vollständig gerenderten Text (Vorlagenplatzhalter bereits ersetzt), und der `context`-Parameter enthält die
strukturierten Schlüssel-Wert-Paare, wenn die Nachricht mit einer Kontexttabelle protokolliert wurde; andernfalls ist er nil.

```lua
local LogService = game:GetService("LogService")
local combat = LogService:GetLogger("Combat")

combat.MessageOut:Connect(function(message, messageType, context)
	print("[Combat]", message)
end)

-- Eine Nachricht, die auf einem Nachkommen protokolliert wird, löst auch die MessageOut des Elternteils aus.
combat:GetLogger("Damage"):Info("Treffer für {amount}", {amount = 10})
-- Gibt aus: [Combat] Treffer für 10
```


Logger.MessageOut

message

Die vollständig gerenderte Nachrichtenzeichenfolge nach allen Ersetzungen von Vorlagenplatzhaltern.


messageType

Ein `Enum.MessageType`-Wert, der das Schweregradniveau der
Nachricht angibt.


context

Ein Wörterbuch von Schlüssel-Wert-Paaren, die bereitgestellt wurden, als die Nachricht protokolliert wurde,
oder nil, wenn kein Kontext bereitgestellt wurde.


Wird ausgelöst, wenn eine Nachricht über diesen Logger oder einen seiner
Nachkommen protokolliert wird.


Gibt den Kind-Logger mit dem angegebenen `name` zurück und erstellt ihn, wenn er noch nicht
existiert. Das wiederholte Aufrufen dieser Methode mit demselben Namen gibt die gleiche
Logger-Instanz zurück, solange eine Referenz darauf gehalten wird. Der `Class.Logger.FullPath` des zurückgegebenen
Loggers ist der vollständige Pfad dieses Loggers, gefolgt von `.` und `name`.

Diese Methode löst einen Fehler aus, wenn der Name leer ist, ein `.`-Zeichen enthält oder
Steuerzeichen enthält, wenn der resultierende vollständige Pfad zu lang ist oder wenn die maximale Anzahl von aktiven Loggers überschritten wurde.

```lua
local LogService = game:GetService("LogService")

local network = LogService:GetLogger("Network")
local http = network:GetLogger("Http")

print(http.FullPath)  --> Network.Http
```


Logger:GetLogger

name

Der Name des Kind-Loggers. Muss nicht leer sein, darf kein `.`-Zeichen enthalten und darf keine
Steuerzeichen enthalten.


Der Kind-`Class.Logger`, dessen vollständiger Pfad der vollständige Pfad dieses Loggers
gefolgt von `.name` ist.


Gibt einen Kind-Logger mit dem angegebenen Namen zurück und erstellt ihn, wenn er noch nicht
existiert.


Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageOutput`, gekennzeichnet mit
`Class.Logger.FullPath` dieses Loggers. Wenn eine `context`-Tabelle bereitgestellt wird,
werden Vorlagenplatzhalter wie `{key}` in der Nachricht durch die entsprechenden Kontextwerte ersetzt,
und der Kontext wird als strukturierte Daten für die Anzeige in der Entwicklerkonsole und im **Output**-Fenster von Studio beibehalten.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Shop")

logger:Output("Spieler {name} hat den Shop geöffnet", {name = "Alice"})
-- Ausgabe: "Spieler Alice hat den Shop geöffnet"
```


Logger:Output

Die Nachrichtenzeichenfolge. Unterstützt `{key}`-Vorlagenplatzhalter, wenn eine
Kontexttabelle bereitgestellt wird.


Ein optionales Wörterbuch von Schlüssel-Wert-Paaren. Wenn bereitgestellt, werden `{key}`
Platzhalter in der Nachricht durch die entsprechenden
Werte ersetzt.


Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageOutput` mit optionalem
strukturiertem Kontext.


Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageInfo`, gekennzeichnet mit
`Class.Logger.FullPath` dieses Loggers. Wenn eine `context`-Tabelle bereitgestellt wird,
werden Vorlagenplatzhalter wie `{key}` in der Nachricht durch die entsprechenden Kontextwerte ersetzt.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Info("Fügte {amount} Schaden zu", {amount = 42})
-- Ausgabe: "Fügte 42 Schaden zu"
```


Logger:Info

Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageInfo` mit optionalem
strukturiertem Kontext.


Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageWarning`, gekennzeichnet mit
`Class.Logger.FullPath` dieses Loggers. Wenn eine `context`-Tabelle bereitgestellt wird,
werden Vorlagenplatzhalter wie `{key}` in der Nachricht durch die entsprechenden Kontextwerte ersetzt.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Warn("Gesundheit niedrig: {hp}", {hp = 5})
-- Ausgabe: "Gesundheit niedrig: 5"
```


Logger:Warn

Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageWarning` mit
optionalem strukturiertem Kontext.


Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageError`, gekennzeichnet mit
`Class.Logger.FullPath` dieses Loggers. Im Gegensatz zu `Class.LogService:Error()`,
gibt diese Methode einen Protokolleintrag auf Fehler-Ebene aus und gibt normal zurück; sie wirft
**nicht** eine Ausnahme. Wenn eine `context`-Tabelle bereitgestellt wird, werden Vorlagenplatzhalter
wie `{key}` in der Nachricht durch die entsprechenden Kontextwerte ersetzt.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Network")

logger:Error("Anfrage fehlgeschlagen: {reason}", {reason = "timeout"})
-- Gibt einen Protokolleintrag auf Fehler-Ebene aus; die Ausführung wird fortgesetzt.
```


Logger:Error

Protokolliert eine Nachricht auf der Ebene `Enum.MessageType.MessageError` mit optionalem
strukturiertem Kontext.


Protokolliert eine Nachricht auf der angegebenen `Enum.MessageType`-Ebene, gekennzeichnet mit
`Class.Logger.FullPath` dieses Loggers. Dies ist eine allgemeine Methode, die
`Class.Logger:Output()|Output()`, `Class.Logger:Info()|Info()`,
`Class.Logger:Warn()|Warn()` und `Class.Logger:Error()|Error()` in einem
einzigen Aufruf mit einem expliziten Nachrichten-Typ-Parameter kombiniert. Im Gegensatz zu
`Class.LogService:Log()`, gibt das Übergeben von `Enum.MessageType.MessageError` einen
Protokolleintrag auf Fehler-Ebene aus und gibt normal zurück, anstatt eine Ausnahme zu werfen.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Log(Enum.MessageType.MessageInfo, "Ereignis {action}", {action = "spawn"})
```


Logger:Log

Der `Enum.MessageType`, der die Protokollebene angibt.


Protokolliert eine Nachricht auf der angegebenen Ebene mit optionalem strukturiertem Kontext.


Logger

Der Name dieses Loggers, wie er an `Class.LogService:GetLogger()` oder
`Class.Logger:GetLogger()` übergeben wurde. Dies ist ein einzelnes Pfadsegment und enthält niemals ein `.`-Zeichen. Verwenden Sie `Class.Logger.FullPath` für den vollständigen
punktverbundenen Pfad.


Logger.Name

Das Namenssegment dieses Loggers innerhalb seines Elternteils.


Der vollständige Pfad dieses Loggers, der durch das Verbinden des `Class.Logger.Name` jedes Loggers von der Wurzel bis zu diesem mit `.`-Trennzeichen gebildet wird. Für einen
obersten Logger entspricht der vollständige Pfad seinem Namen. Nachrichten, die über
diesen Logger protokolliert werden, sind in
`Class.LogService:GetLogHistory()` mit diesem vollständigen Pfad gekennzeichnet.


Logger.FullPath

Der punktverbundene Pfad dieses Loggers vom Wurzel-Logger.


Ein benannter Logger, der strukturierte Protokolleinträge ausgibt, die auf einem hierarchischen
Pfad basieren.


`Object` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie.
Jede andere Klasse, die die Roblox-Engine definiert, erbt alle Mitglieder
von `Object`. Es ist nicht möglich, ein `Object` direkt zu erstellen.


Dieses Beispiel demonstriert die Feinheiten des `Changed`-Ereignisses bei normalen
Objekten und `Value`-Objekten.


Dieses Codebeispiel demonstriert das Auslösen des Changed-Events innerhalb eines übergeordneten Objekts.


Dieses Ereignis wird sofort ausgelöst, nachdem eine Objekteigenschaft geändert wurde, mit
einigen Ausnahmen (siehe unten). Der neue Wert einer geänderten Eigenschaft wird
**nicht** als Parameter übergeben. Stattdessen können Sie darauf zugreifen, indem Sie
`object[property]` verwenden:

```
object.Changed:Connect(function(property)
	print("Der neue Wert der Eigenschaft ist", object[property])
end)
```

- Wenn Sie nur daran interessiert sind, Änderungen an einer bestimmten
  Eigenschaft zu hören, sollten Sie stattdessen die
  `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`
  Methode verwenden.
- Um Änderungen an Attributen zu hören, siehe
  `Class.Instance:GetAttributeChangedSignal()` und
  `Class.Instance.AttributeChanged`.
- Um zu erkennen, wann Kinder hinzugefügt oder entfernt werden, siehe
  `Class.Instance.ChildAdded` und `Class.Instance.ChildRemoved`.

Für `Class.ValueBase`-Objekte wie `Class.IntValue` und
`Class.StringValue` wird dieses Ereignis nur ausgelöst, wenn sich die `Value`
Eigenschaft des Objekts ändert. Um andere Änderungen an `Class.ValueBase`-Objekten zu erkennen,
verwenden Sie `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`.

#### Einschränkungen

Dieses Ereignis wird **nicht** für physikbezogene Änderungen ausgelöst, wie wenn sich die
`Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position` oder
`Class.BasePart.Orientation|Orientation`-Eigenschaften eines `Class.BasePart`
wegen der Schwerkraft ändern. Um Änderungen an diesen Eigenschaften zu erkennen, sollten
Sie ein physikbasiertes Ereignis wie `Class.RunService.PreSimulation` verwenden.
Ebenso wird das `Changed`-Ereignis nicht ausgelöst, wenn sich
`Class.BasePart.AssemblyMass|AssemblyMass` aufgrund einer Änderung des
Materials, der Größe oder der Dichte für ein geschweißtes Teil aktualisiert (aber das Ereignis wird für
`Class.BasePart.Mass|Mass` ausgelöst, wenn Sie die Größe eines Teils ändern).

Für Eigenschaften, die häufig geändert werden, wird das `Changed`-Ereignis möglicherweise nicht
bei jeder Änderung ausgelöst oder es wird möglicherweise überhaupt nicht ausgelöst. **Wenn eine
Änderung der Eigenschaft Ihre Spiel-Logik beeinflusst, testen Sie sorgfältig**, um sicherzustellen, dass das Ereignis
wie erwartet ausgelöst wird.


Object.Changed

property

Der Name der Eigenschaft, die sich geändert hat.


Wird sofort ausgelöst, nachdem sich eine Eigenschaft des Objekts ändert, mit einigen
Einschränkungen.


Dieses Codebeispiel zeigt, wie man einen Wert speichert, bevor ein Änderungsereignis ausgelöst wird,
um mehr Informationen über eine Änderung zu erhalten.


Dieses Codebeispiel zeigt die Gleichwertigkeit des `Changed`-Ereignisses und des Ereignisses,
 das von `GetPropertyChangedSignal` zurückgegeben wird.

Diese Methode gibt ein Ereignis zurück, das sich genau wie das
`Class.Object.Changed|Changed`-Ereignis verhält, mit dem Unterschied, dass es nur ausgelöst wird, wenn sich die
angegebene Eigenschaft ändert. Es ist im Allgemeinen eine gute Idee, diese Methode zu verwenden,
anstatt eine Verbindung zu `Class.Object.Changed|Changed` mit einer Funktion herzustellen,
die den Eigenschaftsnamen überprüft. Nachfolgende Aufrufe dieser Methode für dasselbe
Objekt mit demselben Eigenschaftsnamen geben dasselbe Ereignis zurück.

`Class.ValueBase`-Objekte, wie `Class.IntValue` und
`Class.StringValue`, verwenden ein modifiziertes `Class.Object.Changed|Changed`-Ereignis,
das mit dem Inhalt ihrer `Value`-Eigenschaft ausgelöst wird. Daher bietet diese
Methode eine Möglichkeit, Änderungen an anderen Eigenschaften dieser
Objekte zu erkennen.

Beachten Sie, dass dieses Ereignis keine Argumente an eine verbundene Funktion übergibt,
so dass der Wert der geänderten Eigenschaft direkt innerhalb eines
Skripts gelesen werden muss.

#### Einschränkungen

Das von dieser Methode zurückgegebene Ereignis wird **nicht** für physikbezogene
Änderungen ausgelöst, wie wenn sich die `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position` oder
`Class.BasePart.Orientation|Orientation`-Eigenschaften eines `Class.BasePart`
wegen der Schwerkraft ändern. Um Änderungen an diesen Eigenschaften zu erkennen, sollten
Sie ein physikbasiertes Ereignis wie `Class.RunService.PreSimulation` verwenden.

Darüber hinaus wird das zurückgegebene Ereignis möglicherweise nicht bei jeder Änderung von
Eigenschaften ausgelöst, die sehr häufig geändert werden, und/oder es wird möglicherweise
überhaupt nicht für solche Eigenschaften ausgelöst. Es wird empfohlen, dass Sie sorgfältig
auf Änderungen von Eigenschaften testen, die die Spiel-Logik beeinflussen.


Object:GetPropertyChangedSignal

Die Eigenschaft, mit der verbunden werden soll.


Ein Signal, das ausgelöst wird, wann immer sich die Eigenschaft ändert.


Erhalten Sie ein Ereignis, das ausgelöst wird, wenn sich eine bestimmte Eigenschaft des Objekts ändert.


Demonstriert die Bestimmung der Klasse von Workspace mit `Class.Instance:IsA()`

Workspace ist von der Klasse 'Workspace', daher ist die erste Aussage wahr. Workspace
ist nicht von der Klasse 'BasePart', daher ist die zweite Aussage falsch. Workspace
erbt von Instance und ist daher von der Klasse 'Instance', daher ist die dritte
Aussage wahr.

IsA gibt true zurück, wenn die Klasse des Objekts **äquivalent zu** oder eine
**Unterklasse** einer bestimmten Klasse ist. Diese Funktion ist ähnlich den
**instanceof**-Operatoren in anderen Sprachen und ist eine Form der
[type introspection](https://en.wikipedia.org/wiki/Type_introspection). Um
Klassenvererbung zu ignorieren, testen Sie stattdessen direkt die `Class.Object.ClassName|ClassName`
Eigenschaft. Für die Überprüfung von nativen Luau-Datentypen (Zahl,
String usw.) verwenden Sie die Funktionen `type` und `typeof`.

Am häufigsten wird diese Funktion verwendet, um zu testen, ob ein Objekt eine Art von
Teil ist, wie `Class.Part` oder `Class.WedgePart`, die von
`Class.BasePart` (einer abstrakten Klasse) erben. Wenn Ihr Ziel darin besteht,
alle Gliedmaßen eines Charakters in die gleiche Farbe zu ändern, könnten Sie
`Class.Instance:GetChildren()|GetChildren` verwenden, um über die Kinder zu iterieren,
und dann IsA verwenden, um nicht-`Class.BasePart`-Objekte herauszufiltern, die nicht die
`Datatype.BrickColor`-Eigenschaft haben:

```lua
local Players = game:GetService("Players")

local function paintFigure(character, color)
	-- Über die Kindobjekte des Charakters iterieren
	for _, child in character:GetChildren() do
		-- Nicht-Teilobjekte wie Shirt, Pants und Humanoid herausfiltern
		-- R15 verwendet MeshPart und R6 verwendet Part, daher verwenden wir hier BasePart, um beide zu erkennen:
		if child:IsA("BasePart") then
			child.BrickColor = color
		end
	end
end
paintFigure(Players.Player.Character, BrickColor.new("Bright blue"))
```
Da alle Klassen von `Class.Object` erben, gibt der Aufruf
`object:IsA("Object")` immer true zurück.


Object:IsA

className

Die Klasse, gegen die die Klasse des Objekts überprüft wird.
Groß- und Kleinschreibung beachten.


Beschreibt, ob die Klasse des Objekts übereinstimmte oder eine Unterklasse der
given Klasse ist.


Gibt true zurück, wenn die Klasse eines Objekts mit einer bestimmten Klasse übereinstimmt oder von ihr erbt.


Object:isA

Object

Ein schreibgeschützter String, der die Klasse darstellt, zu der dieses `Class.Object` gehört.

Diese Eigenschaft kann mit verschiedenen anderen Funktionen verwendet werden, die dazu dienen,
Objekte nach Typ zu identifizieren, wie `Class.Object:IsA()` oder
`Class.Instance:FindFirstChildOfClass()`.

Beachten Sie, dass diese Eigenschaft schreibgeschützt ist und nicht von Skripten geändert werden kann.
Entwickler, die die Klasse eines Objekts ändern möchten, müssen stattdessen ein neues
`Class.Object` erstellen.

Im Gegensatz zu `Class.Object:IsA()` kann ClassName verwendet werden, um zu überprüfen, ob ein Objekt
zu einer bestimmten Klasse gehört, wobei die Klassenvererbung ignoriert wird. Zum Beispiel:


Object.ClassName

Ein schreibgeschützter String, der die Klasse darstellt, zu der dieses `Class.Object` gehört.


Object.className

`Object` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie.


Luau

Dictionary

Ein benannter Logger, der strukturierte Protokolleinträge ausgibt, die auf einem hierarchischen Pfad basieren.

Class

Enum

Enum.MessageType

Ein Objekt, das verbundene Funktionen bei einem bestimmten Ereignis ausführt.

Data Type

RBXScriptSignal

Datentyp mit einem Wert von entweder wahr oder falsch.

boolean

Eine Folge von Zeichen wie Buchstaben, Zahlen und Symbolen.

string

Experiences

Avatar

Objekte

Beispiele und Projekte

Engine-API

Open-Cloud-API

Studio

Analytics

Plattform

Tutorials

Creator-Programme

Bildung

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.

Gewährt Zugriff auf die Konfiguration von Abrechnungskonten und den Kauf von Werbe-Credits.

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, Analysewarnungen zu lesen.

Gewährt die Fähigkeit, Analysewarnungen zu erstellen oder zu ändern.

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

Gewährt die Berechtigung, Ressourcen im Zusammenhang mit Spielanalysen zu schreiben.

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.

Dies ermöglicht, Vorschaubilder und Personalisierungseinstellungen der Vorschaubilder für deine Experiences anzuzeigen.

Dies ermöglicht, Vorschaubilder hochzuladen und zu löschen und Personalisierungseinstellungen der Vorschaubilder für deine Experiences zu verwalten.

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.

Gewährt die Fähigkeit, die Events eines Spiels zu lesen.

Gewährt die Fähigkeit, Spiel-Events zu bearbeiten.

Dies aktiviert Single Sign-On-Funktionalität.

Dies gewährt Zugriff auf das Lesen deiner Profilinformationen.

Zusammenfassung