Gestiona tu presencia en la [Tienda del Creador](/production/creator-store). [Crea](#Cloud_CreateCreatorStoreProduct) y [actualiza](#Cloud_UpdateCreatorStoreProduct) listados de productos para tus activos, y [busca en la caja de herramientas](#Toolbox_SearchCreatorStoreAssets) activos utilizando varios filtros.


El tipo de audio (Música o Efecto de Sonido).

La duración del archivo de audio en segundos.

Parámetros de filtro de búsqueda específicos de audio.

Tipos de audio para incluir (por ejemplo, Música, Efecto de Sonido)

La duración máxima para el audio en segundos. Si se incluye, debe ser mayor o igual a 1.

La duración mínima para el audio en segundos. Si se incluye, debe ser mayor o igual a 0.

Indica de qué listas de música filtrar.

Modelo de solicitud para eliminar en bloque los guardados.

Una lista de guardados que se están eliminando.

Modelo de respuesta para la operación de eliminar en bloque los guardados.

Número de guardados que se eliminaron con éxito.

Modelo de solicitud para crear un guardado

Las colecciones personalizadas no son actualmente soportadas.
Este campo debe ser omitido.

Obsoleto: Por favor refiérase a las propiedades 'userId' y 'groupId' en su lugar.
El tipo de creador y ID. Ej. user/123 o group/456.

El ID del grupo. Requerido si el activo es de propiedad de grupo.

Este valor solo existe para creadores basados en grupo y representa el ID de usuario del creador que actualizó por última vez el activo.

Este valor solo existe para creadores basados en grupo y representa el nombre del creador que actualizó por última vez el activo.

El ID de usuario del creador. Requerido si el activo es de propiedad individual del usuario.

Representación de un activo de tienda de creadores.

Representa las capacidades que tiene un modelo (p. ej. aislamiento).
Solo está presente para tipos de activos de modelo; AMRS lo incluye en la respuesta cuando está disponible.

Controla si el modelo será aislado al insertarse cuando tenga scripts.

Representa un producto en la tienda del creador. Este recurso se utiliza para gestionar
distribución y precios de activos en la tienda del creador.

El producto de la tienda del creador es un archivo de audio con este ID de activo.

El producto de la tienda del creador es una decal con este ID de activo.

El producto de la tienda del creador es una familia de fuentes con este ID de activo.

El grupo de Roblox que vende el producto.

El producto de la tienda del creador es una parte de malla con este ID de activo.

El producto de la tienda del creador es un modelo con este ID de activo.

La ruta del recurso del producto de la tienda del creador.

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

El producto de la tienda del creador es un plugin con este ID de activo.

Precios base soportados en 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

Si el vendedor tiene la intención de distribuir el producto de la tienda de creadores en
tu tienda de creadores. Un vendedor puede tener la intención de distribuir un producto, pero debido
a algunas restricciones en el vendedor o en el producto de la tienda de creadores subyacente, el
producto puede no estar disponible para la compra. Ver
`restrictions` y `purchasable` para más detalles.

Si el producto es comprable.

Para que este valor sea verdadero, `published` debe ser verdadero y `restrictions` debe
estar vacío. Si este valor es falso, el producto puede no ser adquirido por ningún
usuario.

Restricciones aplicadas al producto. Un producto puede tener múltiples
restricciones activas al mismo tiempo.

Valores posibles:

  | Valor | Descripción |
  | --- | --- |
  | RESTRICTION_UNSPECIFIED | Restricción no especificada. |
  | SOLD_ITEM_RESTRICTED | El artículo que se vende ha sido restringido por Roblox. Los detalles pueden estar disponibles al buscar ese artículo directamente. |
  | SELLER_TEMPORARILY_RESTRICTED | El producto está restringido porque la cuenta del vendedor está temporalmente restringida por Roblox. |
  | SELLER_PERMANENTLY_RESTRICTED | El producto está restringido porque la cuenta del vendedor está permanentemente restringida por Roblox. |
  | SELLER_NO_LONGER_ACTIVE | El producto está restringido porque la cuenta del vendedor fue eliminada o de otro modo ya no está activa. |

El usuario de Roblox que vende el producto.

El producto de la tienda del creador es un video con este ID de activo.

Representa un número decimal en una forma similar a la notación científica.

Ejemplos:
 - 17            === `{significand: 17   exponent: 0} (o solo {significand:
   17})`
 - -0.005        === `{significand: -5   exponent: -3}`
 - 33.5 millones  === `{significand: 335  exponent: 5}`
 - 11/8 (1.375)  === `{significand: 1375 exponent: -3}`

Nota que el rango de un Decimal excede el de un `number` JSON (double), así
como el de un `decimal64`.

Representa la posición del punto decimal dentro del significand.

Cuando el exponente es 0, el valor del Decimal es simplemente el valor de
`significand`.

Cuando el exponente es mayor que 0, representa el número de ceros finales
tras los dígitos significativos.

Cuando el exponente es menor que 0, representa cuántos de los dígitos significativos
(y ceros iniciales implícitos, según sea necesario) vienen después del punto decimal.

Modelo de solicitud para eliminar un guardado

El tipo de activo que se está eliminando

Modelo de respuesta para obtener guardados.

El número total de guardados que coinciden con la consulta.

Un registro de guardado, hidratado con los detalles del activo.

Representa el conteo de varios tipos de instancia dentro de un activo.
Vea [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance).

El id de la textura de la parte de malla.

Capacidades de script para el activo (sandboxing)

El número de tipos de instancia de estudio en el modelo.
Consulte [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance).
Estos se desglosan en tipos específicos, como MeshPart, Part, Script,
Tool, Animation, etc.

El resumen de las mallas dentro del modelo, si existen.

El número de scripts que hay en el modelo.

Los subtipos a los que pertenece el modelo.

Una lista de tipos de instancias de modelo. Consulte Toolbox.Service.Models.Internal.InstanceCounts y [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) para más detalles.

Parámetros de filtro de búsqueda específicos del modelo.

Si se incluye, excluye activos con estos subtipos.

Este filtro establece que los siguientes tipos de [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) estén incluidos en el modelo.

Si se incluye, buscar activos solo con estos subtipos.

Representa una cantidad de dinero con su tipo de moneda.

Ejemplos:
 - Cinco dólares estadounidenses === `{currency_code: "USD" cantidad: {significant: 5}}`

Un código de moneda.

Esto puede ser un código de moneda de tres letras definido en ISO 4217.

Las APIs pueden definir códigos de moneda adicionales que no están incluidos en el ISO
4217 estándar (por ejemplo, monedas virtuales o criptomonedas). Estos
deben comenzar con `X-`, para distinguirlos de posibles futuros
códigos ISO 4217. Por ejemplo, `"USD"` es el código ISO 4217 para el dólar de Estados Unidos.

Representa de qué gráfica musical obtener entradas, si las hay

Proporciona un resumen de las características de la malla de un objeto, como el conteo de triángulos y vértices.

El número total de triángulos en la malla del objeto.

El número total de vértices en la malla del objeto.

El número de scripts que hay en el plugin.

IDs de activos de vista previa agrupados para un elemento, separados por tipo de medio.

Lista ordenada de ids de activos de vista previa de imágenes.

Lista ordenada de ids de activos de vista previa de videos.

Contiene información de corrección de consulta para una consulta de búsqueda.

La sugerencia de corrección ortográfica para la consulta de búsqueda original.

Facetas que ya están aplicadas a la búsqueda.

Las facetas no utilizadas y aún disponibles.

La categoría por la que se deben clasificar los guardados.

Representa valores de tipo de audio que se mostrarán correctamente en la interfaz de Swagger.

Esto representa un "conjunto" de opciones de Toolbox.Service.CategoryType y representa el conjunto completo
de "categorías" (o tipos de activos) que se pueden buscar en la API de búsqueda de toolbox.

Modelo de solicitud para buscar activos de la Tienda de Creadores.

Filtros de búsqueda específicos de audio.

Palabras clave adicionales para consultar.

El ID del grupo del creador. Solo uno de 'userId' y 'groupId' puede estar presente en una consulta.

El archivo de imagen por el que buscar. La imagen debe estar codificada en base64 para ser utilizada en la búsqueda. Solo uno de 'query' e 'image' puede estar presente en una consulta.

Si los resultados deben incluir solo activos creados por creadores verificados.

El número de activos a devolver. No puede ser mayor de 100.

El precio máximo del activo en centavos. Si se incluye, debe ser mayor o igual a 0.

El precio mínimo del activo en centavos. Si se incluye, debe ser mayor o igual a 0.

Filtros de búsqueda específicos de modelos.

El número de página a recuperar, comenzando desde 0. Solo uno de 'pageNumber' y 'pageToken' puede estar presente en una consulta.

El identificador de la página de resultados de búsqueda deseada. Solo uno de 'pageNumber' y 'pageToken' puede estar presente en una consulta.

Los términos de búsqueda utilizados para filtrar los resultados. Solo uno de 'query' e 'image' puede estar presente en una consulta.

El tipo de activo para buscar. Opcional cuando Toolbox.Service.SearchCreatorStoreAssetsRequest.CategoryPath
se resuelve en un tipo de activo; de lo contrario, es obligatorio.

Indica qué campos se poblarán en la respuesta.

La categoría por la que clasificar los resultados de búsqueda.

La dirección de orden de los resultados de búsqueda.

Identificador de carril de natación opcional (por ejemplo, "tendencias", "esencial", "precio").

El ID de usuario del creador. Solo uno de 'userId' y 'groupId' puede estar presente en una consulta.

La respuesta para el endpoint SearchCreatorStoreAssets.

La lista de activos de la tienda de creadores devueltos por la consulta de búsqueda.

La palabra clave filtrada que se utilizó para buscar activos, si corresponde.

El token de página para ver la siguiente página de resultados.

Información de corrección de consulta, si había una corrección disponible para la consulta de búsqueda.

Los facetas aplicadas y disponibles de una consulta.

El número total de resultados para la consulta de búsqueda dada.

Esta vista controla qué campos se poblan en la respuesta de búsqueda. Una vista más ligera
resultará en tiempos de respuesta más rápidos y mayor confiabilidad.

La categoría por la que se ordenan los resultados de búsqueda.

Representa la dirección en la cual se ordenan los resultados.

Representación de un activo de efecto de sonido.

Ruta de categoría del activo, si existe.
e.j. "3d__characters"

ID del universo si el activo fue creado dentro de un universo específico.

Los IDs de activos de vista previa agrupados por tipo de activo.

Los enlaces sociales asociados con el activo.

El tiempo en que se actualizó por última vez el activo.

La información del producto de la tienda del creador del activo.

Si el activo puede ser comprado en la Tienda de Creadores.

El precio del activo, incluyendo el código de la moneda.

El porcentaje del total de votos que han sido votos a favor.

Una clave configurable que permite un acceso granular a los recursos de Roblox. Vea https://create.roblox.com/docs/cloud/auth/api-keys para más información.

x-api-key

Una cookie de navegador que representa la identidad de un usuario de Roblox. NO COMPARTA ESTO. Compartir esto permitirá que alguien inicie sesión como usted y robe sus Robux y objetos. No recomendamos usar cookies para llamar a puntos finales. Cuando sea posible, use claves API con el encabezado x-api-key o OAuth 2.0 en su lugar para la autenticación.

.ROBLOSECURITY

Construye o autoriza aplicaciones para acceder a los recursos de Roblox. Vea https://create.roblox.com/docs/cloud/auth/oauth2-overview para más información.

La API de Roblox. Consulta https://create.roblox.com/docs/cloud/open-cloud para más detalles.

API de Roblox

Agrega un producto de la Tienda de Creadores. Solo utiliza este método si tu producto nunca ha sido
distribuido en la Tienda de Creadores; de lo contrario, utiliza el método `PATCH` para
actualizar el producto.

CreatorStoreProduct

creator-store-product:write

Obtener un producto de la Tienda de Creadores.

El ID del producto de la tienda de creadores.

creator_store_product_id

Obtener Producto de la Tienda de Creadores

creator-store-product:read

Actualizar un producto de la Tienda de Creadores.

updateMask

Si se establece en verdadero, y el producto de la tienda de creadores no se encuentra, se crea un producto de la tienda de creadores.
En esta situación, `update_mask` se ignora.

allowMissing

Actualizar Producto de la Tienda de Creadores

targetType

targetId

Las colecciones personalizadas no son compatibles actualmente. Este campo debe omitirse.

collectionName

creator-store-save:write

El ID del activo por el cual filtrar. Si se proporciona, targetType también debe ser proporcionado.

sortBy

sortDirection

El número máximo de guardados a devolver

limit

El número de página a devolver, comenzando desde 1

page

keyword

Si se deben ocultar los activos de propiedad

hideOwnedAssets

creator-store-save:read

Elimina en masa guardados.
Máximo de 5000 guardados por solicitud.

Obtener detalles de un solo activo de la tienda de creadores.

El ID del activo para el que se desea obtener detalles.

Obtener detalles del activo de la tienda de creadores

Buscar en la tienda de creadores por activos.

El tipo de activo para buscar. Opcional cuando categoryPath está presente en la solicitud; de lo contrario, es obligatorio.

searchCategoryType

Los términos de búsqueda utilizados para filtrar los resultados.

query

Al buscar modelos, los subtipos asociados con los resultados de búsqueda.

modelSubTypes

Al buscar modelos, los subtipos no asociados con los resultados de búsqueda.

excludedModelSubTypes

Obsoleto: Consulte las propiedades 'userId' y 'groupId' en su lugar. El tipo de creador y el ID. Por ejemplo, "user/123" o "group/456"

creator

userId

El ID de grupo del creador. Solo uno de 'userId' y 'groupId' puede estar presente en una consulta.

groupId

El identificador para la página de resultados de búsqueda deseada. Solo uno de 'pageNumber' y 'pageToken' puede estar presente en una consulta.

pageToken

pageNumber

El número de activos a ser devueltos. No puede ser mayor que 100.

maxPageSize

La dirección de clasificación de los resultados de búsqueda.

sortCategory

Al buscar audio, la duración mínima de los activos de audio. Si se incluye, debe ser mayor o igual a 0.

audioMinDurationSeconds

Al buscar audio, la duración máxima de los activos de audio. Si se incluye, debe ser mayor o igual a 0.

audioMaxDurationSeconds

Al buscar audio, el nombre del artista de los activos de audio.

audioArtist

Al buscar audio, el nombre del álbum de los activos de audio.

audioAlbum

Al buscar audio, el tipo de activos de audio.

audioTypes

Al buscar modelos, este filtro indica que los siguientes tipos de [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) están incluidos en el modelo.

Creator Store

Assets

No recomendado