`Logger` emituje strukturalne wpisy logów, które są oznaczone hierarchiczną
nazwą, co pozwala grupować powiązane wiadomości według podsystemu lub funkcji. Uzyskaj
logger najwyższego poziomu z `Class.LogService:GetLogger()`, a następnie twórz zagnieżdżone
loggery podrzędne za pomocą `Class.Logger:GetLogger()`. Każdy logger ma krótką
`Class.Logger.Name` oraz połączoną kropkami `Class.Logger.FullPath` zbudowaną z jego
przodków (na przykład logger o nazwie `Damage` utworzony z loggera o nazwie
`Combat` ma pełną ścieżkę `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("Zadano {amount} obrażeń {target}", {amount = 25, target = "Goblin"})
```
Loggery zachowują się tak samo jak metody logowania strukturalnego w
`Class.LogService`: wiadomości trafiają do okna **Output**, Konsoli Dewelopera
oraz `Class.LogService.MessageOut`, i są uwzględniane w
`Class.LogService:GetLogHistory()` oznaczone pełną ścieżką loggera.

#### Hierarchia i Propagacja

Gdy wiadomość jest logowana na loggerze, jego `Class.Logger.MessageOut` zdarzenie
uruchamia się na tym loggerze **i** na każdym przodku aż do korzenia. Pozwala to
przypiąć nasłuchiwacz do loggera rodzica, aby obserwować wszystkie wiadomości emitowane przez jego
dzieci. Wiadomość jest emitowana do systemu wyjściowego silnika dokładnie
raz, oznaczona pełną ścieżką loggera, z którego pochodzi.

#### Składnia Szablonów i Kontekst

Metody logowania akceptują te same `{key}` miejsca na szablony i
`tabele kontekstowe` jak metody logowania strukturalnego w `Class.LogService`. Zobacz
`Class.LogService` po szczegóły dotyczące składni szablonów i jak wartości kontekstu są
przechowywane.

#### Czas życia

Logger pozostaje ważny tak długo, jak długo trzymasz do niego odniesienie. Gdy wszystkie
odniesienia do loggera (i jego potomków) są zwolnione, jest odzyskiwany,
a wywołanie jakiejkolwiek metody na przestarzałym loggerze zgłasza błąd. Liczba aktywnych
loggerów i długość pełnej ścieżki loggera są ograniczone; przekroczenie
któregokolwiek z tych limitów zgłasza błąd z `Class.Logger:GetLogger()`.

#### Ostrzeżenie

Ta klasa może mieć nieoczekiwane lub niestabilne zachowanie, a zawartość może być
obcięta. Nie polegaj na zawartości zdarzeń i wiadomości emitowanych przez loggery
w żadnej ważnej logice gry.


Uruchamia się za każdym razem, gdy wiadomość jest logowana przez ten logger lub jakikolwiek logger
poniżej niego w hierarchii. Ponieważ logowana wiadomość uruchamia `MessageOut`
on loggerze źródłowym i każdym z jego przodków, nasłuchiwacz przypięty
do loggera rodzica obserwuje każdą wiadomość emitowaną przez jego potomków. Parametr
`message` zawiera w pełni renderowany tekst (miejsca na szablony już zastąpione), a parametr
`context` przenosi strukturalne pary klucz-wartość, gdy wiadomość została zalogowana z tabelą kontekstu;
w przeciwnym razie jest nil.

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

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

-- Wiadomość zalogowana na potomku również uruchamia MessageOut rodzica.
combat:GetLogger("Damage"):Info("Uderzenie za {amount}", {amount = 10})
-- Wydrukuje: [Combat] Uderzenie za 10
```


Logger.MessageOut

message

W pełni renderowany ciąg wiadomości po wszelkich substytucjach miejsc na szablony.


messageType

Wartość `Enum.MessageType` wskazująca poziom powagi
wiadomości.


context

Słownik par klucz-wartość podany, gdy wiadomość została zalogowana,
lub nil, jeśli nie podano kontekstu.


Uruchamia się, gdy wiadomość jest logowana przez ten logger lub jakikolwiek z jego
dzieci.


Zwraca loggera podrzędnego o podanej `name`, tworząc go, jeśli jeszcze
nie istnieje. Wywołanie tego samego nazwy wielokrotnie zwraca tę samą
instancję loggera tak długo, jak długo trzymasz do niego odniesienie. Pełna
ścieżka zwróconego loggera `Class.Logger.FullPath` to pełna ścieżka tego loggera
z kropką i `name` na końcu.

Ta metoda zgłasza błąd, jeśli nazwa jest pusta, zawiera `.` lub
zawiera znaki kontrolne, jeśli wynikowa pełna ścieżka jest zbyt długa, lub jeśli
maksymalna liczba aktywnych loggerów została przekroczona.

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

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

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


Logger:GetLogger

name

Nazwa loggera podrzędnego. Musi być niepusta, nie może zawierać znaku
`.` i nie może zawierać znaków kontrolnych.


Logger podrzędny `Class.Logger`, którego pełna ścieżka to pełna ścieżka tego loggera
z kropką i `.name` na końcu.


Zwraca loggera podrzędnego o podanej nazwie, tworząc go, jeśli jeszcze
nie istnieje.


Loguje wiadomość na poziomie `Enum.MessageType.MessageOutput`, oznaczoną
pełną ścieżką `Class.Logger.FullPath` tego loggera. Gdy tabela `context` jest podana,
 miejsca na szablony, takie jak `{key}` w wiadomości, są zastępowane
odpowiednimi wartościami kontekstu, a kontekst jest zachowywany jako strukturalne
dane do wyświetlenia w Konsoli Dewelopera i oknie **Output** w Studio.

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

logger:Output("Gracz {name} otworzył sklep", {name = "Alice"})
-- Wyjście: "Gracz Alice otworzył sklep"
```


Logger:Output

Ciąg wiadomości. Obsługuje miejsca na szablony `{key}`, gdy tabela
kontekstu jest podana.


Opcjonalny słownik par klucz-wartość. Gdy jest podany, miejsca na szablony `{key}`
w wiadomości są zastępowane odpowiednimi wartościami.


Loguje wiadomość na poziomie `Enum.MessageType.MessageOutput` z opcjonalnym
strukturalnym kontekstem.


Loguje wiadomość na poziomie `Enum.MessageType.MessageInfo`, oznaczoną
pełną ścieżką `Class.Logger.FullPath` tego loggera. Gdy tabela `context` jest podana,
 miejsca na szablony, takie jak `{key}` w wiadomości, są zastępowane
odpowiednimi wartościami kontekstu.

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

logger:Info("Zadano {amount} obrażeń", {amount = 42})
-- Wyjście: "Zadano 42 obrażeń"
```


Logger:Info

Loguje wiadomość na poziomie `Enum.MessageType.MessageInfo` z opcjonalnym
strukturalnym kontekstem.


Loguje wiadomość na poziomie `Enum.MessageType.MessageWarning`, oznaczoną
pełną ścieżką `Class.Logger.FullPath` tego loggera. Gdy tabela `context` jest podana,
 miejsca na szablony, takie jak `{key}` w wiadomości, są zastępowane
odpowiednimi wartościami kontekstu.

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

logger:Warn("Niskie zdrowie: {hp}", {hp = 5})
-- Wyjście: "Niskie zdrowie: 5"
```


Logger:Warn

Loguje wiadomość na poziomie `Enum.MessageType.MessageWarning` z
opcjonalnym strukturalnym kontekstem.


Loguje wiadomość na poziomie `Enum.MessageType.MessageError`, oznaczoną
pełną ścieżką `Class.Logger.FullPath` tego loggera. W przeciwieństwie do
`Class.LogService:Error()`, ta metoda emituje wpis logu na poziomie błędu i zwraca normalnie;
nie zgłasza. Gdy tabela `context` jest podana, miejsca na szablony
jak `{key}` w wiadomości są zastępowane odpowiednimi wartościami kontekstu.

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

logger:Error("Żądanie nie powiodło się: {reason}", {reason = "timeout"})
-- Emituje wpis logu na poziomie błędu; wykonanie trwa.
```


Logger:Error

Loguje wiadomość na poziomie `Enum.MessageType.MessageError` z opcjonalnym
strukturalnym kontekstem.


Loguje wiadomość na określonym poziomie `Enum.MessageType`, oznaczoną pełną
ścieżką `Class.Logger.FullPath` tego loggera. Jest to metoda ogólnego przeznaczenia,
która łączy `Class.Logger:Output()|Output()`, `Class.Logger:Info()|Info()`,
`Class.Logger:Warn()|Warn()`, i `Class.Logger:Error()|Error()` w
jedno wywołanie z explicytnym parametrem typu wiadomości. W przeciwieństwie do
`Class.LogService:Log()`, przekazanie `Enum.MessageType.MessageError` emituje
log na poziomie błędu i zwraca normalnie, zamiast zgłaszać.

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

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


Logger:Log

`Enum.MessageType` określający poziom logowania.


Loguje wiadomość na określonym poziomie z opcjonalnym strukturalnym kontekstem.


Logger

Nazwa tego loggera, jak podano w `Class.LogService:GetLogger()` lub
`Class.Logger:GetLogger()`. Jest to pojedynczy segment ścieżki i nigdy
nie zawiera znaku `.`. Użyj `Class.Logger.FullPath` dla pełnej
dot-łączonej ścieżki.


Logger.Name

Segment nazwy tego loggera w jego rodzicu.


Pełna ścieżka tego loggera, utworzona przez połączenie `Class.Logger.Name` każdego
loggera od korzenia do tego z separatorami `.`. Dla loggera najwyższego poziomu pełna
ścieżka równa się jego nazwie. Wiadomości logowane przez ten logger są oznaczone tą
pełną ścieżką w `Class.LogService:GetLogHistory()`.


Logger.FullPath

Ścieżka połączona kropkami tego loggera od loggera głównego.


Nazwany logger, który emituje strukturalne wpisy logów ograniczone do hierarchicznej
ścieżki.


`Object` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox.
Każda inna klasa, którą definiuje silnik Roblox, dziedziczy wszystkie człony
klasy `Object`. Nie jest możliwe bezpośrednie utworzenie `Object`.


Ten przykład demonstruje subtelności zdarzenia `Changed` na normalnych
obiektach i obiektach `Value`.


Ten przykład kodu demonstruje wywoływanie zdarzenia Changed w obiekcie nadrzędnym.


To zdarzenie wyzwala się natychmiast po zmianie właściwości obiektu, z
pewnymi wyjątkami (patrz poniżej). Nowa wartość zmienionej właściwości jest
**nie** przekazywana jako parametr. Zamiast tego możesz uzyskać do niej dostęp,
korzystając z `object[property]`:

```
object.Changed:Connect(function(property)
	print("Nowa wartość właściwości to", object[property])
end)
```

- Jeśli interesuje Cię tylko nasłuchiwanie zmian w jednej konkretnej
  właściwości, rozważ użycie metody
  `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`
  zamiast tego.
- Aby nasłuchiwać zmiany w atrybutach, zobacz
  `Class.Instance:GetAttributeChangedSignal()` i
  `Class.Instance.AttributeChanged`.
- Aby wykryć, kiedy dzieci są dodawane lub usuwane, zobacz
  `Class.Instance.ChildAdded` i `Class.Instance.ChildRemoved`.

Dla obiektów `Class.ValueBase`, takich jak `Class.IntValue` i
`Class.StringValue`, to zdarzenie wyzwala się tylko wtedy, gdy zmienia się
właściwość `Value` obiektu. Aby wykryć inne zmiany w obiektach `Class.ValueBase`,
korzystaj z `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`.

#### Ograniczenia

To zdarzenie **nie** wyzwala się dla zmian związanych z fizyką, takich jak gdy
właściwości `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position` lub
`Class.BasePart.Orientation|Orientation` obiektu `Class.BasePart`
zmieniają się z powodu grawitacji. Aby wykryć zmiany w tych właściwościach,
rozważ użycie zdarzenia opartego na fizyce, takiego jak `Class.RunService.PreSimulation`.
Podobnie, zdarzenie `Changed` nie wyzwala się, gdy
`Class.BasePart.AssemblyMass|AssemblyMass` aktualizuje się z powodu zmiany w
materiałach, rozmiarze lub gęstości dla zespawanej części (ale zdarzenie wyzwala się dla
`Class.BasePart.Mass|Mass`, jeśli zmienisz rozmiar części).

Dla właściwości, które zmieniają się często, zdarzenie `Changed` może nie wyzwalać się
przy każdej modyfikacji, lub może w ogóle się nie wyzwalać. **Jeśli zmiana
właściwości wpływa na logikę Twojej gry, testuj dokładnie**, aby upewnić się, że zdarzenie
wyzwala się tak, jak oczekujesz.


Object.Changed

property

Nazwa właściwości, która się zmieniła.


Wyzwala się natychmiast po zmianie właściwości obiektu, z pewnymi
ograniczeniami.


Ten przykład kodu demonstruje, jak zapisać wartość przed wywołaniem zdarzenia zmiany
na niej, aby uzyskać więcej informacji o zmianie.


Ten przykład kodu demonstruje równoważność zdarzenia `Changed` i zdarzenia
zwracanego przez `GetPropertyChangedSignal`.

Ta metoda zwraca zdarzenie, które zachowuje się dokładnie jak
`Class.Object.Changed|Changed`, z tą różnicą, że wyzwala się tylko wtedy, gdy
zmienia się dana właściwość. Zazwyczaj dobrym pomysłem jest użycie tej metody
zamiast połączenia z `Class.Object.Changed|Changed` z funkcją,
która sprawdza nazwę właściwości. Kolejne wywołania tej metody na tym samym
obiekcie z tą samą nazwą właściwości zwracają to samo zdarzenie.

Obiekty `Class.ValueBase`, takie jak `Class.IntValue` i
`Class.StringValue`, używają zmodyfikowanego zdarzenia `Class.Object.Changed|Changed`,
które wyzwala się z zawartością ich właściwości `Value`. W związku z tym,
metoda ta zapewnia sposób na wykrywanie zmian w innych właściwościach tych
obiektów.

Zauważ, że to zdarzenie nie przekaże żadnych argumentów do połączonej funkcji,
więc wartość zmienionej właściwości musi być odczytana bezpośrednio w
skrypcie.

#### Ograniczenia

Zdarzenie zwrócone przez tę metodę **nie** wyzwala się dla zmian związanych z fizyką,
na przykład, gdy właściwości `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position` lub
`Class.BasePart.Orientation|Orientation` obiektu `Class.BasePart`
zmieniają się z powodu grawitacji. Aby wykryć zmiany w tych właściwościach,
rozważ użycie zdarzenia opartego na fizyce, takiego jak `Class.RunService.PreSimulation`.

Dodatkowo, zwrócone zdarzenie może nie wyzwalać się przy każdej modyfikacji
właściwości, które zmieniają się bardzo często, i/lub może w ogóle nie wyzwalać się dla takich
właściwości. Zaleca się dokładne testowanie zmian właściwości, które wpływają na logikę gry.


Object:GetPropertyChangedSignal

Właściwość, do której chcesz się połączyć.


Sygnal, który wyzwala się za każdym razem, gdy zmienia się właściwość.


Uzyskaj zdarzenie, które wyzwala się, gdy zmienia się dana właściwość obiektu.


Demonstruje określenie klasy Workspace za pomocą `Class.Instance:IsA()`

Workspace jest klasy 'Workspace', więc pierwsze stwierdzenie jest prawdziwe. Workspace
nie jest klasy 'BasePart', więc drugie stwierdzenie jest fałszywe. Workspace
odziedzicza po Instance i dlatego jest klasy 'Instance', więc trzecie
stwierdzenie jest prawdziwe.


IsA zwraca true, jeśli klasa obiektu jest **równoważna** lub jest
**podklasą** danej klasy. Ta funkcja jest podobna do operatorów
**instanceof** w innych językach i jest formą
[introspekcji typu](https://en.wikipedia.org/wiki/Type_introspection). Aby
ignorować dziedziczenie klas, sprawdź właściwość `Class.Object.ClassName|ClassName`
bezpośrednio. Aby sprawdzić natywne typy danych Luau (liczba,
ciąg itp.), użyj funkcji `type` i `typeof`.

Najczęściej ta funkcja jest używana do testowania, czy obiekt jest jakimś rodzajem
części, takiej jak `Class.Part` lub `Class.WedgePart`, które dziedziczą z
`Class.BasePart` (klasa abstrakcyjna). Na przykład, jeśli Twoim celem jest
zmiana koloru wszystkich kończyn postaci, możesz użyć
`Class.Instance:GetChildren()|GetChildren`, aby iterować po dzieciach,
następnie użyć IsA, aby filtrować obiekty, które nie są `Class.BasePart` i nie mają
właściwości `Datatype.BrickColor`:

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

local function paintFigure(character, color)
	-- Iteruj po obiektach dziecka postaci
	for _, child in character:GetChildren() do
		-- Filtrowanie obiektów, które nie są częścią, takich jak Koszula, Spodnie i Humanoid
		-- R15 używa MeshPart, a R6 używa Part, więc używamy BasePart, aby wykryć oba:
		if child:IsA("BasePart") then
			child.BrickColor = color
		end
	end
end
paintFigure(Players.Player.Character, BrickColor.new("Bright blue"))
```
Ponieważ wszystkie klasy dziedziczą z `Class.Object`, wywołanie
`object:IsA("Object")` zawsze zwróci true.


Object:IsA

className

Klasa, w odniesieniu do której będzie sprawdzana klasa obiektu.
Wrażliwe na wielkość liter.


Opisuje, czy klasa obiektu pasowała do danej klasy lub jest jej podklasą.


Zwraca true, jeśli klasa obiektu pasuje do danej klasy lub dziedziczy z niej.


Object:isA

Object

Niezmienny ciąg znaków reprezentujący klasę, do której należy ten `Class.Object`.

Ta właściwość może być używana z różnymi innymi funkcjami, które są używane do
identyfikacji obiektów według typu, takimi jak `Class.Object:IsA()` lub
`Class.Instance:FindFirstChildOfClass()`.

Zauważ, że ta właściwość jest tylko do odczytu i nie może być zmieniana przez skrypty.
Deweloperzy, którzy chcą zmienić klasę obiektu, muszą zamiast tego utworzyć
nowy `Class.Object`.

W przeciwieństwie do `Class.Object:IsA()`, ClassName może być używane do sprawdzenia, czy obiekt
należy do konkretnej klasy, ignorując dziedziczenie klas. Na przykład:


Object.ClassName

Niezmienny ciąg znaków reprezentujący klasę, do której należy ten `Class.Object`.


Object.className

`Object` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox.


Luau

Dictionary

Nazwany logger, który emituje strukturalne wpisy logów ograniczone do hierarchicznej ścieżki.

Class

Kategoria wiadomości i poziom ważności.

Enum

Enum.MessageType

Obiekt, który wykonuje połączone funkcje po określonym wystąpieniu.

Data Type

RBXScriptSignal

Typ danych mający wartość prawdziwą lub fałszywą.

boolean

Sekwencja znaków, takich jak litery, cyfry i symbole.

string

Projekty

Awatar

Zasoby

Przykłady i projekty

Interfejs API silnika

Otwarty interfejs API

Studio

Analityka

Platforma

Samouczki

Programy dla twórców

Edukacyjne

Edukacja

Uwierzytelnianie za pomocą klucza interfejsu API.

Jest to metoda asynchroniczna, która zwraca deskryptor „Operation”, odpowiadający bieżącemu stanowi operacji. Zawiera punkt końcowy, który można wybrać przy użyciu funkcji poll, aby otrzymać rzeczywistą odpowiedź i nadające się do użycia metadane. Więcej informacji na temat operacji długotrwałych zawiera [dokumentacja]({longRunningOperationsLink}).
            
W poniższych sekcjach opisano odpowiedzi i obiekty w postaci metadanych, które zostają podane po ukończeniu operacji.

Punkty końcowe beta są gotowe do użytku publicznego. Zmiany wywołujące przerwy są możliwe, ale rzadkie.

Te strony dokumentacji Open Cloud zostaną usunięte 31 marca 2026 r. Wtedy nastąpi automatyczne przekierowanie do nowej dokumentacji Open Cloud. {linkStart}Dowiedz się więcej{linkEnd}

Te stare strony dotyczące Open Cloud zostaną usunięte, a użytkownicy zostaną przekierowani 31 marca 2026 r. {linkStart}Dowiedz się więcej{linkEnd}

Eksperymentalne punkty końcowe są gotowe do publicznego użycia, ale mogą czasami ulegać zmianom powodującym niezgodność w miarę finalizowania kontraktu API.

Ten punkt końcowy można wywołać w ramach interfejsu użytkownika za pośrednictwem usługi {httpServiceLinkStart}HttpService{httpServiceLinkEnd} przy użyciu klucza interfejsu API.

To pole może być skonfigurowane podczas tworzenia zasobu, ale może nie być modyfikowane przez kolejne żądania.

Te pola mogą być skonfigurowane podczas tworzenia zasobu, ale nie mogą być modyfikowane przez kolejne żądania.

To pole może być podane w żądaniach, ale nigdy nie będzie uwzględniane w odpowiedziach.

Starsza metoda uwierzytelniania. Zawsze wybieraj klucz interfejsu API lub OAuth 2.0, jeśli są dostępne.

Na klucz API: żądanie {maxInPeriod} co {periodInSeconds} s na adres IP

Nie wymaga uwierzytelnienia do wywołania. Zazwyczaj ma znacznie obniżone limity żądań. Zawsze używaj klucza interfejsu API lub protokołu OAuth 2.0, jeśli są dostępne.

Dla każdego grupowania należy podać tylko jedno z następujących pól w schemacie, pozostałe można wykluczyć.

W każdej chwili możesz ponownie ją włączyć. {linkStart}Prześlij opinię.{linkEnd}

Wyświetlasz starą dokumentację. {linkStart}Prześlij opinię.{linkEnd}

W każdej chwili możesz zrezygnować z tej opcji i powrócić do stron ze starą dokumentacją. {linkStart}Prześlij opinię.{linkEnd}

Wyświetlasz zaktualizowaną dokumentację. {linkStart}Prześlij opinię.{linkEnd}

To pole może być skonfigurowane do użycia w odpowiedziach, ale będzie ignorowane w żądaniach.

Uwaga: limity częstotliwości wysyłania żądań mogą być niższe w okresach dużego ruchu. Niektóre punkty końcowe mają dodatkowe limity częstotliwości wysyłania żądań. [Więcej informacji o limitach częstotliwości wysyłania żądań]({link}).

Liczba żądań na dzień dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na godzinę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na minutę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na sekundę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na minutę na każdego właściciela klucza interfejsu API: {limit}

Liczba żądań na dzień na każdego użytkownika aplikacji: {limit}

Liczba żądań na godzinę na każdego użytkownika aplikacji: {limit}

Liczba żądań na minutę na każdego użytkownika aplikacji: {limit} 

Liczba żądań na sekundę na każdego użytkownika aplikacji: {limit}

Liczba żądań na sekundę na każdego właściciela klucza interfejsu API: {limit}

Zakresy służą do kontroli uprawnień, które przysługują Twoim poświadczeniom. Twoje poświadczenia mogą uzyskiwać dostęp wyłącznie do punktów końcowych, które są obsługiwane przez wybrane przez Ciebie zakresy.

Stabilne punkty końcowe są gotowe do użycia w środowisku produkcyjnym i niemal nigdy nie przechodzą zmian, które mogłyby spowodować niezgodność w trakcie ich działania.

Ten cel pozwala Ci ograniczyć dostęp Twojego klucza do wybranych {requiredParts}

Ten cel pozwala Ci ograniczyć dostęp Twojego klucza do wybranych {requiredParts} i {optionalParts}

Typy celów służą do ograniczania zasobów, do których masz uprawnienia zgodnie ze swoimi danymi dostępu. Działania mogą być podejmowane wyłącznie na wybranych zasobach, nawet jeżeli Twoje konto ma uprawnienia do dodatkowych zasobów. Niektóre zakresy nie mają wskazanych typów celów. W takich przypadkach działania mogą być podejmowane na wszystkich odpowiednich zasobach.

W przypadku kluczy API należących do użytkownika nie trzeba wybierać części najwyższego poziomu uniwersum. W takim przypadku klucz API będzie miał dostęp do wszystkich Twoich środowisk należących do użytkownika i środowisk należących do grupy, do których masz odpowiednie uprawnienia grupowe.

Funkcja „Wypróbuj” nie jest jeszcze obsługiwana w odniesieniu do punktów końcowych wymagających klucza API lub uwierzytelniania OAuth 2.0

Ze względów bezpieczeństwa uwierzytelnianie za pomocą plików cookie jest wyłączone w przypadku operacji o wysokim ryzyku.

Punkty końcowe o krytycznym poziomie ryzyka są niezwykle wrażliwe, dlatego funkcja „Wypróbuj” jest wyłączona ze względów bezpieczeństwa

Uwaga: nagłówki uwierzytelniające nie są uwzględnione w tym przykładzie kodu. Aby to polecenie działało, może być konieczne dodanie nagłówka uwierzytelniającego.

Jest to punkt końcowy o wysokim poziomie ryzyka, który może modyfikować lub usuwać dane krytyczne. Podczas testowania należy zachować szczególną ostrożność.

Ten punkt końcowy API został sklasyfikowany jako WYSOKIE RYZYKO i może mieć wpływ na opublikowane dane lub konta użytkowników.

Uwierzytelnione żądania do interfejsów API wysokiego ryzyka mogą wprowadzać zmiany, których nie da się cofnąć. Przed kontynuowaniem dokładnie sprawdź parametry swojego żądania.

Zaloguj się, aby użyć uwierzytelniania za pomocą plików cookie

Jest to punkt końcowy o niskim poziomie ryzyka, który pobiera dane. Na ogół można go bezpiecznie testować.

Jest to punkt końcowy o średnim poziomie ryzyka, który modyfikuje dane. Testuj ostrożnie przy użyciu kont o niekrytycznym znaczeniu, ponieważ zmiany mogą być trwałe.

Aby zapewnić bezpieczeństwo konta, nigdy nie wklejaj tutaj tekstu z innych źródeł ani nigdzie nie wysyłaj informacji z tej strony.

Za chwilę przetestujesz aktywne punkty końcowe interfejsu API przy użyciu rzeczywistych danych logowania do konta.

Przejdź dalej tylko wtedy, gdy rozumiesz konsekwencje wywołań interfejsu API, które zamierzasz wykonać. Przed rozpoczęciem testów dokładnie zapoznaj się z dokumentacją interfejsu API.

Wywołania interfejsu API będą wykonywane przy użyciu Twojej uwierzytelnionej sesji.

Są to rzeczywiste wywołania interfejsu API, które mogą mieć wpływ na Twoje konto lub dane.

Obowiązują limity w zakresie częstotliwości wykonywania wywołań i inne ograniczenia dotyczące interfejsu API.

Niektóre operacje mogą powodować modyfikację lub usunięcie danych.

Ten punkt końcowy został zastąpiony przez następując polecane punkty końcowe:

Aby wywołać ten punkt końcowy, wymagane są następujące zakresy. Aby uzyskać więcej
informacji na temat generowania odpowiednich kluczy, zobacz [Zarządzaj kluczami API]({apiKeyReferenceDocLink}).

Aby uzyskać więcej informacji na temat generowania kluczy, zobacz [Zarządzaj kluczami API]({apiKeyReferenceDocLink}).

Następujące punkty końcowe są dostępne za pośrednictwem ścieżek odnoszących się do podstawowego adresu URL.

Ten ciąg jest sformatowany jako [FieldMask](/cloud/reference/types#fieldmask).

Wartość JSON może być typu „null”, „boolean”, „string”, „number”, „array” lub „object”.

Do umożliwienia aplikacji OAuth 2.0 użycia tego punktu końcowego wymagane są następujące zakresy. Więcej informacji na temat rejestrowania aplikacji OAuth 2.0 można znaleźć w obszarze [Rejestracja i omówienie aplikacji]({oauth2ReferenceDocLink}).

Aby uzyskać więcej informacji na temat rejestracji aplikacji OAuth 2.0, zobacz [Rejestracja i weryfikacja aplikacji]({oauth2ReferenceDocLink}).

Następujące obiekty opisują ładunki, które są przyjmowane lub zwracane. Więcej informacji na temat tego, kiedy te obiekty są w użyciu, można znaleźć w poszczególnych punktach końcowych.

Do wywołania tego punktu końcowego wymagane są następujące zakresy.

Ścieżki do zasobów

Ten ciąg jest sformatowany jako [Timestamp](/cloud/reference/types#timestamp).

Niepolecane

Wyświetlasz zaktualizowaną dokumentację Open Cloud.

Zrezygnowano z korzystania z nowej dokumentacji Open Cloud.

Wyświetl swoje konta rozliczeniowe do reklam.

Przyznaje dostęp do konfigurowania kont rozliczeniowych i zakupu środków na reklamę.

Wyświetlaj swoje kampanie reklamowe i ich wyniki.

Twórz, aktualizuj i zarządzaj kampaniami reklamowymi.

Umożliwia to wyświetlanie informacji na temat Twoich zasobów.

Umożliwia to przesyłanie i aktualizowanie zasobów na platformie Roblox.

Umożliwia to przyznawanie uprawnień do wyświetlania zasobów podmiotom (w tym grupom i projektom) oraz do zasobów, do których Twoje konto ma dostęp.

Umożliwia to przyznawanie uprawnień do zasobów dowolnym podmiotom (w tym grupom i projektom) oraz do zasobów, do których Twoje konto ma dostęp.

Umożliwia to wyświetlanie statusu i wyników zadań automatycznej konfiguracji awatarów w Twoim imieniu.

Umożliwia to tworzenie zadań automatycznej konfiguracji awatarów i zarządzanie nimi w Twoim imieniu.

Umożliwia aktualizowanie odznak należących do użytkownika.

Umożliwia wyświetlanie informacji na temat Twoich komercyjnych przedmiotów.

Umożliwia wprowadzanie zmian w Twoich zsynchronizowanych komercyjnych przedmiotach.

Umożliwia to przeglądanie informacji na temat połączeń z kontami sprzedawców.

Umożliwia edytowanie Twoich połączeń z kontem sprzedawcy.

Umożliwia to wyświetlanie informacji o Twoich produktach ze Sklepu twórcy.

Umożliwia to modyfikowanie informacji o Twoich produktach ze Sklepu twórcy.

Umożliwia to wyświetlanie informacji o zapisanych elementach ze Sklepu twórcy.

Umożliwia to modyfikowanie informacji o zapisanych elementach ze Sklepu twórcy.

Przyznaje dostęp do tworzenia magazynów danych w Twoim imieniu.

Przyznaje dostęp do usuwania magazynów danych w Twoim imieniu.

Przyznaje dostęp do odczytywania listy magazynów danych.

Przyznaje dostęp do tworzenia migawki Twoich magazynów danych.

Przyznaje dostęp do tworzenia wpisów w Twoich magazynach danych.

Przyznaje dostęp do oznaczania określonych wpisów do usunięcia.

Przyznaje dostęp do wyświetlania listy wpisów w magazynie danych.

Przyznaje dostęp do odczytywania określonych wpisów w Twoich magazynach danych.

Przyznaje dostęp do aktualizowania wartości, atrybutów i użytkowników wpisu.

Przyznaje dostęp do usuwania wersji wpisów w magazynie danych.

Przyznaje dostęp do wyświetlania listy wersji wpisów w magazynie danych.

Przyznaje dostęp do odczytywania wersji wpisów w magazynie danych.

Przyznaje dostęp do wyświetlania szczegółów konfiguracji produktów deweloperskich autoryzowanego użytkownika.

Przyznaje dostęp do edytowania produktów deweloperskich autoryzowanego użytkownika.

Umożliwia to wyświetlanie informacji na temat środowisk w Twoim uniwersum.

Umożliwia to edytowanie środowisk w Twoim uniwersum.

Przyznaje dostęp do wyświetlania szczegółów konfiguracji przepustek do gry autoryzowanego użytkownika.

Przyznaje dostęp do edytowania przepustek do gry autoryzowanego użytkownika.

Przyznaje dostęp do wyświetlania informacji o forach społeczności związanych z Twoim kontem.

Przyznaje dostęp do zarządzania informacjami o forach społeczności związanych z Twoim kontem.

Umożliwia to wyświetlanie informacji na temat Twoich społeczności.

Umożliwia zarządzanie prośbami o dołączenie do społeczności i aktualizacjami ról członków społeczności o niższej randze na Twoim koncie.

Umożliwia wyświetlenie danych właściwości instancji.

Umożliwia modyfikowanie danych właściwości instancji (obecnie obsługuje tylko skrypty).

Umożliwia wyświetlanie informacji o Twoim wyposażeniu.

Przyznaje dostęp do zarządzania zasobami użytkownika.

Przyznaje dostęp do zarządzania Twoimi odznakami.

Przyznaje dostęp do zarządzania Twoimi odznakami i wydawaniem Robuxów.

Przyznaje dostęp do aktualizowania odznak autoryzowanego użytkownika.

Przyznaje dostęp do zarządzania Twoimi produktami deweloperskimi.

Przyznaje dostęp do odczytywania informacji o projektach, dla których masz włączone powiadomienia.

Przyznaje dostęp do włączania i wyłączania powiadomień o projektach w Twoim imieniu.

Przyznaje dostęp do zarządzania Twoimi przepustkami.

Przyznaje dostęp do zarządzania Twoimi społecznościami.

Przyznaje uprawnienie do odczytywania informacji dotyczących społeczności.

Przyznaje uprawnienia do zarządzania społecznościami.

Przyznaje dostęp do odczytywania i zapisywania Twoich tabel dotyczących lokalizacji

Przyznaje dostęp do zarządzania współpracą zespołową w odniesieniu do wszystkich projektów, które posiadasz.

Przyznaje dostęp do zarządzania Twoimi projektami i niektórymi informacjami związanymi z Twoimi projektami (np. informacjami dotyczącymi lokalizacji).

Przyznaje dostęp do odczytywania informacji dotyczących lokalizacji Twoich projektów.

Przyznaje dostęp do modyfikowania preferencji dotyczących lokalizacji Twoich projektów.

Przyznaje dostęp do zarządzania Twoim kontem użytkownika.

Przyznaje dostęp do modyfikowania preferencji dotyczących lokalizacji użytkowników.

Umożliwia przeglądanie statusu, dzienników i wyników zadań wykonawczych Luau dla skojarzonego miejsca.

Umożliwia tworzenie nowych zadań wykonawczych Luau dla skojarzonego miejsca.

Umożliwia asynchroniczne czyszczenie wszystkich struktur danych w uniwersum.

Przyznaje dostęp do tworzenia nowych elementów kolejki.

Przyznaje dostęp do odrzucania odczytanych elementów z początku kolejki.

Przyznaje dostęp do odczytywania elementów znajdujących się na początku kolejki.

Przyznaje dostęp do odczytywania elementów Twojego magazynu pamięci.

Przyznaje dostęp do odczytywania elementów mapy.

Przyznaje dostęp do tworzenia, aktualizowania i usuwania elementów mapy.

Umożliwia to publikowanie wiadomości w imieniu użytkowników.

Umożliwia wysyłanie powiadomień z projektu do użytkowników.

(Przestarzałe) Przyznaje dostęp do odczytu listy wpisów w uporządkowanym magazynie danych.

(Przestarzałe) Przyznaje dostęp do tworzenia nowego wpisu w uporządkowanym magazynie danych.

Przyznaje dostęp do wyświetlania listy wpisów z uporządkowanego magazynu danych.

Przyznaje dostęp do tworzenia wpisów w uporządkowanym magazynie danych.

Umożliwia to wyświetlenie listy obiektów tajnych związanych z projektem.

Umożliwia to tworzenie i aktualizowanie obiektów tajnych związanych z projektem.

To uprawnienie umożliwia przesyłanie zadania oceny i wyświetlanie jego wyniku.

Przyznaje dostęp do odczytywania informacji o Twoich produktach objętych subskrypcją.

Umożliwia to odczytywanie informacji miniatur w Twoim imieniu.

Umożliwia odczytywanie alertów statystycznych.

Umożliwia tworzenie lub modyfikowanie alertów statystycznych.

Umożliwia odczytywanie statystyk dotyczących gry.

Umożliwia zapisywanie zasobów związanych ze statystykami dotyczącymi gry.

Umożliwia odczytywanie informacji dotyczących miejsca.

Umożliwia edytowanie informacji dotyczących miejsca.

Przyznaje dostęp do publikowania nowych wersji projektów na platformie Roblox.

Umożliwia to odczytywanie miniatur i ustawień personalizacji miniatur dla Twoich projektów.

Umożliwia to przesyłanie i usuwanie miniatur oraz zarządzanie ustawieniami personalizacji miniatur dla Twoich projektów.

Umożliwia odczytywanie informacji dotyczących projektu.

Przyznaje dostęp do edytowania projektów autoryzowanego użytkownika.

Umożliwia wyświetlenie ograniczeń dotyczących użytkowników w projekcie.

Umożliwia edytowanie ograniczeń dotyczących użytkowników w projekcie.

Umożliwia to wyświetlanie powiadomień wysyłanych na Twoje konto.

Umożliwia odczytywanie statusu poziomu premium i weryfikacji autoryzowanego użytkownika.

Umożliwia wyświetlanie kont społecznościowych autoryzowanego użytkownika.

Umożliwia odczytywanie wydarzeń w grze.

Umożliwia to korzystanie z funkcji jednokrotnego logowania.

Przyznaje to dostęp do odczytywania informacji dotyczących Twojego profilu.

Podsumowanie