[AutoPR azure-ai-contentsafety] [AACS][GA] 2024-09-01 Azure AI Content Safety

sdk/contentsafety/azure-ai-contentsafety/CHANGELOG.md

@@ -4,11 +4,82 @@
 
 ### Features Added
 
-### Breaking Changes
+#### `models.AddOrUpdateTextBlocklistItemsResult` was modified
 
-### Bugs Fixed
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
 
-### Other Changes
+#### `BlocklistAsyncClient` was modified
+
+* `createOrUpdateTextBlocklist(java.lang.String,models.TextBlocklist)` was added
+
+#### `models.AnalyzeTextResult` was modified
+
+* `toJson(com.azure.json.JsonWriter)` was added
+* `fromJson(com.azure.json.JsonReader)` was added
+
+#### `models.TextBlocklistMatch` was modified
+
+* `toJson(com.azure.json.JsonWriter)` was added
+* `fromJson(com.azure.json.JsonReader)` was added
+
+#### `models.AnalyzeImageOptions` was modified
+
+* `toJson(com.azure.json.JsonWriter)` was added
+* `fromJson(com.azure.json.JsonReader)` was added
+
+#### `models.TextBlocklistItem` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.RemoveTextBlocklistItemsOptions` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.TextBlocklist` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.AnalyzeTextOptions` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `implementation.JsonMergePatchHelper$TextBlocklistAccessor` was modified
+
+* `isJsonMergePatch(models.TextBlocklist)` was added
+
+#### `models.ImageCategoriesAnalysis` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.AnalyzeImageResult` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.AddOrUpdateTextBlocklistItemsOptions` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.ContentSafetyImageData` was modified
+
+* `fromJson(com.azure.json.JsonReader)` was added
+* `toJson(com.azure.json.JsonWriter)` was added
+
+#### `models.TextCategoriesAnalysis` was modified
+
+* `toJson(com.azure.json.JsonWriter)` was added
+* `fromJson(com.azure.json.JsonReader)` was added
+
+#### `BlocklistClient` was modified
+
+* `createOrUpdateTextBlocklist(java.lang.String,models.TextBlocklist)` was added
 
 ## 1.0.5 (2024-07-26)
 

sdk/contentsafety/azure-ai-contentsafety/src/main/java/com/azure/ai/contentsafety/models/AnalyzeImageOptions.java

@@ -19,7 +19,7 @@
 public final class AnalyzeImageOptions implements JsonSerializable<AnalyzeImageOptions> {
 
     /*
-     * The image needs to be analyzed.
+     * The image to be analyzed.
      */
     @Generated
     private final ContentSafetyImageData image;
@@ -49,7 +49,7 @@ public AnalyzeImageOptions(ContentSafetyImageData image) {
     }
 
     /**
-     * Get the image property: The image needs to be analyzed.
+     * Get the image property: The image to be analyzed.
      *
      * @return the image value.
      */

sdk/contentsafety/azure-ai-contentsafety/src/main/java/com/azure/ai/contentsafety/models/AnalyzeTextOptions.java

@@ -19,8 +19,8 @@
 public final class AnalyzeTextOptions implements JsonSerializable<AnalyzeTextOptions> {
 
     /*
-     * The text needs to be analyzed. We support a maximum of 10k Unicode characters (Unicode code points) in the text
-     * of one request.
+     * The text to be analyzed. We support a maximum of 10k Unicode characters (Unicode code points) in the text of one
+     * request.
      */
     @Generated
     private final String text;
@@ -63,8 +63,8 @@ public AnalyzeTextOptions(String text) {
     }
 
     /**
-     * Get the text property: The text needs to be analyzed. We support a maximum of 10k Unicode characters (Unicode
-     * code points) in the text of one request.
+     * Get the text property: The text to be analyzed. We support a maximum of 10k Unicode characters (Unicode code
+     * points) in the text of one request.
      *
      * @return the text value.
      */

sdk/contentsafety/azure-ai-contentsafety/src/main/java/com/azure/ai/contentsafety/models/ImageCategory.java

@@ -8,30 +8,30 @@
 import java.util.Collection;
 
 /**
- * Image analyze category.
+ * The harm category supported in Image content analysis.
  */
 public final class ImageCategory extends ExpandableStringEnum<ImageCategory> {
 
     /**
-     * Static value Hate for ImageCategory.
+     * The harm category for Image - Hate.
      */
     @Generated
     public static final ImageCategory HATE = fromString("Hate");
 
     /**
-     * Static value SelfHarm for ImageCategory.
+     * The harm category for Image - SelfHarm.
      */
     @Generated
     public static final ImageCategory SELF_HARM = fromString("SelfHarm");
 
     /**
-     * Static value Sexual for ImageCategory.
+     * The harm category for Image - Sexual.
      */
     @Generated
     public static final ImageCategory SEXUAL = fromString("Sexual");
 
     /**
-     * Static value Violence for ImageCategory.
+     * The harm category for Image - Violence.
      */
     @Generated
     public static final ImageCategory VIOLENCE = fromString("Violence");

sdk/contentsafety/azure-ai-contentsafety/src/main/java/com/azure/ai/contentsafety/models/TextBlocklistItem.java

@@ -30,7 +30,7 @@ public final class TextBlocklistItem implements JsonSerializable<TextBlocklistIt
     private String description;
 
     /*
-     * BlocklistItem content.
+     * BlocklistItem content. The length is counted using Unicode code point.
      */
     @Generated
     private final String text;
@@ -78,7 +78,7 @@ public TextBlocklistItem setDescription(String description) {
     }
 
     /**
-     * Get the text property: BlocklistItem content.
+     * Get the text property: BlocklistItem content. The length is counted using Unicode code point.
      *
      * @return the text value.
      */

sdk/contentsafety/azure-ai-contentsafety/src/main/java/com/azure/ai/contentsafety/models/TextCategory.java

@@ -8,30 +8,30 @@
 import java.util.Collection;
 
 /**
- * Text analyze category.
+ * The harm category supported in Text content analysis.
  */
 public final class TextCategory extends ExpandableStringEnum<TextCategory> {
 
     /**
-     * Static value Hate for TextCategory.
+     * The harm category for Text - Hate.
      */
     @Generated
     public static final TextCategory HATE = fromString("Hate");
 
     /**
-     * Static value SelfHarm for TextCategory.
+     * The harm category for Text - SelfHarm.
      */
     @Generated
     public static final TextCategory SELF_HARM = fromString("SelfHarm");
 
     /**
-     * Static value Sexual for TextCategory.
+     * The harm category for Text - Sexual.
      */
     @Generated
     public static final TextCategory SEXUAL = fromString("Sexual");
 
     /**
-     * Static value Violence for TextCategory.
+     * The harm category for Text - Violence.
      */
     @Generated
     public static final TextCategory VIOLENCE = fromString("Violence");

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/AddOrUpdateBlocklistItemsToTextBlocklist.java

@@ -0,0 +1,28 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.BlocklistClient;
+import com.azure.ai.contentsafety.BlocklistClientBuilder;
+import com.azure.ai.contentsafety.models.AddOrUpdateTextBlocklistItemsOptions;
+import com.azure.ai.contentsafety.models.AddOrUpdateTextBlocklistItemsResult;
+import com.azure.ai.contentsafety.models.TextBlocklistItem;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+import java.util.Arrays;
+
+public class AddOrUpdateBlocklistItemsToTextBlocklist {
+    public static void main(String[] args) {
+        BlocklistClient blocklistClient
+            = new BlocklistClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.addorupdateblocklistitems.addorupdateblocklistitemstotextblocklist
+        AddOrUpdateTextBlocklistItemsResult response
+            = blocklistClient.addOrUpdateBlocklistItems("TestBlocklist", new AddOrUpdateTextBlocklistItemsOptions(
+                Arrays.asList(new TextBlocklistItem("hate").setDescription("Hate word"))));
+        // END:com.azure.ai.contentsafety.generated.addorupdateblocklistitems.addorupdateblocklistitemstotextblocklist
+    }
+}

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/AnalyzeImage.java

@@ -0,0 +1,26 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.ContentSafetyClient;
+import com.azure.ai.contentsafety.ContentSafetyClientBuilder;
+import com.azure.ai.contentsafety.models.AnalyzeImageOptions;
+import com.azure.ai.contentsafety.models.AnalyzeImageResult;
+import com.azure.ai.contentsafety.models.ContentSafetyImageData;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+
+public class AnalyzeImage {
+    public static void main(String[] args) {
+        ContentSafetyClient contentSafetyClient
+            = new ContentSafetyClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.analyzeimage.analyzeimage
+        AnalyzeImageResult response = contentSafetyClient
+            .analyzeImage(new AnalyzeImageOptions(new ContentSafetyImageData().setContent("Y29udGVudDE=".getBytes())));
+        // END:com.azure.ai.contentsafety.generated.analyzeimage.analyzeimage
+    }
+}

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/AnalyzeText.java

@@ -0,0 +1,24 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.ContentSafetyClient;
+import com.azure.ai.contentsafety.ContentSafetyClientBuilder;
+import com.azure.ai.contentsafety.models.AnalyzeTextOptions;
+import com.azure.ai.contentsafety.models.AnalyzeTextResult;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+
+public class AnalyzeText {
+    public static void main(String[] args) {
+        ContentSafetyClient contentSafetyClient
+            = new ContentSafetyClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.analyzetext.analyzetext
+        AnalyzeTextResult response = contentSafetyClient.analyzeText(new AnalyzeTextOptions("This is text example"));
+        // END:com.azure.ai.contentsafety.generated.analyzetext.analyzetext
+    }
+}

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/CreateOrUpdateTextBlocklist.java

@@ -0,0 +1,23 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.BlocklistClient;
+import com.azure.ai.contentsafety.BlocklistClientBuilder;
+import com.azure.ai.contentsafety.models.TextBlocklist;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+
+public class CreateOrUpdateTextBlocklist {
+    public static void main(String[] args) {
+        BlocklistClient blocklistClient
+            = new BlocklistClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.createorupdatetextblocklist.createorupdatetextblocklist
+        TextBlocklist response = blocklistClient.createOrUpdateTextBlocklist("TestBlocklist", null);
+        // END:com.azure.ai.contentsafety.generated.createorupdatetextblocklist.createorupdatetextblocklist
+    }
+}

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/DeleteTextBlocklistByBlocklistName.java

@@ -0,0 +1,22 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.BlocklistClient;
+import com.azure.ai.contentsafety.BlocklistClientBuilder;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+
+public class DeleteTextBlocklistByBlocklistName {
+    public static void main(String[] args) {
+        BlocklistClient blocklistClient
+            = new BlocklistClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.deletetextblocklist.deletetextblocklistbyblocklistname
+        blocklistClient.deleteTextBlocklist("TestBlocklist");
+        // END:com.azure.ai.contentsafety.generated.deletetextblocklist.deletetextblocklistbyblocklistname
+    }
+}

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/GetAllBlockItemsByBlocklistName.java

@@ -0,0 +1,24 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.BlocklistClient;
+import com.azure.ai.contentsafety.BlocklistClientBuilder;
+import com.azure.ai.contentsafety.models.TextBlocklistItem;
+import com.azure.core.http.rest.PagedIterable;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+
+public class GetAllBlockItemsByBlocklistName {
+    public static void main(String[] args) {
+        BlocklistClient blocklistClient
+            = new BlocklistClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.listtextblocklistitems.getallblockitemsbyblocklistname
+        PagedIterable<TextBlocklistItem> response = blocklistClient.listTextBlocklistItems("TestBlocklist", null, null);
+        // END:com.azure.ai.contentsafety.generated.listtextblocklistitems.getallblockitemsbyblocklistname
+    }
+}

sdk/contentsafety/azure-ai-contentsafety/src/samples/java/com/azure/ai/contentsafety/generated/GetAllTextBlocklists.java

@@ -0,0 +1,24 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
+
+package com.azure.ai.contentsafety.generated;
+
+import com.azure.ai.contentsafety.BlocklistClient;
+import com.azure.ai.contentsafety.BlocklistClientBuilder;
+import com.azure.ai.contentsafety.models.TextBlocklist;
+import com.azure.core.http.rest.PagedIterable;
+import com.azure.core.util.Configuration;
+import com.azure.identity.DefaultAzureCredentialBuilder;
+
+public class GetAllTextBlocklists {
+    public static void main(String[] args) {
+        BlocklistClient blocklistClient
+            = new BlocklistClientBuilder().credential(new DefaultAzureCredentialBuilder().build())
+                .endpoint(Configuration.getGlobalConfiguration().get("ENDPOINT"))
+                .buildClient();
+        // BEGIN:com.azure.ai.contentsafety.generated.listtextblocklists.getalltextblocklists
+        PagedIterable<TextBlocklist> response = blocklistClient.listTextBlocklists();
+        // END:com.azure.ai.contentsafety.generated.listtextblocklists.getalltextblocklists
+    }
+}