Moderatietaken definiëren en gebruiken (API-console)

Een beoordelingstaak fungeert als een soort wrapper voor de functionaliteit van inhoudsbeheer, werkstromen en beoordelingen. Deze handleiding laat zien hoe u de REST API's van de taak kunt gebruiken om taken voor inhoudsbeheer te initiëren en te controleren. Zodra u de structuur van de API's begrijpt, kunt u deze aanroepen eenvoudig naar elk MET REST compatibel platform over te brengen.

Vereisten

• Meld u aan of maak een account op de site Content Moderator beoordelingshulpprogramma.
• (Optioneel) Een aangepaste werkstroom definiëren voor gebruik met uw taak; U kunt ook de standaardwerkstroom gebruiken.

Een taak maken

Als u een moderatie job wilt maken, gaat u naar de pagina Job - Create API reference en selecteert u de knop voor uw abonnementsregio. U vindt uw regio in de eindpunt-URL op de pagina Referenties van het beoordelingshulpprogramma. Hiermee wordt de API-console gestart, waar u eenvoudig aanroepen kunt REST API uitvoeren.

PARAMETERS voor REST-aanroepen invoeren

Voer de volgende waarden in om de REST-aanroep te maken:

• teamName: de team-id die u hebt gemaakt bij het instellen van uw account voor het beoordelingshulpprogramma (te vinden in het veld Id op het scherm Referenties van uw beoordelingshulpprogramma).
• ContentType: dit kan 'Afbeelding', 'Tekst' of 'Video' zijn.
• ContentId: een aangepaste id-tekenreeks. Deze tekenreeks wordt doorgegeven aan de API en geretourneerd via de callback. Dit is handig voor het koppelen van interne id's of metagegevens aan de resultaten van een controle job.
• Werkstroomnaam: de naam van de werkstroom die u eerder hebt gemaakt (of 'standaard' voor de standaardwerkstroom).
• CallbackEndpoint:(optioneel) De URL voor het ontvangen van callback-informatie wanneer de beoordeling is voltooid.
• Ocp-Apim-Subscription-Key: uw Content Moderator sleutel. U vindt deze sleutel op Instellingen tabblad van het beoordelingshulpprogramma.

Vul de aanvraag body in

De hoofdwaarde van uw REST-aanroep bevat één veld, ContentValue. Plak de onbewerkte tekstinhoud als u tekst wilt modereren of voer een afbeeldings- of video-URL in als u een afbeelding of video wilt modereren. U kunt de volgende voorbeeldafbeeldings-URL gebruiken: https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpg

De aanvraag verzenden

Selecteer Verzenden. Als de bewerking is geslaagd, is de antwoordstatus 200 OK en wordt in het inhoudsvak Antwoord een id voor de taak weergegeven. Kopieer deze id voor gebruik in de volgende stappen.

Taakstatus op halen

Als u de status en details van een taak die wordt uitgevoerd of voltooid wilt weergeven, gaat u naar de pagina Api-referentie voor taak - API-op halen en selecteert u de knop voor uw regio (de regio waarin uw sleutel wordt beheerd).

Voer de PARAMETERS van de REST-aanroep in, zoals in de bovenstaande sectie. Voor deze stap is JobId de unieke id-tekenreeks die u hebt ontvangen bij het maken van de taak. Selecteer Verzenden. Als de bewerking is geslaagd, is de antwoordstatus en wordt in het inhoudsvak Antwoord de taak als volgt 200 OK weergegeven in JSON-indeling:

{  
  "Id":"2018014caceddebfe9446fab29056fd8d31ffe",
  "TeamName":"some team name",
  "Status":"Complete",
  "WorkflowId":"OCR",
  "Type":"Image",
  "CallBackEndpoint":"",
  "ReviewId":"201801i28fc0f7cbf424447846e509af853ea54",
  "ResultMetaData":[  
    {  
      "Key":"hasText",
      "Value":"True"
    },
    {  
      "Key":"ocrText",
      "Value":"IF WE DID \r\nALL \r\nTHE THINGS \r\nWE ARE \r\nCAPABLE \r\nOF DOING, \r\nWE WOULD \r\nLITERALLY \r\nASTOUND \r\nOURSELVE \r\n"
    }
  ],
  "JobExecutionReport":[  
    {  
      "Ts":"2018-01-07T00:38:29.3238715",
      "Msg":"Posted results to the Callbackendpoint: https://requestb.in/vxke1mvx"
    },
    {  
      "Ts":"2018-01-07T00:38:29.2928416",
      "Msg":"Job marked completed and job content has been removed"
    },
    {  
      "Ts":"2018-01-07T00:38:29.0856472",
      "Msg":"Execution Complete"
    },
    {  
      "Ts":"2018-01-07T00:38:26.7714671",
      "Msg":"Successfully got hasText response from Moderator"
    },
    {  
      "Ts":"2018-01-07T00:38:26.4181346",
      "Msg":"Getting hasText from Moderator"
    },
    {  
      "Ts":"2018-01-07T00:38:25.5122828",
      "Msg":"Starting Execution - Try 1"
    }
  ]
}

De nieuwe beoordeling(en) bekijken

Als uw inhouds job heeft geleid tot het maken van een beoordeling, kunt u deze bekijken in het beoordelingshulpprogramma. Selecteer Video over > tekst van / afbeelding / controleren (afhankelijk van de inhoud die u hebt gebruikt). De inhoud moet worden weergegeven, klaar voor menselijke beoordeling. Nadat een menselijke moderator de automatisch toegewezen tags en voorspellingsgegevens controleert en een definitieve beoordelingsbeslissing indient, worden al deze gegevens door de taak-API naar het aangewezen callback-eindpunt verzenden.

Volgende stappen

In deze handleiding hebt u geleerd hoe u inhoudsbeheertaken kunt maken en er query's op kunt uitvoeren met behulp van REST API. Integreer vervolgens taken in een end-to-end-moderatiescenario, zoals de zelfstudie E-commercebeheer.