Descripción de las API del medidor de lecturas de perfil

​

API de administración

• CheckLimitedEditionItemAvailability Comprueba el recuento global del artículo de edición limitada.
• GetAllSegments Recupera una matriz de definiciones de segmentos de jugadores. Los resultados pueden usarse en llamadas API posteriores, como GetPlayersInSegment, que requiere un identificador de segmento. Aunque los nombres de los segmentos pueden cambiar, el identificador de ese segmento no cambiará.
• ExportMasterPlayerData Exporta todos los datos asociados de una cuenta de jugador maestra.
• GetCatalogItems Recupera la versión especificada del catálogo de bienes virtuales del título, incluidas todas las propiedades definidas.
• GetContentList Enumera todo el contenido del título y obtiene estadísticas como el tamaño.
• GetDataReport Recupera una dirección URL de descarga para el informe solicitado.
• GetPlayerSegments Enumera todos los segmentos a los que pertenece actualmente un jugador en este momento.
• GetPlayerTags Obtiene todas las etiquetas con un espacio de nombres determinado (opcional) de un perfil de jugador.
• GetPolicy Obtiene la directiva solicitada.
• GetPublisherData Recupera el almacén de clave-valor de la configuración personalizada del publicador.
• GetRandomResultTables Recupera la configuración de la tabla de obtención aleatoria para el título.
• GetStoreItems Recupera el conjunto de artículos definidos para la tienda especificada, incluidos todos los precios definidos.
• GetTitleData Recupera el almacén de clave-valor de la configuración personalizada del título que el cliente puede leer.
• [GetUserAccountInfo](Recupera los detalles pertinentes de un usuario especificado, basándose en una coincidencia con un identificador único proporcionado) Recupera los detalles pertinentes de un usuario especificado, basándose en una coincidencia con un identificador único proporcionado.
• GetUserBans Obtiene todas las prohibiciones de un usuario.
• GetUserData Recupera los datos personalizados específicos del título para el usuario que el cliente puede leer y escribir.
• GetUserInternalData Recupera los datos personalizados específicos del título para el usuario, a los que el cliente no puede acceder.
• GetUserInventory Recupera el inventario actual de bienes virtuales del usuario especificado
• GetUserPublisherData Recupera los datos personalizados específicos del publicador para el usuario que el cliente puede leer y escribir.
• GetUserPublisherInternalData Recupera los datos personalizados específicos del publicador para el usuario, a los que el cliente no puede acceder.
• GetUserPublisherReadOnlyData Recupera los datos personalizados específicos del publicador para el usuario que el cliente solo puede leer.
• GetUserReadOnlyData Recupera los datos personalizados específicos del título para el usuario que el cliente solo puede leer.
• ListVirtualCurrencyTypes Devuelve la lista de todas las monedas virtuales definidas para el título
• GetPlayerIdFromAuthToken Obtiene el identificador de un jugador a partir de un token de autenticación.
• GetPlayersInSegment Permite la paginación por todos los jugadores de un segmento determinado. Esta API crea una instantánea de todos los perfiles de jugador que coinciden con la definición del segmento en el momento de su creación y se mantiene durante el total de segundos de vida (Total Seconds to Live), actualizando su periodo de vida con cada uso posterior del token de continuación. Los perfiles que cambien durante la paginación no se reflejarán en los resultados. Esta operación no admite actualmente los segmentos de pruebas AB.
• GetExperiments Obtiene los detalles de todos los experimentos de un título.
• GetLatestScorecard Obtiene el cuadro de mando más reciente del experimento para el título.
• GetTreatmentAssignment Obtiene las asignaciones de tratamiento de un jugador para cada experimento en ejecución en el título

​

API de cliente

• GetAllUsersCharacters Enumera todos los personajes que pertenecen a un usuario específico. Los CharacterIds no son únicos globalmente; characterId debe evaluarse junto con el PlayFabId principal para garantizar la unicidad.
• GetCatalogItems Recupera la versión especificada del catálogo de bienes virtuales del título, incluidas todas las propiedades definidas.
• GetCharacterData Recupera los datos personalizados específicos del título para el personaje que el cliente puede leer y escribir.
• GetCharacterInventory Recupera el inventario actual de bienes virtuales del personaje especificado.
• GetCharacterLeaderboard Recupera una lista de personajes clasificados para la estadística indicada, a partir del punto señalado en la tabla de clasificación.
• GetCharacterReadOnlyData Recupera los datos personalizados específicos del título para el personaje que el cliente solo puede leer.
• GetCharacterStatistics Recupera los detalles de todas las estadísticas específicas del título para el usuario.
• GetFriendLeaderboard Recupera una lista de amigos clasificados del jugador actual para la estadística indicada, a partir del punto señalado en la tabla de clasificación.
• GetFriendLeaderboardAroundPlayer Recupera una lista de amigos clasificados del jugador actual para la estadística indicada, centrada en el usuario de PlayFab solicitado. Si PlayFabId está vacío o es nulo, devolverá el usuario que ha iniciado sesión actualmente.
• GetFriendsList Recupera la lista de amigos actual del usuario local, limitada a los usuarios que tienen cuentas de PlayFab. También se incluyen los amigos de cuentas vinculadas (Facebook, Steam). Opcionalmente, puede excluir los amigos de algunos servicios vinculados.
• GetLeaderboard Recupera una lista de usuarios clasificados para la estadística indicada, a partir del punto señalado en la tabla de clasificación.
• GetLeaderboardAroundCharacter Recupera una lista de personajes clasificados para la estadística indicada, centrada en el identificador de personaje solicitado.
• GetLeaderboardAroundPlayer Recupera una lista de usuarios clasificados para la estadística indicada, centrada en el jugador solicitado. Si PlayFabId está vacío o es nulo, devolverá el usuario que ha iniciado sesión actualmente.
• GetLeaderboardForUserCharacters Recupera una lista de todos los personajes del usuario para la estadística indicada.
• GetPaymentToken Para flujos de pago en los que el proveedor requiere que PlayFab (el responsable del suministro) inicie la transacción, pero el cliente completa el resto del flujo. En el caso de Xsolla, el cliente pasará a Xsolla el token devuelto aquí para crear un carro. Sondee GetPurchase usando el OrderId devuelto una vez que haya completado el pago.
• GetPlayerProfile Recupera el perfil del jugador.
• GetPlayerSegments Enumera todos los segmentos a los que pertenece actualmente un jugador en este momento.
• GetPlayerStatistics Recupera las estadísticas indicadas (versión y valores actuales de todas las estadísticas, si no se especifica ninguna) para el jugador local.
• GetPlayerStatisticVersions Recupera la información sobre las versiones disponibles de la estadística especificada.
• GetPlayerTags Obtiene todas las etiquetas con un espacio de nombres determinado (opcional) de un perfil de jugador.
• GetPlayerTrades Obtiene todos los intercambios que el jugador abre o acepta, opcionalmente filtrados por estado del intercambio.
• GetPlayFabIDsFromFacebookIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Facebook.
• GetPlayFabIDsFromFacebookInstantGamesIds Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Facebook Instant Games.
• GetPlayFabIDsFromGameCenterIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Game Center (denominados Player Identifier en la Game Center Programming Guide).
• GetPlayFabIDsFromGenericIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de servicio genéricos. Un identificador genérico es el nombre del servicio más el identificador del jugador específico del servicio, tal como lo especificó el título cuando el identificador genérico se agregó a la cuenta del jugador.
• GetPlayFabIDsFromGoogleIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Google. Los identificadores de Google son los identificadores de las cuentas de usuario, disponibles como id en las llamadas de la Google+ People API.
• GetPlayFabIDsFromKongregateIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Kongregate. Los identificadores de Kongregate son los identificadores de las cuentas de usuario, disponibles como user_id en los métodos de la API de Kongregate (por ejemplo, https://docs.kongregate.com/docs/concepts-handling-guests).
• GetPlayFabIDsFromNintendoSwitchDeviceIds Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Nintendo Switch.
• GetPlayFabIDsFromPSNAccountIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de PlayStation™ Network.
• GetPlayFabIDsFromSteamIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Steam. Los identificadores de Steam son los identificadores de perfil de las cuentas de usuario, disponibles como SteamId en las llamadas de la Steamworks Community API.
• GetPlayFabIDsFromTwitchIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Twitch. Los identificadores de Twitch son los identificadores de las cuentas de usuario, disponibles como “_id” en los métodos de la API de Twitch (por ejemplo: https://github.com/justintv/Twitch-API/blob/master/v3_resources/users.md#get-usersuser).
• GetPlayFabIDsFromXboxLiveIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de XboxLive.
• GetPublisherData Recupera el almacén de clave-valor de la configuración personalizada del publicador.
• GetPurchase Recupera una compra junto con su estado actual en PlayFab. Devuelve los artículos del inventario de la compra que siguen activos.
• GetSharedGroupData Recupera los datos almacenados en un objeto de grupo compartido y la lista de miembros del grupo. Los no miembros del grupo usan esta API para recuperar datos del grupo, incluida la pertenencia, pero no recibirán datos de las claves marcadas como privadas. Los grupos compartidos están diseñados para compartir datos entre un número reducido de jugadores. Para obtener más información, consulte Uso de datos de grupos compartidos.
• GetStoreItems Recupera el conjunto de artículos definidos para la tienda especificada, incluidos todos los precios definidos.
• GetTitleData Recupera el almacén de clave-valor de la configuración personalizada del título
• GetAccountInfo Recupera los detalles de la cuenta de PlayFab del usuario.
• LoginWithAndroidDeviceID Inicia la sesión del usuario usando el identificador de dispositivo Android y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• LoginWithCustomID Inicia la sesión del usuario usando un identificador único personalizado generado por el título y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado
• LoginWithEmailAddress Inicia la sesión del usuario en la cuenta de PlayFab y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado. A diferencia de la mayoría de las demás llamadas API de inicio de sesión, LoginWithEmailAddress no permite la creación de cuentas nuevas mediante CreateAccountFlag. Las direcciones de correo electrónico pueden usarse para crear cuentas mediante RegisterPlayFabUser.
• LoginWithFacebook Inicia la sesión del usuario usando un token de acceso de Facebook y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• LoginWithFacebookInstantGamesId Inicia la sesión del usuario usando un identificador de Facebook Instant Games y devuelve un identificador de sesión que puede usarse después para llamadas API que requieran un usuario autenticado. Requiere que Facebook Instant Games esté configurado.
• LoginWithGameCenter Inicia la sesión del usuario usando un identificador de jugador de Game Center de iOS y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• LoginWithGoogleAccount Inicia la sesión del usuario usando un identificador de jugador de Game Center de iOS y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• LoginWithIOSDeviceID Inicia la sesión del usuario usando las credenciales de su cuenta de Google.
• LoginWithKongregate Inicia la sesión del usuario usando una cuenta de jugador de Kongregate.
• LoginWithNintendoSwitchDeviceId Inicia la sesión del usuario usando un identificador de dispositivo de Nintendo Switch y devuelve un identificador de sesión que puede usarse después para llamadas API que requieran un usuario autenticado.
• LoginWithOpenIdConnect Inicia la sesión de un usuario usando un JWT de Open ID Connect creado por una relación existente entre un título y un proveedor de Open ID Connect.
• LoginWithPlayFab que requieran un usuario autenticado. A diferencia de la mayoría de las demás llamadas API de inicio de sesión, LoginWithPlayFab no permite la creación de cuentas nuevas mediante CreateAccountFlag. Las credenciales de nombre de usuario/contraseña pueden usarse para crear cuentas mediante RegisterPlayFabUser, o agregarse a cuentas existentes mediante AddUsernamePassword.
• LoginWithPSN Inicia la sesión del usuario en la cuenta de PlayFab y devuelve un identificador de sesión que puede usarse después para llamadas API que requieran un usuario autenticado. A diferencia de la mayoría de las demás llamadas API de inicio de sesión, LoginWithPlayFab no permite la creación de cuentas nuevas mediante CreateAccountFlag. Las credenciales de nombre de usuario/contraseña se usan para crear cuentas mediante RegisterPlayFabUser, o se agregan a cuentas existentes mediante AddUsernamePassword.
• LoginWithSteam Inicia la sesión del usuario usando un vale de autenticación de Steam y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• LoginWithTwitch Inicia la sesión del usuario usando un token de acceso de Twitch.
• LoginWithXbox Inicia la sesión del usuario usando un token de XBOX Live y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• GetPlayerCombinedInfo Recupera todos los distintos tipos de información del usuario.

​

API de datos

• GetObjects Recupera objetos del perfil de una entidad.

​

API de grupos

• GetGroup Obtiene información sobre un grupo y sus roles.
• IsMember Comprueba si una entidad es miembro de un grupo o de un rol dentro del grupo.
• ListGroupApplications Enumera todas las solicitudes pendientes para unirse a un grupo.
• ListGroupBlocks Enumera todas las entidades bloqueadas para unirse a un grupo.
• ListGroupInvitations Enumera todas las invitaciones pendientes de un grupo.
• ListGroupMembers Enumera todos los miembros de un grupo.
• ListMembership Enumera todos los grupos y roles de una entidad.
• ListMembershipOpportunities Enumera todas las invitaciones y solicitudes de grupo pendientes de una entidad.

​

API de perfil

• GetGlobalPolicy Obtiene la directiva de acceso global del título.
• GetProfile Recupera el perfil de la entidad.
• GetProfiles Recupera el perfil de la entidad.
• GetTitlePlayersFromMasterPlayerAccountIds Recupera las cuentas de jugador del título asociadas a la cuenta de jugador maestra especificada.

​

API de servidor

• EvaluateRandomResultTable Devuelve el resultado de una evaluación de una tabla de resultados aleatorios: el ItemId del catálogo del juego que se habría agregado al inventario del jugador si la tabla de resultados aleatorios se hubiera agregado mediante un lote (Bundle) o una llamada a UnlockContainer.
• GetAllSegments Recupera una matriz de definiciones de segmentos de jugadores. Los resultados pueden usarse en llamadas API posteriores, como GetPlayersInSegment, que requiere un identificador de segmento. Aunque los nombres de los segmentos pueden cambiar, el identificador de ese segmento no cambiará.
• GetAllUsersCharacters Enumera todos los personajes que pertenecen a un usuario específico. Los CharacterIds no son únicos globalmente; characterId debe evaluarse junto con el PlayFabId principal para garantizar la unicidad.
• GetCatalogItems Recupera la versión especificada del catálogo de bienes virtuales del título, incluidas todas las propiedades definidas.
• GetCharacterData Recupera los datos personalizados específicos del título para el usuario que el cliente puede leer y escribir.
• GetCharacterInternalData Recupera los datos personalizados específicos del título para el personaje del usuario, a los que el cliente no puede acceder.
• GetCharacterInventory Recupera el inventario actual de bienes virtuales del personaje especificado.
• GetCharacterReadOnlyData
• GetCharacterStatistics Recupera los detalles de todas las estadísticas específicas del título para el personaje específico.
• GetFriendLeaderboard Recupera una lista de amigos clasificados del jugador especificado para la estadística indicada, a partir del punto señalado en la tabla de clasificación.
• GetFriendsList Recupera los amigos actuales del usuario con PlayFabId, limitados a los usuarios que tienen cuentas de PlayFab. También se incluyen los amigos de cuentas vinculadas (Facebook, Steam). Opcionalmente, puede excluir los amigos de algunos servicios vinculados.
• GetLeaderboard Recupera una lista de usuarios clasificados para la estadística indicada, a partir del punto señalado en la tabla de clasificación.
• GetLeaderboardAroundCharacter Recupera una lista de personajes clasificados para la estadística indicada, centrada en el usuario solicitado.
• GetLeaderboardAroundUser Recupera una lista de personajes clasificados para la estadística indicada, centrada en el usuario solicitado.
• GetLeaderboardForUserCharacters Recupera una lista de todos los personajes del usuario para la estadística indicada.
• GetPlayerCombinedInfo Devuelve la información que se solicite en la respuesta para el usuario. Tenga en cuenta que pueden devolverse datos personales, como la dirección de correo electrónico o el identificador de Facebook. Todos los parámetros tienen false como valor predeterminado.
• GetPlayerProfile Recupera el perfil del jugador.
• GetPlayerSegments Enumera todos los segmentos a los que pertenece actualmente un jugador en este momento.
• GetPlayersInSegment Permite la paginación por todos los jugadores de un segmento determinado. Esta API crea una instantánea de todos los perfiles de jugador que coinciden con la definición del segmento en el momento de su creación y se mantiene durante el total de segundos de vida (Total Seconds to Live), actualizando su periodo de vida con cada uso posterior del token de continuación. Los perfiles que cambien durante la paginación no se reflejan en los resultados. Esta operación no admite actualmente los segmentos de pruebas AB.
• GetPlayerStatistics Recupera la versión y los valores actuales de las estadísticas indicadas para el jugador local.
• GetPlayerStatisticVersions Recupera la información sobre las versiones disponibles de la estadística especificada.
• GetPlayerTags Obtiene todas las etiquetas con un espacio de nombres determinado (opcional) de un perfil de jugador.
• GetPlayFabIDsFromFacebookIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Facebook.
• GetPlayFabIDsFromFacebookInstantGamesIds Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Facebook.
• GetPlayFabIDsFromGenericIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de servicio genéricos. Un identificador genérico es el nombre del servicio más el identificador del jugador específico del servicio, tal como lo especificó el título cuando el identificador genérico se agregó a la cuenta del jugador.
• GetPlayFabIDsFromNintendoSwitchDeviceIds Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de dispositivo de Nintendo Switch.
• GetPlayFabIDsFromPSNAccountIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de PlayStation Network.
• GetPlayFabIDsFromSteamIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de Steam. Los identificadores de Steam son los identificadores de perfil de las cuentas de usuario, disponibles como SteamId en las llamadas de la Steamworks Community API.
• GetPlayFabIDsFromXboxLiveIDs Recupera los identificadores únicos de PlayFab para el conjunto especificado de identificadores de XboxLive.
• GetPublisherData Recupera el almacén de clave-valor de la configuración personalizada del publicador.
• GetRandomResultTables Recupera la información de configuración de las tablas de resultados aleatorios especificadas para el título, incluidos todos los valores de ItemId y las ponderaciones.
• GetServerCustomIDsFromPlayFabIDs Recupera los identificadores de cuenta de PlayFab asociados para el conjunto especificado de identificadores personalizados de servidor.
• GetSharedGroupData Recupera los datos almacenados en un objeto de grupo compartido y la lista de miembros del grupo. El servidor puede acceder a todos los datos públicos y privados del grupo. Los grupos compartidos están diseñados para compartir datos entre un número reducido de jugadores. Para obtener más información, consulte Uso de datos de grupos compartidos.
• GetStoreItems Recupera el conjunto de artículos definidos para la tienda especificada, incluidos todos los precios definidos, para el jugador especificado.
• GetTitleData Recupera el almacén de clave-valor de la configuración personalizada del título.
• GetTitleInternalData Recupera el almacén de clave-valor de la configuración interna personalizada del título.
• GetUserAccountInfo Recupera los detalles pertinentes de un usuario especificado.
• GetUserBans Obtiene todas las prohibiciones de un usuario.
• GetUserData Recupera los datos personalizados específicos del título para el usuario que el cliente puede leer y escribir.
• GetUserInternalData Recupera los datos personalizados específicos del título para el usuario, a los que el cliente no puede acceder.
• GetUserInventory Recupera el inventario actual de bienes virtuales del usuario especificado.
• GetUserPublisherData Recupera los datos personalizados específicos del publicador para el usuario que el cliente puede leer y escribir.
• GetUserPublisherInternalData Recupera los datos personalizados específicos del publicador para el usuario, a los que el cliente no puede acceder.
• GetUserPublisherReadOnlyData
• GetUserReadOnlyData Actualiza los datos personalizados específicos del título para el usuario que el cliente solo puede leer.
• LoginWithServerCustomId Inicia de forma segura la sesión de un cliente de juego desde un back-end de servidor externo usando un identificador personalizado para ese jugador. El identificador personalizado de servidor y el identificador personalizado de cliente son mutuamente excluyentes y no pueden usarse para recuperar la misma cuenta de jugador.
• LoginWithXbox Inicia la sesión del usuario usando un token de XBOX Live desde un back-end de servidor externo y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.
• LoginWithXboxId Inicia la sesión del usuario usando un identificador de XBOX y un identificador de sandbox, y devuelve un identificador de sesión que puede usarse posteriormente para llamadas API que requieran un usuario autenticado.