Modérer votre contenu généré par les utilisateurs

Ce guide présente les appels d’API qui peuvent servir à créer des flux de modération pour le contenu de votre jeu.

Signaler un objet

Les joueurs peuvent signaler un objet en appelant l’API ReportItem à partir d’un client. Un Id ou un AlernateId d’objet doit être fourni. Des paramètres facultatifs supplémentaires peuvent être ajoutés. Ceux-ci comprennent :

ConcernCategory : une catégorie de préoccupation pour le signalement
Reason : un champ de texte libre pour le signalement

Voici un exemple de corps de requête :

{
  "Id": "3f5dd8d4-4ee1-4748-8855-56a8a0277bf9"
  "ConcernCategory": "Profanity",
  "Reason": "There was swearing in the description."
}

S’il n’est pas spécifié, ConcernCategory prend la valeur par défaut None. Les valeurs ConcernCategory valides sont les suivantes :

None
OffensiveContent
ChildExploitation
MalwareOrVirus
PrivacyConcerns
MisleadingApp
PoorPerformance
ReviewResponse
SpamAdvertising
Profanity

L’appel de l’API ReportItem déclenche uniquement un événement PlayStream sous le nom d’événement item_reported. Celui-ci peut être interrogé à l’aide de l’Explorateur de données dans Game Manager. Des exemples de requêtes sont présentés ci-dessous : La requête suivante retourne le nombre total de signalements par ConcernCategory pour chaque ItemId au cours des 3 derniers jours

['events.all']
| where Timestamp > ago (3d)
| where FullName_Name == "item_reported"
| project ItemId = tostring(EventData.Payload.ItemId), ConcernCategory = tostring(EventData.Payload.ConcernCategory)
| summarize TotalReportCount = count() by ItemId, ConcernCategory
| sort by TotalReportCount desc
| render columnchart kind=stacked

La requête suivante retourne tous les signalements soumis contre un ItemId précis au cours des 3 derniers jours

['events.all']
| where Timestamp > ago (3d)
| where FullName_Name == "item_reported"
| where EventData.Payload.ItemId == "3f5dd8d4-4ee1-4748-8855-56a8a0277bf9"
| project Timestamp, ItemId = tostring(EventData.Payload.ItemId), ConcernCategory = tostring(EventData.Payload.ConcernCategory), Reason = tostring(EventData.Payload.Reason), ReportingPlayer = Entity_Id
| sort by Timestamp

Modifier l’état de modération d’un objet

Vous pouvez modifier l’état de modération d’un objet publié à l’aide de l’API SetItemModerationState. Un objet dans un état autre que Approved ne sera pas accessible dans le catalogue public pour l’ensemble des joueurs. Le créateur de l’objet peut toujours y accéder à l’aide des API GetItem et GetDraftItems. Les entités de titre et les administrateurs pourront voir les objets non approuvés au moyen de SearchItems, GetDraftItems et GetItem. Cette API ne peut être appelée que par l’entité de titre. Un Id ou un AlernateId d’objet ainsi qu’un Status doivent être fournis. Un paramètre de texte libre Reason facultatif peut également être ajouté. Sous forme d’appel de service, cela ressemble à ceci :

{
  "Status": "AwaitingModeration",
  "Reason": "User reports over threshold",
  "Id": "3f5dd8d4-4ee1-4748-8855-56a8a0277bf9"
}

Par défaut, un objet publié n’a pas d’état de modération. La republication de l’objet brouillon ne modifiera pas l’état de modération. Les valeurs Status valides sont les suivantes :

AwaitingModeration
Approved
Rejected

La requête suivante retourne tous les objets actuellement à l’état AwaitingModeration au cours des 3 derniers jours

let TimeRange = ago(3d);
['events.all']
| where Timestamp > TimeRange
| where FullName_Name == "item_moderation_state_changed"
| project Timestamp, ItemId = tostring(EventData.Payload.ItemId)
| summarize MaxTimestamp = max(Timestamp) by ItemId
| extend TimeAndId = strcat(MaxTimestamp, "|", ItemId)
| join kind = leftouter (
    ['events.all']
    | where Timestamp > TimeRange
    | where FullName_Name == "item_moderation_state_changed"
    | project Timestamp, ItemId = tostring(EventData.Payload.ItemId), TargetStatus = tostring(EventData.Payload.TargetStatus), Reason = tostring(EventData.Payload.Reason)
    | extend TimeAndId = strcat(Timestamp, "|", ItemId)) on TimeAndId
| project Timestamp, ItemId, TargetStatus, Reason
| where TargetStatus == "AwaitingModeration"

Supprimer un objet

Un objet peut être supprimé en appelant l’API DeleteItem. Cet appel retire un objet du catalogue brouillon ainsi que l’objet correspondant du catalogue public (s’il a été publié). Un Id ou un AlernateId d’objet doit être fourni.

{
  "Id": "852a2d2b-7754-427e-9ad4-fce2b24a4cef"
}

XBOX Services

PlayFab

Signaler un objet

Modifier l’état de modération d’un objet

Supprimer un objet

​Signaler un objet

​Modifier l’état de modération d’un objet

​Supprimer un objet

Signaler un objet

Modifier l’état de modération d’un objet

Supprimer un objet