> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Límites de Economy V2

> Consulte los límites de limitación de solicitudes y de frecuencia de las API de catálogo e inventario de PlayFab Economy v2, incluidas las cuotas de solicitudes por segundo por jugador y por título.

# Límites - Economy (V2)

<Info>
  Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al [foro de PlayFab](https://community.playfab.com).
</Info>

El objetivo de esta guía es detallar los límites que se aplican al crear, actualizar y leer el catálogo de artículos, así como al agregarlos, actualizarlos y quitarlos de los inventarios de los jugadores. Ahora incluye los límites más actualizados según Economy (V2).

* Limit (Player) se refiere a cuando la entidad de destino es un jugador (Player).
* Limit (Title) se refiere a cuando la entidad de destino es un título (Title).

<Note>
  Todas las API se contabilizan por separado unas de otras.
</Note>

## Limitación del catálogo

### Lectura

| **API**                    | **Límite (jugador)**          | **Límite (título)**              |
| -------------------------- | ----------------------------- | -------------------------------- |
| **GetItem**                | 1,67 rps (100 en 60 segundos) | 1000 rps (10 000 en 10 segundos) |
| **GetItems**               | 1,67 rps (100 en 60 segundos) | 1000 rps (10 000 en 10 segundos) |
| **SearchItems**            | 1,67 rps (100 en 60 segundos) | 1000 rps (10 000 en 10 segundos) |
| **GetItemReviews**         | 1,67 rps (100 en 60 segundos) | 1000 rps (10 000 en 10 segundos) |
| **GetItemReviewsSummary**  | 1,67 rps (100 en 60 segundos) | 1000 rps (10 000 en 10 segundos) |
| **GetEntityItemReview**    | 1,67 rps (100 en 60 segundos) | 1000 rps (10 000 en 10 segundos) |
| **GetItemModerationState** | -                             | 1000 rps (10 000 en 10 segundos) |

### Escritura y administración

| **API**                     | **Límite (jugador)**         | **Límite (título)**           |
| --------------------------- | ---------------------------- | ----------------------------- |
| **CreateDraftItem**         | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **CreateUploadUrls**        | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **DeleteEntityItemReviews** | -                            | 100 rps (1000 en 10 segundos) |
| **DeleteItem**              | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **GetDraftItem**            | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **GetDraftItems**           | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **GetEntityDraftItems**     | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **GetItemPublishStatus**    | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **PublishDraftItem**        | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **ReportItem**              | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **ReportItemReview**        | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **ReviewItem**              | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **SetItemModerationState**  | -                            | 100 rps (1000 en 10 segundos) |
| **SubmitItemReviewVote**    | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |
| **TakedownItemReviews**     | -                            | 100 rps (1000 en 10 segundos) |
| **UpdateDraftItem**         | 0,33 rps (10 en 30 segundos) | 100 rps (1000 en 10 segundos) |

## Limitación del inventario

<Note>
  * La limitación del inventario se calcula en función de la entidad de destino, individualmente para cada API. - Por ejemplo, si un jugador o un título (servicio de juego, CloudScript, etc.) llama a una API de inventario para actualizar el inventario de la entidad de jugador, se aplica la limitación Límite (jugador). - También se admiten los inventarios de [entidades de grupo](/services/playfab/live-service-management/game-configuration/entities#group), y las entidades de grupo comparten la misma tasa de limitación que las entidades de jugador. Consulte también [Grupos](/services/playfab/community/associations/groups).
</Note>

### Lectura

| **API**                       | **Límite (jugador)**         | **Límite (título)** |
| ----------------------------- | ---------------------------- | ------------------- |
| **GetInventoryItems**         | 0,67 rps (40 en 60 segundos) | -                   |
| **GetInventoryCollectionIds** | 0,08 rps (5 en 60 segundos)  | -                   |

### Lectura del historial de transacciones

| **API**                   | **Límite (jugador)**         | **Límite (título)** |
| ------------------------- | ---------------------------- | ------------------- |
| **GetTransactionHistory** | 0,1 rps (30 en 300 segundos) | -                   |

### Escritura

| **API**                        | **Límite (jugador)**         | **Límite (título)** |
| ------------------------------ | ---------------------------- | ------------------- |
| **AddInventoryItems**          | 0,33 rps (20 en 60 segundos) | -                   |
| **SubtractInventoryItems**     | 0,33 rps (20 en 60 segundos) | -                   |
| **UpdateInventoryItems**       | 0,33 rps (20 en 60 segundos) | -                   |
| **PurchaseInventoryItems**     | 0,33 rps (20 en 60 segundos) | -                   |
| **TransferInventoryItems**     | 0,33 rps (20 en 60 segundos) | -                   |
| **DeleteInventoryItems**       | 0,33 rps (20 en 60 segundos) | -                   |
| **ExecuteInventoryOperations** | 0,33 rps (20 en 60 segundos) | -                   |
| **DeleteInventoryCollection**  | 0,08 rps (5 en 60 segundos)  | -                   |

### Canje

| **API**                                  | **Límite (jugador)**         | **Límite (título)** |
| ---------------------------------------- | ---------------------------- | ------------------- |
| **RedeemAppleAppStoreInventoryItems**    | 0,16 rps (10 en 60 segundos) | -                   |
| **RedeemGooglePlayInventoryItems**       | 0,16 rps (10 en 60 segundos) | -                   |
| **RedeemMicrosoftStoreInventoryItems**   | 0,16 rps (10 en 60 segundos) | -                   |
| **RedeemNintendoEShopInventoryItems**    | 0,16 rps (10 en 60 segundos) | -                   |
| **RedeemPlayStationStoreInventoryItems** | 0,16 rps (10 en 60 segundos) | -                   |
| **RedeemSteamInventoryItems**            | 0,16 rps (10 en 60 segundos) | -                   |

## Límites de la API

### Tamaño del contenido binario

El tamaño máximo de archivo permitido es de **500 MB**.

### Cantidad de contenido binario

Se pueden agregar hasta **100 imágenes** y **100 archivos** a un artículo.

* Los archivos no tienen restricciones.
* Las imágenes solo se pueden cargar con los tipos de archivo **.png**, **.jpg**, **.gif** o **.bmp**.

### CreateUploadsUrls

Los blobs o las URL de contenido se recolectarán como elementos no utilizados después de **24 horas** si **no** están adjuntos a un artículo en borrador o publicado.

### Tamaño máximo de página del catálogo

A continuación se indica el número máximo de artículos devueltos por las distintas API. Puede usar los [tokens de continuación](/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens) para paginar los resultados que superen el límite.

* `SearchItems` - 50 artículos por página
* `GetItems` - 50 artículos por página
* `GetItemReviews` - 50 artículos por página
* `GetItemContainers` - 50 artículos por página
* `GetEntityDraftItems` - 50 artículos por página

### Tamaño de página predeterminado del catálogo

* `SearchItems` - 10 artículos por página
* `GetItems` - 10 artículos por página
* `GetItemReviews` - 10 artículos por página
* `GetItemContainers` - 10 artículos por página
* `GetDraftItems` - 10 artículos por página
* `GetEntityDraftItems` - 10 artículos por página

### Tamaño máximo de página del inventario

A continuación se indica el recuento máximo de artículos devueltos por las distintas API. Puede usar los [tokens de continuación](/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens) para paginar los resultados que superen el límite.

| **API**                       | **Límite con compresión de respuesta** | **Límite sin compresión de respuesta** |
| ----------------------------- | -------------------------------------- | -------------------------------------- |
| **GetInventoryItems**         | 250 artículos                          | 50 artículos                           |
| **GetInventoryCollectionIds** | 250 artículos                          | 50 artículos                           |
| **GetTransactionHistory**     | 250 artículos                          | 50 artículos                           |

### Tamaño de página predeterminado del inventario

* `GetInventoryItems` - 10 artículos por página
* `GetInventoryCollectionIds` - 10 artículos por página
* `GetTransactionHistory` - 10 artículos por página

### Complejidad del filtro de búsqueda

Se aplican comprobaciones para evitar el uso de consultas `Filter` demasiado complicadas en las llamadas a `SearchItems`. Puede encontrar más información [aquí](/services/playfab/economy-monetization/economy-v2/catalog/search#limits).

## Artículo del catálogo

### Límite de entidades creadoras del catálogo

Se permiten hasta 20 GB de datos de catálogo por entidad creadora del catálogo. Es más probable que este límite se alcance con los artículos del catálogo creados por la entidad de título.

### Títulos

Los títulos tienen un **límite de 512 caracteres** por código de país.

### Descripciones

Las descripciones tienen un **límite de 10 000 caracteres** por código de país.

### Palabras clave

Las palabras clave tienen un **límite de 50 caracteres** por palabra clave y se pueden agregar hasta **32 palabras clave** por código de país.

### Propiedades de presentación

El campo de propiedades de presentación tiene un **límite de 10 000 bytes**.

### Etiquetas

Las etiquetas tienen un **límite de 32 caracteres** por etiqueta.
Los títulos pueden tener un máximo de **1024 etiquetas** y
se pueden agregar hasta **32 etiquetas** a un artículo

### Tipos de contenido

Los tipos de contenido tienen un **límite de 32 caracteres** por tipo de contenido.
Los títulos pueden tener un máximo de **128 tipos de contenido**.

### PricesOptions

La lista de opciones de precio tiene un límite de longitud de **15 opciones de precio**.

### Amounts

La lista de importes tiene un límite de longitud de **15 importes**.

### UnitDurationInSeconds

La duración de la unidad tiene un límite de **100 años** (3 155 695 200 segundos).

### AlternateIds

Cada identificador alternativo tiene un límite de longitud de valor de **100 caracteres**.

La longitud de la lista de identificadores alternativos tiene un límite de **15 identificadores alternativos**.

### DisplayVersion

El campo de versión de presentación tiene un límite de longitud de valor de **50 caracteres**.

### ClientVersion

La versión de cliente tiene un **límite de 3 segmentos**, y cada segmento permite un valor máximo de **65535**.\
Por ejemplo: "1.65535.234".

### ItemReferences

El campo ItemReferences tiene un límite de **250 artículos**.

## Configuración del catálogo

### AdminEntities

La lista de entidades de administración tiene un **límite de 64 entidades**.

### ReviewerEntities

La lista de entidades de administración tiene un **límite de 128 entidades**.

### Vínculos profundos

El número máximo de vínculos profundos es de **10 vínculos**.

### DisplayPropertyIndexInfo

Hay un límite de **5 valores** por cada tipo de propiedad de presentación.

### Tipos de contenido

La lista de tipos de contenido tiene un límite de **128 tipos**, cada uno con una longitud máxima de **40 caracteres**.

### Plataformas

La lista de plataformas tiene un límite de **128 plataformas**, cada una con una longitud máxima de **40 caracteres**.

### Etiquetas

La lista de etiquetas tiene un límite de **1024 etiquetas**, cada una con una longitud máxima de **32 caracteres**.

## Inventario del jugador

### Operaciones por lotes

El número máximo de operaciones de inventario que se pueden ejecutar es de **50 operaciones**.

El número máximo de artículos que se pueden modificar es de **300 artículos**.\
(por ejemplo, puede agregar un lote completo y hasta 50 artículos más)

### Colecciones de inventario

El tamaño máximo de una colección es de **10 000 artículos**.

El límite de longitud de la lista de colecciones es de **1000 colecciones** por entidad.

El límite de caracteres del nombre de una colección es de **75 caracteres**.

### Historial de transacciones

El intervalo de fechas máximo del historial de transacciones es de **4 años**.

El intervalo de fechas predeterminado es de **seis meses**.

## Artículo de inventario

### Propiedades de presentación

El campo de propiedades de presentación tiene un límite de 1000 bytes.
