Gestisci la tua presenza nel [Creator Store](/production/creator-store). [Crea](#Cloud_CreateCreatorStoreProduct) e [aggiorna](#Cloud_UpdateCreatorStoreProduct) le inserzioni di prodotto per i tuoi asset, e [cerca nella toolbox](#Toolbox_SearchCreatorStoreAssets) per asset utilizzando vari filtri.


Il tipo di audio (Musica o Effetto Sonoro).

Parametri di filtro di ricerca specifici per l'audio.

Tipi di audio da includere (ad es. Musica, Effetto Sonoro)

La durata massima per l'audio in secondi. Se inclusa, deve essere maggiore o uguale a 1.

La durata minima per l'audio in secondi. Se inclusa, deve essere maggiore o uguale a 0.

Indica quali classifiche musicali filtrare.

Modello di richiesta per eliminare più salvataggi

Modello di risposta per l'operazione di eliminazione di salvataggi bulk

Numero di salvataggi che sono stati eliminati con successo

Modello di richiesta per creare un salvataggio

Le collezioni personalizzate non sono attualmente supportate.
Questo campo dovrebbe essere omesso.

Deprecato: Si prega di fare riferimento alle proprietà 'userId' e 'groupId' invece.
Il tipo e l'ID del creatore. Ad esempio, user/123 o group/456.

L'ID del gruppo. Richiesto se l'asset è di proprietà di un gruppo.

Questo valore esiste solo per i creatori basati su gruppi e rappresenta l'ID Utente del creatore che ha aggiornato l'asset per l'ultima volta.

Questo valore esiste solo per i creatori basati su gruppi e rappresenta il nome del creatore che ha aggiornato l'asset per l'ultima volta.

L'ID Utente del creatore. Richiesto se l'asset è di proprietà di un singolo utente.

Rappresentazione di un asset del negozio creatore.

Rappresenta le capacità di cui un modello dispone (ad es. sandboxing).
Presente solo per i tipi di asset di modello; AMRS lo include nella risposta quando disponibile.

Controlla se il modello sarà inserito in un ambiente sandbox al momento dell'inserimento quando contiene script.

Rappresenta un prodotto nel Creator Store. Questa risorsa è utilizzata per gestire
distribuzione e prezzi degli asset nel Creator Store.

Il prodotto del Creator Store è un file audio con questo ID asset.

Il prodotto del Creator Store è un decal con questo ID asset.

Il prodotto del Creator Store è una famiglia di font con questo ID asset.

Il prodotto del Creator Store è una parte mesh con questo ID asset.

Il prodotto del Creator Store è un modello con questo ID asset.

Il percorso della risorsa del prodotto del negozio creatore.

Formato: `creator-store-products/{creator_store_product_id}`

Il prodotto del Creator Store è un plugin con questo ID asset.

Prezzi di base supportati in USD: $0, $4.99, $5.99, $6.99, $7.99, $8.99,
$9.99, $10.99, $11.99, $12.99, $13.99, $14.99, $15.99, $16.99, $17.99,
$18.99, $19.99, $24.99, $29.99, $34.99, $39.99, $44.99, $49.99, $59.99,
$69.99, $79.99, $89.99, $99.99, $149.99, $199.99, $249.99

Se il venditore intende distribuire il prodotto del Creator Store sul
Creator Store. Un venditore potrebbe intendere distribuire un prodotto, ma a
causa di alcune restrizioni sul venditore o sul prodotto del Creator Store sottostante, il
prodotto potrebbe non essere disponibile per l'acquisto. Vedi
`restrictions` e `purchasable` per ulteriori dettagli.

Se il prodotto è acquistabile.

Affinché questo valore sia vero, `published` deve essere vero e `restrictions` deve
essere vuoto. Se questo valore è falso, il prodotto potrebbe non essere acquisito da nessun
utente.

Restrizioni applicate al prodotto. Un prodotto può avere più
restrizioni attive contemporaneamente.

Valori possibili:

  | Valore | Descrizione |
  | --- | --- |
  | RESTRICTION_UNSPECIFIED | Restrizione non specificata. |
  | SOLD_ITEM_RESTRICTED | L'oggetto in vendita è stato limitato da Roblox. I dettagli potrebbero essere disponibili consultando direttamente quell'oggetto. |
  | SELLER_TEMPORARILY_RESTRICTED | Il prodotto è limitato perché l'account del venditore è temporaneamente limitato da Roblox. |
  | SELLER_PERMANENTLY_RESTRICTED | Il prodotto è limitato perché l'account del venditore è permanentemente limitato da Roblox. |
  | SELLER_NO_LONGER_ACTIVE | Il prodotto è limitato perché l'account del venditore è stato eliminato o non è più attivo. |

Il prodotto del Creator Store è un video con questo ID asset.

Rappresenta un numero decimale in una forma simile alla notazione scientifica.

Esempi:
 - 17            === `{significand: 17   exponent: 0} (o semplicemente {significand:
   17})`
 - -0.005        === `{significand: -5   exponent: -3}`
 - 33.5 milioni  === `{significand: 335  exponent: 5}`
 - 11/8 (1.375)  === `{significand: 1375 exponent: -3}`

Nota che l'intervallo di un Decimale supera quello di un `numero` JSON (double), così
come quello di un `decimal64`.

Rappresenta la posizione del punto decimale all'interno del significand.

Quando l'esponente è 0, il valore del Decimale è semplicemente il valore di
`significand`.

Quando l'esponente è maggiore di 0, rappresenta il numero di zeri trailing
dopo le cifre significative.

Quando l'esponente è inferiore a 0, rappresenta quanti delle cifre significative
(e eventuali zeri iniziali impliciti, se necessario) vengono dopo il punto decimale.

Modello di richiesta per eliminare un salvataggio

Modello di risposta per ottenere salvataggi

Il numero totale di salvataggi che corrispondono alla query.

Un record di salvataggio, idratato con i dettagli dell'asset.

Data in cui il salvataggio è stato aggiunto.

Rappresenta il conteggio di vari tipi di istanze all'interno di un asset.
Vedi [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance).

Capacità di script per l'asset (sandboxing)

Il numero di tipi di istanza nello studio presenti nel modello.
Consulta [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance).
Questi sono suddivisi in tipi specifici, come MeshPart, Part, Script,
Tool, Animation, ecc.

Il riassunto delle mesh all'interno del modello, se esistono.

Il numero di script presenti nel modello.

Un elenco di tipi di istanza modello. Consulta Toolbox.Service.Models.Internal.InstanceCounts e [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) per ulteriori dettagli.

Parametri di filtro di ricerca specifici per il modello.

Se incluso, esclude gli asset con questi sottotipi.

Questo filtra affinché i seguenti tipi di [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) siano inclusi nel modello.

Se incluso, cerca solo asset con questi sottotipi.

Rappresenta un importo di denaro con il suo tipo di valuta.

Esempi:
 - Cinque dollari USA === `{currency_code: "USD" quantity: {significand: 5}}`

Un codice valuta.

Questo può essere un codice valuta di tre lettere definito in ISO 4217.

Le API possono definire codici valuta aggiuntivi che non sono inclusi nella norma ISO
4217 (ad esempio, valute virtuali o criptovalute). Questi
devono iniziare con `X-`, per distinguerli da potenziali futuri
codici ISO 4217. Ad esempio, `"USD"` è il codice ISO 4217 per il dollaro
degli Stati Uniti.

Rappresenta quale classifica musicale recuperare, se presente.

Fornisce un riepilogo delle caratteristiche della mesh di un oggetto, come i conteggi di triangoli e vertici.

Il numero totale di triangoli nella mesh dell'oggetto.

Il numero totale di vertici nella mesh dell'oggetto.

ID di asset di anteprima raggruppati per un elemento, separati per tipo di media.

Elenco ordinato di ID di asset di anteprima immagine.

Elenco ordinato di ID di asset di anteprima video.

Contiene informazioni di correzione della query per una query di ricerca.

La correzione di spelling suggerita per la query di ricerca originale.

Facets che sono già applicate alla ricerca.

Le facets non utilizzate e ancora disponibili.

Rappresenta i valori del tipo audio che saranno visualizzati correttamente nell'interfaccia Swagger.

Questo rappresenta un "sottogruppo" delle opzioni Toolbox.Service.CategoryType e rappresenta l'insieme completo
di "categorie" (o tipi di asset) che possono essere cercati tramite l'API di ricerca del toolbox.

Modello di richiesta per cercare gli asset del Creator Store.

L'ID gruppo del creatore. Solo uno tra 'userId' e 'groupId' può essere presente in una query.

Il file immagine da cercare. L'immagine deve essere codificata in base64 per essere utilizzata nella ricerca. Solo uno tra 'query' e 'image' può essere presente in una query.

Se i risultati devono includere solo asset creati da creatori verificati.

Il numero di asset da restituire. Non può essere superiore a 100.

Il prezzo massimo dell'asset in centesimi. Se incluso, deve essere maggiore o uguale a 0.

Il prezzo minimo dell'asset in centesimi. Se incluso, deve essere maggiore o uguale a 0.

Filtri di ricerca specifici per il modello.

Il numero di pagina da recuperare, a partire da 0. Solo uno tra 'pageNumber' e 'pageToken' può essere presente in una query.

L'identificatore per la pagina di risultati desiderata. Solo uno tra 'pageNumber' e 'pageToken' può essere presente in una query.

I termini di ricerca utilizzati per filtrare i risultati. Solo uno tra 'query' e 'image' può essere presente in una query.

Il tipo di asset da cercare. Facoltativo quando Toolbox.Service.SearchCreatorStoreAssetsRequest.CategoryPath
si risolve in un tipo di asset; altrimenti richiesto.

Indica quali campi saranno popolati nella risposta.

La categoria per ordinare i risultati della ricerca.

La direzione di ordinamento dei risultati della ricerca.

Identificatore di swimlane opzionale (ad es. "in vetta", "essenziale", "prezzato").

L'ID utente del creatore. Solo uno tra 'userId' e 'groupId' può essere presente in una query.

La risposta per l'endpoint SearchCreatorStoreAssets.

La lista di asset del creator store restituita dalla query di ricerca.

La parola chiave filtrata utilizzata per cercare asset, se applicabile.

Il token di pagina per visualizzare la pagina successiva di risultati.

Informazioni sulla correzione della query, se era disponibile una correzione per la query di ricerca.

Le faccette applicate e disponibili di una query.

Il numero totale di risultati per la data query di ricerca.

Questa visualizzazione controlla quali campi sono popolati nella risposta di ricerca. Una visualizzazione più leggera
risulterà in tempi di risposta più rapidi e maggiore affidabilità.

Rappresenta la direzione in cui ordinare i risultati.

Rappresentazione di un asset effetto sonoro.

Percorso della categoria dell'asset, se esiste.
e.g. "3d__characters"

ID dell'universo se l'asset è stato creato all'interno di un universo specifico.

Gli ID degli asset di anteprima raggruppati per tipo di asset.

Il tempo in cui l'asset è stato aggiornato l'ultima volta.

Le informazioni sul prodotto del negozio del creatore dell'asset.

Se l'asset può essere acquistato o meno nel Creator Store.

Il prezzo dell'asset, incluso il codice della valuta.

La percentuale del totale dei voti che sono stati Voti Positivi.

Una chiave configurabile che consente accesso granulare alle risorse Roblox. Vedi https://create.roblox.com/docs/cloud/auth/api-keys per ulteriori informazioni.

x-api-key

Un cookie del browser che rappresenta l'identità di un utente Roblox. NON CONDIVIDERE QUESTO. La condivisione di questo permetterà a qualcun altro di accedere come te e di rubare i tuoi Robux e oggetti. Non raccomandiamo di utilizzare i cookie per chiamare gli endpoint. Quando possibile, utilizza chiavi API con l'intestazione x-api-key o OAuth 2.0 invece per l'autenticazione.

.ROBLOSECURITY

Costruisci o autorizza app per accedere alle risorse Roblox. Vedi https://create.roblox.com/docs/cloud/auth/oauth2-overview per ulteriori informazioni.

L'API di Roblox. Vedi https://create.roblox.com/docs/cloud/open-cloud per ulteriori dettagli.

Roblox API

Aggiungi un prodotto Creator Store. Usa questo metodo solo se il tuo prodotto non è mai
stato distribuito nel Creator Store; altrimenti, utilizza il metodo `PATCH` per
aggiornare il prodotto.

CreatorStoreProduct

creator-store-product:write

creator_store_product_id

creator-store-product:read

updateMask

Se impostato su true, e il prodotto creator store non è trovato, un prodotto creator store
verrà creato. In questa situazione, `update_mask` verrà ignorato.

allowMissing

targetType

targetId

Le collezioni personalizzate non sono attualmente supportate. Questo campo deve essere omesso.

collectionName

creator-store-save:write

L'ID dell'asset su cui filtrare. Se fornito, targetType deve essere fornito anche.

sortBy

La direzione da utilizzare per l'ordinamento

sortDirection

Il numero massimo di salvataggi da restituire

limit

Il numero di pagina da restituire, a partire da 1

page

keyword

hideOwnedAssets

creator-store-save:read

Elimina in blocco i salvataggi.
Massimo di 5000 salvataggi per richiesta.

Ottieni dettagli per un singolo asset del Creator Store.

L'ID dell'asset di cui recuperare i dettagli.

Ottieni i dettagli dell'asset del Creator Store

Il tipo di asset da cercare. Facoltativo quando categoryPath è presente nella richiesta; altrimenti obbligatorio.

searchCategoryType

I termini di ricerca utilizzati per filtrare i risultati.

query

Quando si cerca modelli, i sottotipi associati ai risultati di ricerca.

modelSubTypes

Quando si cerca modelli, i sottotipi non associati ai risultati di ricerca.

excludedModelSubTypes

Deprecato: si prega di fare riferimento alle proprietà 'userId' e 'groupId'. Il tipo e l'ID del creatore. Es. "user/123" o "group/456"

creator

L'ID Utente del creatore. Solo uno tra 'userId' e 'groupId' può essere presente in una query.

userId

L'ID Gruppo del creatore. Solo uno tra 'userId' e 'groupId' può essere presente in una query.

groupId

L'identificatore per la pagina dei risultati di ricerca desiderata. Solo uno tra 'pageNumber' e 'pageToken' può essere presente in una query.

pageToken

pageNumber

Il numero di asset da restituire. Non può essere maggiore di 100.

maxPageSize

La direzione di ordinamento dei risultati di ricerca.

sortCategory

Quando si cerca audio, la durata minima degli asset audio. Se incluso, deve essere maggiore o uguale a 0.

audioMinDurationSeconds

Quando si cerca audio, la durata massima degli asset audio. Se incluso, deve essere maggiore o uguale a 0.

audioMaxDurationSeconds

Quando si cerca audio, il nome dell'artista degli asset audio.

audioArtist

Quando si cerca audio, il nome dell'album degli asset audio.

audioAlbum

Quando si cerca audio, il tipo degli asset audio.

audioTypes

Quando si cercano modelli, questo filtra i tipi di [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) inclusi nel modello.

includedInstanceTypes

includeOnlyVerifiedCreators

minPriceCents

maxPriceCents

facets

I tag utilizzati per filtrare i risultati.

categoryPath

searchView

musicChartType

swimlane

Creator Store

Esperienze

Avatar

Risorse

Campioni e progetti

API Motore

Cloud API aperto

Studio

Analisi

Piattaforma

Tutorial

Programmi per creatori

Istruzione

Corsi

Impara

Questo metodo è asincrono e restituisce un'"operazione", che rappresenta lo stato corrente della stessa. Contiene un percorso endpoint che è possibile sondare per ottenere la risposta reale e i metadati applicabili. Per ulteriori informazioni, consulta la [documentazione]({longRunningOperationsLink}) sulle operazioni di lunga durata.
            
Le sezioni seguenti descrivono gli oggetti di risposta e metadati forniti al completamento di un'operazione.

Gli endpoint beta sono pronti per l'uso del pubblico. Modifiche incompatibili sono possibili ma rare.

Queste pagine di documentazione di Open Cloud verranno rimosse il 31 marzo 2026. Verrai reindirizzato automaticamente alla nuova documentazione di Open Cloud in quel momento. {linkStart}Scopri di più{linkEnd}

Queste vecchie pagine di Open Cloud verranno rimosse e reindirizzate il 31 marzo 2026. {linkStart}Scopri di più{linkEnd}

Gli endpoint sperimentali sono pronti per l'uso pubblico, ma potrebbero subire modifiche incompatibili durante il processo di finalizzazione del contratto API.

Questo endpoint può essere chiamato in-experience tramite {httpServiceLinkStart}HttpService{httpServiceLinkEnd} con una chiave API.

Questo campo può essere impostato durante la creazione di una risorsa, ma non può essere modificato da richieste successive.

È possibile impostare questi campi durante la creazione di una risorsa, ma non modificarli in base a richieste successive.

Questo campo può essere fornito per le richieste, ma non verrà mai incluso nelle risposte.

Metodo di autenticazione legacy. Preferisci sempre l'utilizzo della chiave dell'API o OAuth 2.0 quando disponibile.

Per chiave API: {maxInPeriod} richieste ogni {periodInSeconds} secondi per indirizzo IP

Non richiede un'autenticazione. In genere ha limiti di velocità notevolmente ridotti. Se disponibile, è sempre meglio l'utilizzo della chiave dell'API o OAuth 2.0.

Per ogni raggruppamento, devi inserire solo uno dei campi seguenti nello schema. Gli altri possono essere ignorati.

Puoi riattivarle in qualsiasi momento. {linkStart}Lascia un feedback{linkEnd}.

Stai visualizzando i vecchi documenti. {linkStart}Lascia un feedback{linkEnd}.

Puoi disattivarle in qualsiasi momento e tornare alle vecchie pagine di riferimento. {linkStart}Lascia un feedback.{linkEnd}

Stai visualizzando i documenti rinnovati. {linkStart}Lascia un feedback{linkEnd}.

Questo campo può essere impostato per le risposte, ma verrà ignorato nelle richieste.

Nota: i limiti di velocità possono essere inferiori durante i periodi di traffico elevato. Alcuni endpoint ne hanno di aggiuntivi. [Scopri di più sui limiti di velocità]({link}).

{limit} richieste al giorno su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste all'ora su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al minuto su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al secondo su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al minuto per proprietario della chiave dell'API

{limit} richieste al giorno per utente dell'app

{limit} richieste all'ora per utente dell'app

{limit} richieste al minuto per utente dell'app

{limit} richieste al secondo per utente dell'app

{limit} richiesta/e al secondo per proprietario della chiave dell'API

Gli obiettivi controllano le autorizzazioni delle tue credenziali. Le tue credenziali possono accedere solo agli endpoint supportati dagli obiettivi selezionati.

Gli endpoint stabili sono pronti per la produzione e raramente subiscono modifiche significative nel corso del loro ciclo di vita.

Questo obiettivo consente di limitare l'accesso della chiave a {requiredParts}

Questo obiettivo consente di limitare l'accesso della chiave a {requiredParts} e {optionalParts}

I tipi di destinazione servono a limitare le risorse su cui le tue credenziali hanno permesso di agire. Solo le risorse selezionate possono essere utilizzate, anche se l'account ha permessi su risorse aggiuntive. Alcuni ambiti non includono parti di destinazione. In questi casi, tutte le risorse pertinenti possono essere utilizzate.

La parte di primo livello dell'universo non dovrebbe essere selezionata per le chiavi dell'API di proprietà dell'utente. In questo modo, la tua chiave dell'API potrà accedere a tutte le esperienze di proprietà dell'utente e del gruppo, a condizione che tu disponga dei permessi corretti per il gruppo.

Provalo non è ancora supportato per gli endpoint che richiedono la chiave dell'API o l'autenticazione OAuth 2.0

L'autenticazione dei cookie è disabilitata per le operazioni ad alto rischio per la sicurezza.

Gli endpoint critici sono altamente sensibili e Provalo è stato disabilitato per ragioni di sicurezza

Nota: le intestazioni di autenticazione non sono incluse in questo esempio di codice. Potrebbe essere necessario aggiungerne una affinché questo comando funzioni.

Questo è un endpoint ad alto rischio che potrebbe causare la modifica o la cancellazione di dati critici. Utilizza estrema cautela in fase di test.

Questo endpoint API è stato classificato come AD ALTO RISCHIO e può influire sui dati in tempo reale o sugli account utente.

Le richieste autenticate alle API ad alto rischio possono apportare modifiche irreversibili. Controlla attentamente i parametri della richiesta prima di procedere.

Effettua il login per utilizzare l'autenticazione tramite cookie

Questo è un endpoint a basso rischio per il recupero dati. Generalmente è sicuro in fase di test.

Questo è un endpoint a rischio medio per la modifica dei dati. Esegui il test con attenzione servendoti di account non critici, poiché le modifiche potrebbero essere permanenti.

Per proteggere il tuo account, non incollare mai qui il testo da altre fonti e non inviare informazioni da questa pagina ad altri.

Stai per testare gli endpoint API live utilizzando le credenziali del tuo account reale.

Procedi solo se comprendi le implicazioni delle chiamate API che stai per effettuare. Esamina attentamente la documentazione dell'API prima di eseguire il test.

Le chiamate API verranno effettuate utilizzando la tua sessione autenticata

Si tratta di chiamate API reali che potrebbero influire sul tuo account o sui tuoi dati

Si applicano limiti di velocità e altre restrizioni API

Alcune operazioni possono modificare o eliminare i dati

Questo endpoint è stato sostituito dai seguenti endpoint alternativi consigliati:

I seguenti ambiti sono necessari per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, consulta l'articolo [Gestire le chiavi API]({apiKeyReferenceDocLink}).

Per ulteriori informazioni sulla generazione di chiavi, consulta l'articolo [Gestire le chiavi API]({apiKeyReferenceDocLink}).

I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Questa stringa è formattata come [Timestamp](/cloud/reference/types#timestamp).

Un valore JSON può essere `null`, `boolean`, `string`, `number`, `array`, or `object`.

I seguenti ambiti sono necessari per l'applicazione OAuth 2.0 per utilizzare questo endpoint. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedi [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, consulta l'articolo dedicato alla [registrazione e alla revisione dell'app]({oauth2ReferenceDocLink}).

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Per chiamare questo endpoint sono richiesti i seguenti ambiti.

Percorsi risorse

Per utilizzare questo endpoint sono necessari i seguenti ambiti per la tua applicazione OAuth 2.0. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedere [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Creator Store

Assets

Non consigliato