Denetleme işlerini tanımlama ve kullanma (API konsolu)

Dikkat

Content Moderator gözden geçirme aracı artık kullanım dışıdır ve 12/31/2021 tarihinde kullanımdan kaldırılacaktır.

Bir denetleme işi, içerik denetleme, iş akışı ve gözden geçirme işlevleri için bir sarmalayıcı türü görevi görür. Bu kılavuzda, içerik denetleme işlerini başlatmak ve denetlemek için iş REST API 'Lerinin nasıl kullanılacağı gösterilmektedir. API 'lerin yapısını anladıktan sonra, bu çağrıları REST ile uyumlu herhangi bir platforma kolayca bağlayabilirsiniz.

Önkoşullar

Bir iş oluşturma

Bir denetleme işi oluşturmak için, iş- API başvurusu Oluştur sayfasına gidin ve abonelik bölgeniz için düğmeyi seçin. Bölgenizi İnceleme aracının kimlik bilgileri sayfasında uç nokta URL 'si içinde bulabilirsiniz. Bu, REST API çağrılarını kolayca oluşturabileceğiniz ve çalıştırabileceğiniz API konsolunu başlatır.

İş-sayfa bölgesi seçimi oluştur

REST çağrı parametrelerini girin

REST çağrısını oluşturmak için aşağıdaki değerleri girin:

  • TeamName: İnceleme aracı hesabınızı ayarlarken oluşturduğunuz takım kimliği (gözden geçirme aracınızın kimlik bilgileri ekranındaki kimlik alanında bulunur ).
  • ContentType: Bu "görüntü", "metin" veya "video" olabilir.
  • ContentID: özel bir tanımlayıcı dizesi. Bu dize, API 'ye geçirilir ve geri çağırma yoluyla döndürülür. Bir denetleme işinin sonuçlarıyla iç tanımlayıcıları veya meta verileri ilişkilendirmek için faydalıdır.
  • Workflowname: daha önce oluşturduğunuz iş akışının adı (veya varsayılan iş akışı için "varsayılan").
  • Callbackendpoint: (isteğe bağlı) Gözden geçirme tamamlandığında geri çağırma BILGILERINI alacak URL.
  • OCP-apim-Subscription-Key: Content moderator anahtarınız. bu anahtarı inceleme aracının Ayarlar sekmesinde bulabilirsiniz.

İstek gövdesini doldur

REST çağrınızın gövdesi bir alan, Contentvalue içeriyor. Metni moderorsanız ham metin içeriğine yapıştırın veya bir görüntü veya video oluşturuyorsanız bir görüntü veya video URL 'SI girin. Aşağıdaki örnek görüntü URL 'sini kullanabilirsiniz: https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpg

İş-konsol sorgu parametrelerini, üstbilgilerini ve Istek gövdesi kutusunu oluşturma

İsteğinizi gönderin

Gönder’i seçin. İşlem başarılı olursa, yanıt durumu olur 200 OK ve yanıt içeriği kutusunda iş için bir kimlik görüntülenir. Aşağıdaki adımlarda kullanmak için bu KIMLIĞI kopyalayın.

İnceleme-konsol yanıt içeriği oluştur kutusu İnceleme KIMLIĞINI görüntüler

İş durumunu al

Çalışan veya tamamlanmış bir işin durumunu ve ayrıntılarını almak için, iş- API başvurusunu Al sayfasına gidin ve bölgenizin (anahtarınızın yönettiği bölge) düğmesini seçin.

İş-bölge seçimini al

REST çağrı parametrelerini yukarıdaki bölümde olduğu gibi girin. Bu adım için iş kimliği, işi oluştururken aldığınız benzersiz kimlik dizesidir. Gönder’i seçin. İşlem başarılı olursa, yanıt durumu olur 200 OK ve yanıt içeriği kutusu, işi aşağıdaki gibi JSON biçiminde görüntüler:

{  
  "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"
    }
  ]
}

İş-REST çağrısı yanıtını al

Yeni Gözden geçirme (ler) i inceleyin

İçerik işiniz bir gözden geçirme oluşturma işlemi ile sonuçlanmasıyla, Gözden geçirme aracındagörüntüleyebilirsiniz. > Görüntü / metni / videosunu gözden geçir ' i seçin (kullandığınız içeriğe bağlı olarak). İçerik, insan gözden geçirmesi için hazırlanmalıdır. İnsan aracı otomatik olarak atanan etiketleri ve tahmin verilerini gözden geçirdikten ve son bir denetleme kararı gönderdikten sonra, işler API 'SI tüm bu bilgileri belirtilen geri çağırma uç noktasına gönderir.

Sonraki adımlar

Bu kılavuzda, REST API kullanarak içerik denetleme işleri oluşturmayı ve sorgulamayı öğrendiniz. Ardından, işleri E-ticaret denetleme öğreticisi gibi uçtan uca bir denetleme senaryosuna tümleştirin.