Bir `Logger`, hiyerarşik bir adla etiketlenmiş yapılandırılmış günlük girişleri yayar, bu da ilgili mesajları alt sistem veya özelliklere göre gruplamanıza olanak tanır. `Class.LogService:GetLogger()` ile üst düzey bir günlükleyici elde edin, ardından `Class.Logger:GetLogger()` ile iç içe çocuk günlükleyiciler oluşturun. Her günlükleyicinin kısa bir `Class.Logger.Name` ve kökeninden oluşturulan nokta ile birleştirilmiş bir `Class.Logger.FullPath`'ı vardır (örneğin, `Combat` adlı bir günlükleyiciden oluşturulan `Damage` adlı bir günlükleyicinin tam yolu `Combat.Damage`'dir).

```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("{amount} hasar {target} hedefe verildi", {amount = 25, target = "Goblin"})
```
Günlükleyiciler, `Class.LogService` üzerindeki yapılandırılmış günlükleme yöntemleriyle aynı şekilde davranır: mesajlar **Çıktı** penceresine, Geliştirici Konsoluna ve `Class.LogService.MessageOut`'a akar ve `Class.LogService:GetLogHistory()` içinde günlükleyicinin tam yolu ile etiketlenir.

#### Hiyerarşi ve Yayılma

Bir günlükleyicide bir mesaj kaydedildiğinde, `Class.Logger.MessageOut` olayı o günlükleyicide **ve** köke kadar her ata üzerinde tetiklenir. Bu, bir üst günlükleyiciye bir dinleyici eklemenizi ve onun altındaki tüm mesajları gözlemlemenizi sağlar. Mesaj, motorun çıktı sistemine tam olarak bir kez, kaynağı olan günlükleyicinin tam yolu ile etiketlenerek yayılır.

#### Şablon Söz Dizimi ve Bağlam

Günlükleme yöntemleri, `Class.LogService` üzerindeki yapılandırılmış günlükleme yöntemleriyle aynı `{key}` şablon yer tutucularını ve `context` tablolarını kabul eder. Şablon söz dizimi ve bağlam değerlerinin nasıl saklandığı hakkında daha fazla bilgi için `Class.LogService`'ye bakın.

#### Ömür

Bir günlükleyici, ona bir referans tuttuğunuz sürece geçerlidir. Bir günlükleyiciye (ve onun altındaki günlükleyicilere) olan tüm referanslar serbest bırakıldığında, geri alınır ve eski bir günlükleyici üzerinde herhangi bir yöntem çağrısı bir hata oluşturur. Canlı günlükleyici sayısı ve bir günlükleyicinin tam yolunun uzunluğu her ikisi de sınırlıdır; bu sınırları aşmak, `Class.Logger:GetLogger()`'dan bir hata oluşturur.

#### Uyarı

Bu sınıf beklenmedik veya güvenilmez davranışlar sergileyebilir ve içerik kesilebilir. Günlükleyiciler tarafından yayılan olayların ve mesajların içeriğine önemli oyun mantığı için güvenmeyin.

Bu günlükleyici veya hiyerarşideki altındaki herhangi bir günlükleyici aracılığıyla bir mesaj kaydedildiğinde tetiklenir. Kaydedilen bir mesaj, kaynağı olan günlükleyicide ve her bir atasında `MessageOut`'ı tetiklediğinden, bir üst günlükleyiciye eklenen bir dinleyici, altındaki her mesajı gözlemler. `message` parametresi, tamamen işlenmiş metni (şablon yer tutucuları zaten değiştirilmiş) içerir ve `context` parametresi, mesaj bir bağlam tablosu ile kaydedildiğinde yapılandırılmış anahtar-değer çiftlerini taşır; aksi takdirde nil'dir.

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

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

-- Bir alt günlükleyicide kaydedilen bir mesaj, üst günlükleyicinin MessageOut'unu da tetikler.
combat:GetLogger("Damage"):Info("{amount} hasar vurdu", {amount = 10})
-- Yazdırır: [Combat] 10 hasar vurdu
```


Logger.MessageOut

message

Herhangi bir şablon yer tutucu değişimi sonrasında tamamen işlenmiş mesaj dizesi.

messageType

Mesajın ciddiyet seviyesini belirten bir `Enum.MessageType` değeri.

context

Mesaj kaydedildiğinde sağlanan anahtar-değer çiftleri sözlüğü veya bağlam sağlanmadıysa nil.

Bu günlükleyici veya altındaki herhangi bir günlükleyici aracılığıyla bir mesaj kaydedildiğinde tetiklenir.

Verilen `name` ile çocuk günlükleyiciyi döndürür, eğer zaten mevcut değilse oluşturur. Aynı ad ile tekrar tekrar çağrıldığında, bir referans tutulduğu sürece aynı günlükleyici örneğini döndürür. Döndürülen günlükleyicinin `Class.Logger.FullPath`'ı, bu günlükleyicinin tam yolu ve ardından `.` ile `name`'dir.

Bu yöntem, ad boşsa, `.` içeriyorsa veya kontrol karakterleri içeriyorsa, sonuçta oluşan tam yol çok uzunsa veya canlı günlükleyici sayısının maksimumu aşılmışsa bir hata oluşturur.

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

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

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


Logger:GetLogger

name

Çocuk günlükleyicinin adı. Boş olmamalı, `.` karakteri içermemeli ve kontrol karakterleri içermemelidir.

Bu günlükleyicinin tam yolu ve ardından `.name` ile olan çocuk `Class.Logger`.

Verilen ad ile bir çocuk günlükleyici döndürür, eğer zaten mevcut değilse oluşturur.

`Enum.MessageType.MessageOutput` seviyesinde, bu günlükleyicinin `Class.Logger.FullPath` ile etiketlenmiş bir mesaj kaydeder. Bir `context` tablosu sağlandığında, mesajdaki `{key}` gibi şablon yer tutucuları, karşılık gelen bağlam değerleri ile değiştirilir ve bağlam, Geliştirici Konsolu ve Stüdyo'nun **Çıktı** penceresinde görüntülemek için yapılandırılmış veri olarak korunur.

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

logger:Output("Oyuncu {name} dükkanı açtı", {name = "Alice"})
-- Çıktı: "Oyuncu Alice dükkanı açtı"
```


Logger:Output

Mesaj dizesi. Bir bağlam tablosu sağlandığında `{key}` şablon yer tutucularını destekler.

İsteğe bağlı anahtar-değer çiftleri sözlüğü. Sağlandığında, mesajdaki `{key}` yer tutucuları karşılık gelen değerlerle değiştirilir.

`Enum.MessageType.MessageOutput` seviyesinde isteğe bağlı yapılandırılmış bağlam ile bir mesaj kaydeder.

`Enum.MessageType.MessageInfo` seviyesinde, bu günlükleyicinin `Class.Logger.FullPath` ile etiketlenmiş bir mesaj kaydeder. Bir `context` tablosu sağlandığında, mesajdaki `{key}` gibi şablon yer tutucuları, karşılık gelen bağlam değerleri ile değiştirilir.

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

logger:Info("{amount} hasar verildi", {amount = 42})
-- Çıktı: "42 hasar verildi"
```


Logger:Info

`Enum.MessageType.MessageInfo` seviyesinde isteğe bağlı yapılandırılmış bağlam ile bir mesaj kaydeder.

`Enum.MessageType.MessageWarning` seviyesinde, bu günlükleyicinin `Class.Logger.FullPath` ile etiketlenmiş bir mesaj kaydeder. Bir `context` tablosu sağlandığında, mesajdaki `{key}` gibi şablon yer tutucuları, karşılık gelen bağlam değerleri ile değiştirilir.

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

logger:Warn("Sağlık düşük: {hp}", {hp = 5})
-- Çıktı: "Sağlık düşük: 5"
```


Logger:Warn

`Enum.MessageType.MessageWarning` seviyesinde isteğe bağlı yapılandırılmış bağlam ile bir mesaj kaydeder.

`Enum.MessageType.MessageError` seviyesinde, bu günlükleyicinin `Class.Logger.FullPath` ile etiketlenmiş bir mesaj kaydeder. `Class.LogService:Error()`'dan farklı olarak, bu yöntem bir hata seviyesinde günlük girişi yayar ve normal olarak döner; **atmaz**. Bir `context` tablosu sağlandığında, mesajdaki `{key}` gibi şablon yer tutucuları, karşılık gelen bağlam değerleri ile değiştirilir.

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

logger:Error("İstek başarısız oldu: {reason}", {reason = "timeout"})
-- Hata seviyesinde bir günlük yayar; yürütme devam eder.
```


Logger:Error

`Enum.MessageType.MessageError` seviyesinde isteğe bağlı yapılandırılmış bağlam ile bir mesaj kaydeder.

Belirtilen `Enum.MessageType` seviyesinde, bu günlükleyicinin `Class.Logger.FullPath` ile etiketlenmiş bir mesaj kaydeder. Bu, `Class.Logger:Output()|Output()`, `Class.Logger:Info()|Info()`, `Class.Logger:Warn()|Warn()`, ve `Class.Logger:Error()|Error()`'ı tek bir çağrıda açık bir mesaj türü parametresi ile birleştiren genel amaçlı bir yöntemdir. `Class.LogService:Log()`'dan farklı olarak, `Enum.MessageType.MessageError` geçişi bir hata seviyesinde günlük yayar ve atmak yerine normal olarak döner.

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

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


Logger:Log

Günlük seviyesini belirten `Enum.MessageType`.

Belirtilen seviyede isteğe bağlı yapılandırılmış bağlam ile bir mesaj kaydeder.

Logger

`Class.LogService:GetLogger()` veya `Class.Logger:GetLogger()` ile sağlanan bu günlükleyicinin adıdır. Bu, tek bir yol segmentidir ve asla `.` karakteri içermez. Tam nokta ile birleştirilmiş yol için `Class.Logger.FullPath`'ı kullanın.

Logger.Name

Bu günlükleyicinin üstündeki ad segmenti.

Bu günlükleyicinin tam yolu, kökten bu günlükleyiciye kadar her günlükleyicinin `Class.Logger.Name`'inin `.` ayırıcıları ile birleştirilmesiyle oluşur. Üst düzey bir günlükleyici için tam yol, adının kendisine eşittir. Bu günlükleyici üzerinden kaydedilen mesajlar, `Class.LogService:GetLogHistory()` içinde bu tam yol ile etiketlenir.

Logger.FullPath

Bu günlükleyicinin kök günlükleyiciden itibaren nokta ile birleştirilmiş yolu.

Hiyerarşik bir yola göre kapsamlı yapılandırılmış günlük girişleri yayan adlandırılmış bir günlükleyici.

`Object`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır.
Roblox Motoru tarafından tanımlanan diğer tüm sınıflar, `Object`'ın tüm üyelerini miras alır.
Doğrudan bir `Object` oluşturmak mümkün değildir.


Bu örnek, normal nesneler ve `Value` nesneleri üzerindeki `Changed` olayının inceliklerini gösterir.


Bu kod örneği, bir üst nesne içinde Değişti olayı tetiklenmesini göstermektedir.


Bu olay, bir nesne özelliği değiştikten hemen sonra tetiklenir, bazı istisnalarla birlikte (aşağıya bakın). Değişen bir özelliğin yeni değeri,
**parametre** olarak geçmez. Bunun yerine, `object[property]` kullanarak erişebilirsiniz:

```
object.Changed:Connect(function(property)
	print("Yeni özelliğin değeri", object[property])
end)
```

- Sadece belirli bir özelliğin değişikliklerini dinlemekle ilgileniyorsanız,
  bunun yerine `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`
  yöntemini kullanmayı düşünün.
- Özelliklerdeki değişiklikleri dinlemek için, `Class.Instance:GetAttributeChangedSignal()` ve
  `Class.Instance.AttributeChanged`'e bakın.
- Çocukların eklendiği veya kaldırıldığı durumları tespit etmek için,
  `Class.Instance.ChildAdded` ve `Class.Instance.ChildRemoved`'a bakın.

`Class.ValueBase` nesneleri, `Class.IntValue` ve `Class.StringValue` gibi, bu olay yalnızca nesnenin `Value`
özelliği değiştiğinde tetiklenir. `Class.ValueBase` nesnelerindeki diğer değişiklikleri tespit etmek için,
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` kullanın.

#### Sınırlamalar

Bu olay, fizik ile ilgili değişiklikler için **tetiklenmez**, örneğin `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position` veya
`Class.BasePart.Orientation|Orientation` özellikleri yer çekimi nedeniyle değiştiğinde.
Bu özelliklerdeki değişiklikleri tespit etmek için, `Class.RunService.PreSimulation` gibi fizik tabanlı bir olayı kullanmayı düşünün.
Benzer şekilde, `Changed` olayı, `Class.BasePart.AssemblyMass|AssemblyMass` güncellemeleri, bir malzeme, boyut veya yoğunluk değişikliği nedeniyle kaynaklanan bir değişiklikte tetiklenmez (ancak bir parçanın boyutunu değiştirdiğinizde `Class.BasePart.Mass|Mass` için olay tetiklenir).

Sık değişen özellikler için, `Changed` olayı her bir değişim için tetiklenmeyebilir veya hiç tetiklenmeyebilir. **Eğer bir özellik değişikliği oyun mantığınızı etkiliyorsa, dikkatlice test edin**
eğer olayın beklediğiniz gibi tetiklendiğinden emin olun.


Object.Changed

property

Bir nesnenin özelliği değiştiğinde hemen tetiklenir, bazı sınırlamalarla birlikte.


Bu kod örneği, bir değişiklik olayı tetiklenmeden önce bir değeri nasıl kaydedeceğinizi gösterir
ve bir değişiklik hakkında daha fazla bilgi edinmek için kullanılır.


Bu kod örneği, `Changed` olayının ve `GetPropertyChangedSignal` tarafından döndürülen olayın eşdeğerliğini göstermektedir.


Bu yöntem, verilen özelliğin değiştiğinde tetiklenen bir olayı döndürür.
`Class.Object.Changed|Changed` olayıyla aynı şekilde davranır, ancak yalnızca verilen özellik değiştiğinde tetiklenir.
Genellikle, bu yöntemi, özellik adını kontrol eden bir fonksiyonla `Class.Object.Changed|Changed` bağlantısı yerine kullanmak iyi bir fikirdir.
Aynı nesne üzerinde aynı özellik adıyla bu yönteme yapılan sonraki çağrılar aynı olayı döndürür.

`Class.ValueBase` nesneleri, `Class.IntValue` ve `Class.StringValue` gibi, `Value` özelliklerinin içeriğiyle tetiklenen değiştirilmiş bir `Class.Object.Changed|Changed` olayı kullanır.
Bu nedenle, bu yöntem, bu nesnelerin diğer özelliklerindeki değişiklikleri tespit etmenin bir yolunu sağlar.

Bu olay, bağlı bir fonksiyona herhangi bir argüman geçmeyecektir,
dolayısıyla değişen özelliğin değeri bir betik içinde doğrudan okunmalıdır.

#### Sınırlamalar

Bu yöntemle döndürülen olay, fizik ile ilgili değişiklikler için **tetiklenmez**, örneğin `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position` veya
`Class.BasePart.Orientation|Orientation` özellikleri yer çekimi nedeniyle değiştiğinde.
Bu özelliklerdeki değişiklikleri tespit etmek için, `Class.RunService.PreSimulation` gibi fizik tabanlı bir olayı kullanmayı düşünün.

Ayrıca, döndürülen olay, çok sık değişen özelliklerin her bir değişiminde tetiklenmeyebilir ve/veya bu tür özellikler için hiç tetiklenmeyebilir.
Oyun mantığını etkileyen özellik değişikliklerini dikkatlice test etmeniz önerilir.


Object:GetPropertyChangedSignal

Özellik değiştiğinde tetiklenen bir sinyal.


Bir nesnenin belirli bir özelliği değiştiğinde tetiklenen bir olayı alın.


Workspace sınıfını `Class.Instance:IsA()` kullanarak belirlemenin nasıl yapılacağını gösterir.

Workspace 'Workspace' sınıfındadır, bu nedenle ilk ifade doğrudur. Workspace
'BasePart' sınıfında değildir, bu nedenle ikinci ifade yanlıştır. Workspace
Instance'dan türetilmiştir ve bu nedenle 'Instance' sınıfındadır, bu nedenle üçüncü
ifade doğrudur.


IsA, nesnenin sınıfı **eşdeğer** veya verilen sınıfın **alt sınıfı** ise true döner.
Bu fonksiyon, diğer dillerdeki **instanceof** operatörlerine benzer ve bir tür [tip içgörü](https://en.wikipedia.org/wiki/Type_introspection) biçimidir.
Sınıf mirasını göz ardı etmek için, `Class.Object.ClassName|ClassName` özelliğini doğrudan test edin.
Yerel Luau veri türlerini (sayı, dize vb.) kontrol etmek için `type` ve `typeof` fonksiyonlarını kullanın.

En yaygın olarak, bu fonksiyon, bir nesnenin `Class.Part` veya `Class.WedgePart` gibi bir tür parça olup olmadığını test etmek için kullanılır,
`Class.BasePart`'dan (soyut bir sınıf) miras alır. Örneğin, bir karakterin tüm uzuvlarını aynı renge değiştirmek istiyorsanız,
`Class.Instance:GetChildren()|GetChildren` kullanarak çocukları döngüye alabilir,
sonra `Datatype.BrickColor` özelliğine sahip olmayan `Class.BasePart` nesnelerini filtrelemek için IsA kullanabilirsiniz:

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

local function paintFigure(character, color)
	-- Karakterin çocuk nesneleri üzerinde döngü
	for _, child in character:GetChildren() do
		-- Shirt, Pants ve Humanoid gibi parça olmayan nesneleri filtrele
		-- R15 MeshPart kullanır ve R6 Part kullanır, bu nedenle her ikisini de tespit etmek için BasePart kullanıyoruz:
		if child:IsA("BasePart") then
			child.BrickColor = color
		end
	end
end
paintFigure(Players.Player.Character, BrickColor.new("Bright blue"))
```
Tüm sınıflar `Class.Object`'dan miras aldığından,
`object:IsA("Object")` çağrısı her zaman true dönecektir.


Object:IsA

className

Nesnenin sınıfının kontrol edileceği sınıf.
Büyük/küçük harf duyarlıdır.


Nesnenin sınıfının verilen sınıfla eşleşip eşleşmediğini veya onun alt sınıfı olup olmadığını açıklar.


Bir nesnenin sınıfı, verilen sınıfla eşleşiyorsa veya ondan miras alıyorsa true döner.


Object:isA

Object

`Class.Object`'ın ait olduğu sınıfı temsil eden salt okunur bir dize.

Bu özellik, `Class.Object:IsA()` veya `Class.Instance:FindFirstChildOfClass()` gibi
nesneleri türüne göre tanımlamak için kullanılan çeşitli diğer fonksiyonlarla birlikte kullanılabilir.

Bu özelliğin salt okunur olduğunu ve betikler tarafından değiştirilemeyeceğini unutmayın.
Bir nesnenin sınıfını değiştirmek isteyen geliştiriciler, bunun yerine yeni bir `Class.Object` oluşturmak zorundadır.

`Class.Object:IsA()`'dan farklı olarak, ClassName, bir nesnenin belirli bir sınıfa ait olup olmadığını kontrol etmek için kullanılabilir,
sınıf mirasını göz ardı ederek. Örneğin:


Object.ClassName

`Class.Object`'ın ait olduğu sınıfı temsil eden salt okunur bir dize.


Object.className

`Object`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır.


Luau

Dictionary

Class

Enum

Enum.MessageType

Belirli bir olay meydana geldiğinde bağlı işlevleri çalıştıran bir nesne.

Data Type

RBXScriptSignal

Ya da tipi true veya false değerine sahip.

boolean

Harfler, sayılar ve semboller gibi karakterlerin bir dizisi.

string

Deneyimler

Avatar

Varlıklar

Samples and projects

Engine API

Open Cloud API

Studio

Analizler

Platform

Öğreticiler

Yaratıcı programları

Eğitim

Learn

Eş zamansız olan bu yöntem, işlemin geçerli durumunu temsil eden bir `Operation` döndürür Gerçek yanıtı ve uygulanabilir üst verileri elde etmek için yoklayabileceğin bir uç nokta yolu içerir. Daha fazla bilgi için uzun süreli işlemlerle ilgili [dokümantasyonu]({longRunningOperationsLink}) incele.

Aşağıdaki kısımlar, bir işlem tamamlandığında sağlanan yanıt ve üst veri nesnelerini tanımlar.

Beta uç noktaları herkesin kullanımına açıldı. Kesme değişiklikleri mümkün olsa da nadir görülür.

These Open Cloud documentation pages will be removed on March 31, 2026. You will be automatically redirected to the new Open Cloud documentation at that time. {linkStart}Learn more{linkEnd}

These old Open Cloud pages will be removed and redirected on March 31, 2026. {linkStart}Learn more{linkEnd}

Deneysel uç noktalar herkese açık şekilde kullanıma hazırdır ancak API sözleşmesi tamamlandıkça zaman zaman önemli değişikliklerden geçebilir.

This endpoint can be called in-experience through {httpServiceLinkStart}HttpService{httpServiceLinkEnd} with an API key.

Bu alan, kaynak oluşturulurken ayarlanabilir ama sonraki taleplerde düzenlenemez.

Bu alanlar, kaynak oluşturulurken ayarlanabilir ama sonraki taleplerde düzenlenemez.

Bu alan, taleplerde sağlanabilir ancak yanıtlara asla dâhil edilmez.

Eski kimlik doğrulama yöntemi. API Anahtarı veya OAuth 2.0 kullanılabilir durumdaysa bunları kullanmayı tercih et.

API Anahtarı başına: Her {periodInSeconds} saniyede IP adresi başına {maxInPeriod} talep

Çağrı için kimlik doğrulama gerektirmez. Genellikle önemli ölçüde düşük oran limitlerine sahiptir. API Anahtarı veya OAuth 2.0 kullanılabilir durumdaysa her zaman bunları kullanmayı tercih et.

Her gruplama için şemada aşağıdaki alanlardan yalnızca birinin sağlanması gerekir, geri kalanlar hariç tutulabilir.

You can opt back in at any time. {linkStart}Provide feedback.{linkEnd}

You are viewing the old docs. {linkStart}Provide feedback.{linkEnd}

You can opt out at any time and be redirected back to the old reference pages. {linkStart}Provide feedback.{linkEnd}

You are viewing the revamped docs. {linkStart}Provide feedback.{linkEnd}

Bu alan, yanıtlar için ayarlanabilir ancak isteklerde göz ardı edilir.

Not: Yoğun trafikli dönemlerde oran sınırları daha düşük olabilir. Bazı uç noktaların ek oran sınırları vardır. [Oran sınırları hakkında daha fazla bilgi edin]({link}).

Tüm API anahtarlarında bir kullanıcı veya grup için günde {limit} talep

Tüm API anahtarlarında bir kullanıcı veya grup için saatte {limit} talep

Tüm API anahtarlarında bir kullanıcı veya grup için dakikada {limit} talep

Tüm API anahtarlarında bir kullanıcı veya grup için saniyede {limit} talep

API anahtarı sahibi başına dakikada {limit} talep

Uygulama kullanıcısı başına günde {limit} talep

Uygulama kullanıcısı başına saatte {limit} talep

Uygulama kullanıcısı başına dakikada {limit} talep

Uygulama kullanıcısı başına saniyede {limit} talep

API anahtarı sahibi başına saniyede {limit} talep

Kapsamlar, kimlik bilgilerinin sahip olduğu izinleri kontrol eder. Kimlik bilgilerin yalnızca seçtiğin kapsamlar tarafından desteklenen uç noktalara erişebilir.

Kararlı uç noktalar üretime hazırdır ve kullanım ömürleri boyunca neredeyse hiçbir zaman önemli değişikliklerden geçmez.

Bu hedef, anahtarının seçilen {requiredParts} parçalarına erişimini sınırlamanı sağlar

Bu hedef, anahtarının seçilen {requiredParts} ve {optionalParts} parçalarına erişimini sınırlamanı sağlar

Hedef türleri, kimlik bilgilerinin izne sahip olduğu kaynakları kısıtlamak için kullanılır. Hesabının ek kaynaklar üzerinde izinleri olsa bile yalnızca seçilen kaynaklar üzerinde işlem yapılabilir. Bazı kapsamların hedef bölümleri yoktur. Böyle durumlarda, ilgili tüm kaynaklar üzerinde işlem yapılabilir.

Kullanıcıya ait API Anahtarları için evren Üst Seviye Bölümünün seçilmesine gerek yoktur. Bu durumda API Anahtarının, kullanıcıya ait tüm deneyimlerine ve uygun grup izinlerine sahip olduğun grup deneyimlerine erişimi olacaktır.

Dene, API anahtarı veya OAuth 2.0 kimlik doğrulaması gerektiren uç noktalar için henüz desteklenmiyor

Güvenlik için yüksek riskli işlemlerde çerez kimlik doğrulaması devre dışı bırakılmıştır.

Kritik risk uç noktaları son derece hassastır ve güvenlik için Dene düğmesi devre dışı bırakılmıştır

Not: Kimlik doğrulama başlıkları bu kod örneğine dâhil edilmemiştir. Bu komutun çalışması için bir kimlik doğrulama başlığı eklemen gerekebilir.

Bu, kritik verileri değiştirebilecek veya silebilecek yüksek riskli bir uç noktadır. Test ederken çok dikkatli ol.

Bu API uç noktası YÜKSEK RİSKLİ olarak sınıflandırılmıştır ve canlı verileri veya kullanıcı hesaplarını etkileyebilir.

Yüksek riskli API'lere yönelik kimliği doğrulanmış talepler, geri alınamayan değişikliklere neden olabilir. Devam etmeden önce lütfen talep parametrelerini dikkatlice incele.

Çerez kimlik doğrulamasını kullanmak için lütfen giriş yap

Bu, verileri alan düşük riskli bir uç noktadır. Test edilmesi genellikle güvenlidir.

Bu, verileri değiştiren orta riskli bir uç noktadır. Değişiklikler kalıcı olabileceğinden, kritik olmayan hesaplarla dikkatlice test et.

Hesabını güvende tutmak istiyorsan buraya asla başka kaynaklardan metin yapıştırma veya bu sayfadan başkalarına bilgi gönderme.

Gerçek hesap kimlik bilgilerini kullanarak canlı API uç noktalarını test etmek üzeresin.

Yalnızca yapmak üzere olduğun API çağrılarının sonuçlarını anlıyorsan devam et. Test etmeden önce API belgelerini dikkatlice incele.

API çağrıları, kimliği doğrulanmış oturumun kullanılarak yapılacaktır

Bunlar, hesabını veya verilerini etkileyebilecek gerçek API çağrılarıdır

İstek sınırları ve diğer API kısıtlamaları geçerlidir

Bazı işlemler verileri değiştirebilir veya silebilir

This endpoint has been superseded by these recommended alternative endpoints:

Bu uç noktayı çağırmak için aşağıdaki kapsamlar gereklidir. Uygun anahtarları
oluşturma hakkında daha fazla bilgi [API anahtarlarını yönetme]({apiKeyReferenceDocLink}) bölümünden edinilir.

Anahtar oluşturma hakkında daha fazla bilgi [API anahtarlarını yönetme]({apiKeyReferenceDocLink}) bölümünden edinilir.

Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Bu dizi [FieldMask](/cloud/reference/types#fieldmask) olarak biçimlendirilmiş.

JSON değeri `null`, `boolean`, `string`, `number`, `array` ya da `object` olabilir.

Bu uç noktasının kullanılması adına OAuth 2.0 uygulaman için aşağıdaki kapsamlar gerekir. OAuth 2.0 uygulamanı nasıl kaydettireceğin hakkında daha fazla bilgi için [Uygulama kaydı ve incelemesi]({oauth2ReferenceDocLink}) sayfasını incele.

Bir OAuth 2.0 uygulamasını kaydetme hakkında daha fazla bilgi [Uygulama kaydı ve inceleme]({oauth2ReferenceDocLink}) bölümünden edinilir.

Şu nesneler kabul edilen veya döndürülen yükleri tanımlar. Bu nesnelerin ne zaman kullanıldığı hakkında daha fazla bilgi için tüm uç noktalara bak.

Bu uç noktayı çağırmak için aşağıdaki kapsamlar gereklidir.

Resource Paths

Bu dizi [Timestamp](/cloud/reference/types#timestamp) olarak biçimlendirilmiş.

Bu uç noktasının kullanılması adına OAuth 2.0 uygulaman için aşağıdaki kapsamlar gerekir. OAuth 2.0 uygulamanı nasıl kaydettireceğin hakkında daha fazla bilgi için [Uygulama Kaydı ve İncelemesi]({oauth2ReferenceDocLink}) sayfasını incele.

Not Recommended

You are viewing the revamped Open Cloud reference.

You've opted out of the new Open Cloud reference.

Grants access to configure billing accounts and purchase ad credit.

View your ad campaigns and their performance.

Create, update, and manage your ad campaigns.

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

This allows viewing asset permissions for subjects (including groups and experiences) and assets your account has access to.

This allows granting asset permissions to any subjects (including groups and experiences) and assets your account has access to.

This allows you to view the status and results of avatar auto-setup jobs on your behalf.

This allows you to create and manage avatar auto-setup jobs on your behalf.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows making changes to your synced commerce items.

This allows viewing information about your commerce merchant connections.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to view information about your Creator Store saves.

This allows you to modify information about your Creator Store saves.

Grants access to create data stores on your behalf.

Grants access to delete data stores on your behalf.

Grants access to read a list of data stores.

Grants access to take a snapshot of your data stores.

Grants access to create entries in your data stores.

Grants access to mark specified entries for deletion.

Grants access to list your data store's entries.

Grants access to read specified entries in your data stores.

Grants access to update the value, attributes, and users of an entry.

Grants access to delete revisions of your data store's entries.

Grants access to list revisions for your data store's entries.

Grants access to read revisions of your data store's entries.

Grants access to view configuration details for the authorized user's developer products.

Grants access to edit the authorized user's developer products.

This allows viewing information about your universe's environments.

This allows editing of your universe's environments.

Grants access to view configuration details for the authorized user's game passes.

Grants access to edit the authorized user's game passes.

Grants access to view community forums information for your account.

Grants access to manage community forums information for your account.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

Allows you to view an instance's property data.

Allows you to modify the property data of instances (currently only supports Scripts).

This allows viewing information about your inventory.

Grants access to manage your badges and spend Robux.

Grants access to update the authorized user's badges.

Grants access to manage your developer products.

Grants access to read information about the experiences you have notifications on for.

Grants access to turn on or off notifications for experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

Allows you to view the status, logs, and results of Luau execution tasks for the associated place.

Allows you to create new Luau execution tasks for the associated place.

Grants access to asynchronously flush all data structures in the universe.

Grants access to discard read items from the front of the queue.

Grants access to read items at the front of the queue.

Grants access to read your memory store items.

Grants access to create, update, and delete map items.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

(Deprecated) Grants access to read a list of entries in an ordered data store.

(Deprecated) Grants access to create a new entry in an ordered data store.

Grants access to list entries from an ordered data store.

Grants access to create entries in an ordered data store.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

This permission allows you to submit an evaluation job and view the job result.

Grants access to read about your subscription products.

This allows you to read thumbnail information on your behalf.

Grants the ability to read analytics alerts.

Grants the ability to create or modify analytics alerts.

Grants the ability to read game analytics.

Grants the ability to write resources related to game analytics.

Grants the ability to read place information.

Grants the ability to edit place information.

Grants access to publish new versions of experiences to Roblox.

This allows you to read thumbnails and thumbnail personalization settings for your experiences.

This allows you to upload and delete thumbnails and manage thumbnail personalization settings for your experiences.

Grants the ability to read experience information.

Grants access to edit the authorized user's experiences.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

This allows viewing notifications sent to your account.

Grants the ability to read the authorized user's premium and verified status.

This allows you to view the authorized user's social accounts.

Grants the ability to read a game's events.

This enables Single Sign-On functionality.

This grants access to read your profile information.

Özet